Movatterモバイル変換

Namespaces
namespace	detail

Classes
class	basic_file_status
	Represents the result of a call to directory_iterator::status().More...

class	directory_entry
	directory_entry - A single entry in a directory.More...

class	directory_iterator
	directory_iterator - Iterates through the entries in path.More...

class	file_status
	Represents the result of a call tosys::fs::status().More...

class	FileLocker
	RAII class that facilitates file locking.More...

class	mapped_file_region
	This class represents a memory mapped file.More...

class	recursive_directory_iterator
	recursive_directory_iterator - Same asdirectory_iterator except for it recurses down into child directories.More...

struct	space_info
	space_info - Self explanatory.More...

class	TempFile
	Represents a temporary file.More...

class	UniqueID

Typedefs
using	file_t = int

Enumerations
enum class	file_type { status_error,file_not_found,regular_file,directory_file, symlink_file,block_file,character_file,fifo_file, socket_file,type_unknown }
	An enumeration for the file system's view of the type.More...

enum	perms { no_perms = 0,owner_read = 0400,owner_write = 0200,owner_exe = 0100, owner_all = owner_read \| owner_write \| owner_exe,group_read = 040,group_write = 020,group_exe = 010, group_all = group_read \| group_write \| group_exe,others_read = 04,others_write = 02,others_exe = 01, others_all = others_read \| others_write \| others_exe,all_read = owner_read \| group_read \| others_read,all_write = owner_write \| group_write \| others_write,all_exe = owner_exe \| group_exe \| others_exe, all_all = owner_all \| group_all \| others_all,set_uid_on_exe = 04000,set_gid_on_exe = 02000,sticky_bit = 01000, all_perms = all_all \| set_uid_on_exe \| set_gid_on_exe \| sticky_bit,perms_not_known = 0xFFFF }

Functions
perms	operator\| (perms l,perms r)

perms	operator& (perms l,perms r)

perms &	operator\|= (perms &l,perms r)

perms &	operator&= (perms &l,perms r)

perms	operator~ (perms x)

static std::error_code	createTemporaryFile (const Twine &Model, int &ResultFD,llvm::SmallVectorImpl<char > &ResultPath,FSEntity Type,sys::fs::OpenFlags Flags=sys::fs::OF_None)

static std::error_code	createTemporaryFile (const Twine &Prefix,StringRef Suffix, int &ResultFD,llvm::SmallVectorImpl<char > &ResultPath,FSEntity Type,sys::fs::OpenFlags Flags=sys::fs::OF_None)

static std::error_code	copy_file_internal (int ReadFD, int WriteFD)

Physical Operators
void	make_absolute (const Twine &current_directory,SmallVectorImpl<char > &path)
	Makepath an absolute path.

std::error_code	make_absolute (SmallVectorImpl<char > &path)
	Makepath an absolute path.

std::error_code	create_directories (const Twine &path,bool IgnoreExisting=true,perms Perms=owner_all\|group_all)
	Create all the non-existent directories in path.

std::error_code	create_directory (const Twine &path,bool IgnoreExisting=true,perms Perms=owner_all\|group_all)
	Create the directory in path.

std::error_code	create_link (const Twine &to,const Twine &from)
	Create a link fromfrom toto.

std::error_code	create_hard_link (const Twine &to,const Twine &from)
	Create a hard link fromfrom toto, or return an error.

std::error_code	real_path (const Twine &path,SmallVectorImpl<char > &output,bool expand_tilde=false)
	Collapse all .

void	expand_tilde (const Twine &path,SmallVectorImpl<char > &output)
	Expands ~ expressions to the user's home directory.

std::error_code	current_path (SmallVectorImpl<char > &result)
	Get the current path.

std::error_code	set_current_path (const Twine &path)
	Set the current path.

std::error_code	remove (const Twine &path,bool IgnoreNonExisting=true)
	Remove path.

std::error_code	remove_directories (const Twine &path,bool IgnoreErrors=true)
	Recursively delete a directory.

std::error_code	rename (const Twine &from,const Twine &to)
	Renamefrom toto.

std::error_code	copy_file (const Twine &From,const Twine &To)
	Copy the contents ofFrom toTo.

std::error_code	copy_file (const Twine &From, int ToFD)
	Copy the contents ofFrom toTo.

std::error_code	resize_file (int FD,uint64_t Size)
	Resize path to size.

std::error_code	resize_file_before_mapping_readwrite (int FD,uint64_t Size)
	Resize`FD` to`Size` before mappingmapped_file_region::readwrite.

ErrorOr<MD5::MD5Result >	md5_contents (int FD)
	Compute anMD5 hash of a file's contents.

ErrorOr<MD5::MD5Result >	md5_contents (const Twine &Path)
	Version of compute_md5 that doesn't require an open file descriptor.

Variables
const file_t	kInvalidFile

Physical Observers
enum class	AccessMode {Exist,Write,Execute }

enum	CreationDisposition : unsigned {CD_CreateAlways = 0,CD_CreateNew = 1,CD_OpenExisting = 2,CD_OpenAlways = 3 }

enum	FileAccess : unsigned {FA_Read = 1,FA_Write = 2 }

enum	OpenFlags : unsigned { OF_None = 0,OF_Text = 1,OF_CRLF = 2,OF_TextWithCRLF = OF_Text \| OF_CRLF, OF_Append = 4,OF_Delete = 8,OF_ChildInherit = 16,OF_UpdateAtime = 32 }

enum	: size_t {DefaultReadChunkSize = 4 * 4096 }
	Default chunk size forreadNativeFileToEOF().More...

bool	exists (const basic_file_status &status)
	Does file exist?

std::error_code	access (const Twine &Path,AccessMode Mode)
	Can the file be accessed?

bool	exists (const Twine &Path)
	Does file exist?

bool	can_execute (const Twine &Path)
	Can we execute this file?

bool	can_write (const Twine &Path)
	Can we write this file?

bool	equivalent (file_status A,file_status B)
	Dofile_status's represent the same thing?

std::error_code	equivalent (const Twine &A,const Twine &B,bool &result)
	Do paths represent the same thing?

bool	equivalent (const Twine &A,const Twine &B)
	Simpler version of equivalent for clients that don't need to differentiate between an error and false.

std::error_code	is_local (const Twine &path,bool &result)
	Is the file mounted on a local filesystem?

std::error_code	is_local (int FD,bool &result)
	Version of is_local accepting an open file descriptor.

bool	is_local (const Twine &Path)
	Simpler version of is_local for clients that don't need to differentiate between an error and false.

bool	is_local (int FD)
	Simpler version of is_local accepting an open file descriptor for clients that don't need to differentiate between an error and false.

file_type	get_file_type (const Twine &Path,bool Follow=true)
	Does status represent a directory?

bool	is_directory (const basic_file_status &status)
	Does status represent a directory?

std::error_code	is_directory (const Twine &path,bool &result)
	Is path a directory?

bool	is_directory (const Twine &Path)
	Simpler version of is_directory for clients that don't need to differentiate between an error and false.

bool	is_regular_file (const basic_file_status &status)
	Does status represent a regular file?

std::error_code	is_regular_file (const Twine &path,bool &result)
	Is path a regular file?

bool	is_regular_file (const Twine &Path)
	Simpler version of is_regular_file for clients that don't need to differentiate between an error and false.

bool	is_symlink_file (const basic_file_status &status)
	Does status represent a symlink file?

std::error_code	is_symlink_file (const Twine &path,bool &result)
	Is path a symlink file?

bool	is_symlink_file (const Twine &Path)
	Simpler version of is_symlink_file for clients that don't need to differentiate between an error and false.

bool	is_other (const basic_file_status &status)
	Does this status represent something that exists but is not a directory or regular file?

std::error_code	is_other (const Twine &path,bool &result)
	Is path something that exists but is not a directory, regular file, or symlink?

std::error_code	status (const Twine &path,file_status &result,bool follow=true)
	Get file status as if by POSIX stat().

std::error_code	status (int FD,file_status &Result)
	A version for when a file descriptor is already available.

unsigned	getUmask ()
	Get file creation mode mask of the process.

std::error_code	setPermissions (const Twine &Path,perms Permissions)
	Set file permissions.

std::error_code	setPermissions (int FD,perms Permissions)
	Vesion of setPermissions accepting a file descriptor.

ErrorOr<perms >	getPermissions (const Twine &Path)
	Get file permissions.

std::error_code	file_size (const Twine &Path,uint64_t &Result)
	Get file size.

std::error_code	setLastAccessAndModificationTime (int FD,TimePoint<> AccessTime,TimePoint<> ModificationTime)
	Set the file modification and access time.

std::error_code	setLastAccessAndModificationTime (int FD,TimePoint<> Time)
	Simpler version that sets both file modification and access time to the same time.

bool	status_known (const basic_file_status &s)
	Is status available?

std::error_code	status_known (const Twine &path,bool &result)
	Is status available?

void	createUniquePath (const Twine &Model,SmallVectorImpl<char > &ResultPath,bool MakeAbsolute)
	Create a potentially unique file name but does not create it.

std::error_code	createUniqueFile (const Twine &Model, int &ResultFD,SmallVectorImpl<char > &ResultPath,OpenFlags Flags=OF_None,unsigned Mode=all_read\|all_write)
	Create a uniquely named file.

std::error_code	createUniqueFile (const Twine &Model,SmallVectorImpl<char > &ResultPath,unsigned Mode=all_read\|all_write)
	Simpler version for clients that don't want an open file.

std::error_code	createTemporaryFile (const Twine &Prefix,StringRef Suffix, int &ResultFD,SmallVectorImpl<char > &ResultPath,OpenFlags Flags=OF_None)
	Create a file in the system temporary directory.

std::error_code	createTemporaryFile (const Twine &Prefix,StringRef Suffix,SmallVectorImpl<char > &ResultPath,OpenFlags Flags=OF_None)
	Simpler version for clients that don't want an open file.

std::error_code	createUniqueDirectory (const Twine &Prefix,SmallVectorImpl<char > &ResultPath)

std::error_code	getPotentiallyUniqueFileName (const Twine &Model,SmallVectorImpl<char > &ResultPath)
	Get a unique name, not currently exisiting in the filesystem.

std::error_code	getPotentiallyUniqueTempFileName (const Twine &Prefix,StringRef Suffix,SmallVectorImpl<char > &ResultPath)
	Get a unique temporary file name, not currently exisiting in the filesystem.

OpenFlags	operator\| (OpenFlags A,OpenFlags B)

OpenFlags &	operator\|= (OpenFlags &A,OpenFlags B)

FileAccess	operator\| (FileAccess A,FileAccess B)

FileAccess &	operator\|= (FileAccess &A,FileAccess B)

std::error_code	openFile (const Twine &Name, int &ResultFD,CreationDisposition Disp,FileAccess Access,OpenFlags Flags,unsigned Mode=0666)
	Opens a file with the specified creation disposition, access mode, and flags and returns a file descriptor.

Expected<file_t >	openNativeFile (const Twine &Name,CreationDisposition Disp,FileAccess Access,OpenFlags Flags,unsigned Mode=0666)
	Opens a file with the specified creation disposition, access mode, and flags and returns a platform-specific file object.

file_t	convertFDToNativeFile (int FD)
	Converts from a Posix file descriptor number to a native file handle.

file_t	getStdinHandle ()
	Return an open handle to standard in.

file_t	getStdoutHandle ()
	Return an open handle to standard out.

file_t	getStderrHandle ()
	Return an open handle to standard error.

Expected< size_t >	readNativeFile (file_t FileHandle,MutableArrayRef<char > Buf)
	Reads`Buf.size()` bytes from`FileHandle` into`Buf`.

Error	readNativeFileToEOF (file_t FileHandle,SmallVectorImpl<char > &Buffer, ssize_t ChunkSize=DefaultReadChunkSize)
	Reads from`FileHandle` until EOF, appending to`Buffer` in chunks of size`ChunkSize`.

Expected< size_t >	readNativeFileSlice (file_t FileHandle,MutableArrayRef<char > Buf,uint64_t Offset)
	Reads`Buf.size()` bytes from`FileHandle` at offset`Offset` into`Buf`.

std::error_code	openFileForWrite (const Twine &Name, int &ResultFD,CreationDisposition Disp=CD_CreateAlways,OpenFlags Flags=OF_None,unsigned Mode=0666)
	Opens the file with the given name in a write-only or read-write mode, returning its open file descriptor.

Expected<file_t >	openNativeFileForWrite (const Twine &Name,CreationDisposition Disp,OpenFlags Flags,unsigned Mode=0666)
	Opens the file with the given name in a write-only or read-write mode, returning its open file descriptor.

std::error_code	openFileForReadWrite (const Twine &Name, int &ResultFD,CreationDisposition Disp,OpenFlags Flags,unsigned Mode=0666)
	Opens the file with the given name in a write-only or read-write mode, returning its open file descriptor.

Expected<file_t >	openNativeFileForReadWrite (const Twine &Name,CreationDisposition Disp,OpenFlags Flags,unsigned Mode=0666)
	Opens the file with the given name in a write-only or read-write mode, returning its open file descriptor.

std::error_code	openFileForRead (const Twine &Name, int &ResultFD,OpenFlags Flags=OF_None,SmallVectorImpl<char > *RealPath=nullptr)
	Opens the file with the given name in a read-only mode, returning its open file descriptor.

Expected<file_t >	openNativeFileForRead (const Twine &Name,OpenFlags Flags=OF_None,SmallVectorImpl<char > *RealPath=nullptr)
	Opens the file with the given name in a read-only mode, returning its open file descriptor.

std::error_code	tryLockFile (int FD, std::chrono::milliseconds Timeout=std::chrono::milliseconds(0))
	Try to locks the file during the specified time.

std::error_code	lockFile (int FD)
	Lock the file.

std::error_code	unlockFile (int FD)
	Unlock the file.

std::error_code	closeFile (file_t &F)
	Close the file object.

std::error_code	changeFileOwnership (int FD,uint32_t Owner,uint32_t Group)
	Change ownership of a file.

std::error_code	getUniqueID (const Twine Path,UniqueID &Result)

ErrorOr<space_info >	disk_space (const Twine &Path)
	Get disk space usage information.

std::string	getMainExecutable (const char argv0, void MainExecAddr)
	Return the path to the main executable, given the value of argv[0] from program startup and the address of main itself.

Typedef Documentation

◆ file_t

typedef intllvm::sys::fs::file_t

Definition at line55 of fileFileSystem.h.

Enumeration Type Documentation

◆ anonymous enum

anonymous enum : size_t

Default chunk size forreadNativeFileToEOF().

Enumerator
DefaultReadChunkSize

Definition at line1011 of fileFileSystem.h.

◆ AccessMode

enum classllvm::sys::fs::AccessMode

strong

Enumerator
Exist
Write
Execute

Definition at line443 of fileFileSystem.h.

◆ CreationDisposition

enumllvm::sys::fs::CreationDisposition :unsigned

Enumerator
CD_CreateAlways	CD_CreateAlways - When opening a file: If it already exists, truncate it. If it does not already exist, create a new file.
CD_CreateNew	CD_CreateNew - When opening a file: If it already exists, fail. If it does not already exist, create a new file.
CD_OpenExisting	CD_OpenExisting - When opening a file: If it already exists, open the file with the offset set to 0. If it does not already exist, fail.
CD_OpenAlways	CD_OpenAlways - When opening a file: If it already exists, open the file with the offset set to 0. If it does not already exist, create a new file.

Definition at line722 of fileFileSystem.h.

◆ file_type

enum classllvm::sys::fs::file_type

strong

An enumeration for the file system's view of the type.

Enumerator
status_error
file_not_found
regular_file
directory_file
symlink_file
block_file
character_file
fifo_file
socket_file
type_unknown

Definition at line61 of fileFileSystem.h.

◆ FileAccess

enumllvm::sys::fs::FileAccess :unsigned

Enumerator
FA_Read
FA_Write

Definition at line744 of fileFileSystem.h.

◆ OpenFlags

enumllvm::sys::fs::OpenFlags :unsigned

Enumerator
OF_None
OF_Text	The file should be opened in text mode on platforms like z/OS that make this distinction.
OF_CRLF	The file should use a carriage linefeed '\r '. This flag should only be used with OF_Text. Only makes a difference on Windows.
OF_TextWithCRLF	The file should be opened in text mode and use a carriage linefeed '\r '. This flag has the same functionality as OF_Text on z/OS but adds a carriage linefeed on Windows.
OF_Append	The file should be opened in append mode.
OF_Delete	The returned handle can be used for deleting the file. Only makes a difference on windows.
OF_ChildInherit	When a child process is launched, this file should remain open in the child process.
OF_UpdateAtime	Force files Atime to be updated on access. Only makes a difference on Windows.

Definition at line749 of fileFileSystem.h.

◆ perms

enumllvm::sys::fs::perms

Enumerator
no_perms
owner_read
owner_write
owner_exe
owner_all
group_read
group_write
group_exe
group_all
others_read
others_write
others_exe
others_all
all_read
all_write
all_exe
all_all
set_uid_on_exe
set_gid_on_exe
sticky_bit
all_perms
perms_not_known

Definition at line81 of fileFileSystem.h.

Function Documentation

◆ access()

std::error_code llvm::sys::fs::access	(	const Twine &	Path,
		AccessMode	Mode
	)

Can the file be accessed?

Parameters

Path	Input path.

Returns: errc::success if the path can be accessed, otherwise a platform-specific error_code.

Referenced bycan_write(),createUniqueEntity(),exists(), andllvm::LockFileManager::waitForUnlock().

◆ can_execute()

bool llvm::sys::fs::can_execute

(

const Twine &

Path

)

Can we execute this file?

Parameters

Path	Input path.

Returns: True if we can execute it, false otherwise.

Referenced byllvm::object::writeUniversalBinary().

◆ can_write()

bool llvm::sys::fs::can_write

(

const Twine &

Path

)

inline

Can we write this file?

Parameters

Path	Input path.

Returns: True if we can write to it, false otherwise.

Definition at line470 of fileFileSystem.h.

Referencesaccess(), andWrite.

◆ changeFileOwnership()

std::error_code llvm::sys::fs::changeFileOwnership	(	int	FD,
		uint32_t	Owner,
		uint32_t	Group
	)

Change ownership of a file.

Parameters

Owner	The owner of the file to change to.
Group	The group of the file to change to.

Returns: errc::success if successfully updated file ownership, otherwise an error code is returned.

Referenced byllvm::FilePermissionsApplier::apply().

◆ closeFile()

std::error_code llvm::sys::fs::closeFile

(

file_t &

)

Close the file object.

This should be used instead of ::close for portability. On error, the caller should assume the file is closed, as is the case forProcess::SafelyCloseFileDescriptor

Parameters

F	On input, this is the file to close. On output, the file is set to kInvalidFile.

Returns: An error code if closing the file failed. Typically, an error here means that the filesystem may have failed to perform some buffered writes.

Referenced byllvm::NewArchiveMember::getFile(),llvm::MemoryBuffer::getFileAsStream(),getFileAux(),llvm::orc::loadLinkableFile(),llvm::orc::loadMachORelocatableObject(),llvm::xray::loadProfile(),llvm::xray::loadTraceFile(),loadYAML(),llvm::localCache(),llvm::streamFile(), andllvm::InteractiveModelRunner::~InteractiveModelRunner().

◆ convertFDToNativeFile()

file_t llvm::sys::fs::convertFDToNativeFile

(

int

)

inline

Converts from a Posix file descriptor number to a native file handle.

On Windows, this retreives the underlying handle. On non-Windows, this is a no-op.

Definition at line986 of fileFileSystem.h.

Referenced byllvm::LTOModule::createFromOpenFileSlice(),createOnDiskBuffer(),llvm::localCache(), andllvm::InteractiveModelRunner::~InteractiveModelRunner().

◆ copy_file()[1/2]

std::error_code llvm::sys::fs::copy_file	(	const Twine &	From,
		const Twine &	To
	)

Copy the contents ofFrom toTo.

Parameters

From	The path to copy from.
To	The path to copy to. This is created.

Definition at line1016 of filePath.cpp.

ReferencesCD_CreateAlways,copy_file_internal(),From,OF_None,openFileForRead(), andopenFileForWrite().

Referenced byllvm::FileCollector::copyFiles(),llvm::sys::fs::TempFile::keep(), andllvm::ThinLTOCodeGenerator::writeGeneratedObject().

◆ copy_file()[2/2]

std::error_code llvm::sys::fs::copy_file	(	const Twine &	From,
		int	ToFD
	)

Copy the contents ofFrom toTo.

Parameters

From	The path to copy from.
ToFD	The open file descriptor of the destination file.

Definition at line1035 of filePath.cpp.

Referencescopy_file_internal(),From,OF_None, andopenFileForRead().

◆ copy_file_internal()

static std::error_code llvm::sys::fs::copy_file_internal	(	int	ReadFD,
		int	WriteFD
	)

static

Definition at line991 of filePath.cpp.

Referencesllvm::errnoAsErrorCode(),llvm::support::endian::read(), andllvm::write().

Referenced bycopy_file().

◆ create_directories()

std::error_code llvm::sys::fs::create_directories	(	const Twine &	path,
		bool	IgnoreExisting =`true`,
		perms	Perms =`owner_all \| group_all`
	)

Create all the non-existent directories in path.

Parameters

path	Directories to create.

Returns: errc::success if is_directory(path), otherwise a platform specific error_code. If IgnoreExisting is false, also returns error if the directory already existed.

Definition at line967 of filePath.cpp.

Referencescreate_directories(),create_directory(),llvm::StringRef::empty(),llvm::no_such_file_or_directory,P, andllvm::sys::path::parent_path().

Referenced bycodegen(),llvm::FileCollector::copyFiles(),create_directories(),llvm::logicalview::LVSplitContext::createSplitFolder(),llvm::lto::getThinLTOOutputFile(),llvm::localCache(),prepareDumpIRFileDescriptor(), andllvm::ThinLTOCodeGenerator::run().

◆ create_directory()

std::error_code llvm::sys::fs::create_directory	(	const Twine &	path,
		bool	IgnoreExisting =`true`,
		perms	Perms =`owner_all\|group_all`
	)

Create the directory in path.

Parameters

path	Directory to create.

Returns: errc::success if is_directory(path), otherwise a platform specific error_code. If IgnoreExisting is false, also returns error if the directory already existed.

Referenced bycreate_directories(),createUniqueEntity(), andllvm::unittest::TempDir::TempDir().

◆ create_hard_link()

std::error_code llvm::sys::fs::create_hard_link	(	const Twine &	to,
		const Twine &	from
	)

Create a hard link fromfrom toto, or return an error.

Parameters

to	The path to hard link to.
from	The path to hard link from. This is created.

Returns: errc::success if the link was created, otherwise a platform specific error_code.

Referenced byllvm::ThinLTOCodeGenerator::writeGeneratedObject().

◆ create_link()

std::error_code llvm::sys::fs::create_link	(	const Twine &	to,
		const Twine &	from
	)

Create a link fromfrom toto.

The link may be a soft or a hard link, depending on the platform. The caller may not assume which one. Currently on windows it creates a hard link since soft links require extra privileges. On unix, it creates a soft link since hard links don't work on SMB file systems.

Parameters

to	The path to hard link to.
from	The path to hard link from. This is created.

Returns: errc::success if the link was created, otherwise a platform specific error_code.

Referenced byllvm::LockFileManager::LockFileManager(), andllvm::unittest::TempLink::TempLink().

◆ createTemporaryFile()[1/4]

static std::error_code llvm::sys::fs::createTemporaryFile	(	const Twine &	Model,
		int &	ResultFD,
		llvm::SmallVectorImpl<char > &	ResultPath,
		FSEntity	Type,
		sys::fs::OpenFlags	Flags =`sys::fs::OF_None`
	)

static

Definition at line842 of filePath.cpp.

Referencesall_read,all_write,assert(),createUniqueEntity(),llvm::StringRef::npos, andP.

◆ createTemporaryFile()[2/4]

static std::error_code llvm::sys::fs::createTemporaryFile	(	const Twine &	Prefix,
		StringRef	Suffix,
		int &	ResultFD,
		llvm::SmallVectorImpl<char > &	ResultPath,
		FSEntity	Type,
		sys::fs::OpenFlags	Flags =`sys::fs::OF_None`
	)

static

Definition at line855 of filePath.cpp.

ReferencescreateTemporaryFile(), andllvm::StringRef::empty().

◆ createTemporaryFile()[3/4]

std::error_code llvm::sys::fs::createTemporaryFile	(	const Twine &	Prefix,
		StringRef	Suffix,
		int &	ResultFD,
		SmallVectorImpl<char > &	ResultPath,
		OpenFlags	Flags =`OF_None`
	)

Create a file in the system temporary directory.

The filename is of the form prefix-random_chars.suffix. Since the directory is not know to the caller, Prefix and Suffix cannot have path separators. The files are created with mode 0600.

This should be used for things like a temporary .s that is removed after running the assembler.

Definition at line863 of filePath.cpp.

ReferencescreateTemporaryFile(), andFS_File.

Referenced byllvm::createGraphFilename(),createTemporaryFile(),getPotentiallyUniqueTempFileName(),llvm::prepareTempFiles(),printSymbolizedStackTrace(), andllvm::unittest::TempFile::TempFile().

◆ createTemporaryFile()[4/4]

std::error_code llvm::sys::fs::createTemporaryFile	(	const Twine &	Prefix,
		StringRef	Suffix,
		SmallVectorImpl<char > &	ResultPath,
		OpenFlags	Flags =`OF_None`
	)

Simpler version for clients that don't want an open file.

An empty file will still be created.

Definition at line871 of filePath.cpp.

ReferencescreateTemporaryFile().

◆ createUniqueDirectory()

std::error_code llvm::sys::fs::createUniqueDirectory	(	const Twine &	Prefix,
		SmallVectorImpl<char > &	ResultPath
	)

Definition at line885 of filePath.cpp.

ReferencescreateUniqueEntity(), andFS_Dir.

Referenced byllvm::unittest::TempDir::TempDir().

◆ createUniqueFile()[1/2]

std::error_code llvm::sys::fs::createUniqueFile	(	const Twine &	Model,
		int &	ResultFD,
		SmallVectorImpl<char > &	ResultPath,
		OpenFlags	Flags =`OF_None`,
		unsigned	Mode =`all_read \| all_write`
	)

Create a uniquely named file.

Generates a unique path suitable for a temporary file and then opens it as a file. The name is based onModel with '' replaced by a random char in [0-9a-f]. IfModel is not an absolute path, the temporary file will be created in the current directory.

Example: clang-%%-%%-%%-%%-%%.s => clang-a0-b1-c2-d3-e4.s

This is an atomic operation. Either the file is created and opened, or the file system is left untouched.

The intended use is for files that are to be kept, possibly after renaming them. For example, when running 'clang -c foo.o', the file can be first created as foo-abc123.o and then renamed.

Parameters

Model	Name to base unique path off of.
ResultFD	Set to the opened file's file descriptor.
ResultPath	Set to the opened file's absolute path.
Flags	Set to the opened file's flags.
Mode	Set to the opened file's permissions.

Returns: errc::success if Result{FD,Path} have been successfully set, otherwise a platform-specific error_code.

Definition at line822 of filePath.cpp.

ReferencescreateUniqueEntity(), andFS_File.

Referenced byllvm::sys::fs::TempFile::create(),createUniqueFile(), andllvm::LockFileManager::LockFileManager().

◆ createUniqueFile()[2/2]

std::error_code llvm::sys::fs::createUniqueFile	(	const Twine &	Model,
		SmallVectorImpl<char > &	ResultPath,
		unsigned	Mode =`all_read \| all_write`
	)

Simpler version for clients that don't want an open file.

An empty file will still be created.

Definition at line829 of filePath.cpp.

ReferencescreateUniqueFile(), andOF_None.

◆ createUniquePath()

void llvm::sys::fs::createUniquePath	(	const Twine &	Model,
		SmallVectorImpl<char > &	ResultPath,
		bool	MakeAbsolute
	)

Create a potentially unique file name but does not create it.

Generates a unique path suitable for a temporary file but does not open or create the file. The name is based onModel with '' replaced by a random char in [0-9a-f]. IfMakeAbsolute is true then the system's temp directory is prepended first. IfMakeAbsolute is false the current directory will be used instead.

This function does not check if the file exists. If you want to be sure that the file does not yet exist, you should use enough '' characters in your model to ensure this. Each '' gives 4-bits of entropy so you can use 32 of them to get 128 bits of entropy.

Example: clang-%%-%%-%%-%%-%%.s => clang-a0-b1-c2-d3-e4.s

Parameters

Model	Name to base unique path off of.
ResultPath	Set to the file's path.
MakeAbsolute	Whether to use the system temp directory.

Definition at line796 of filePath.cpp.

Referencesllvm::sys::path::append(),llvm::sys::Process::GetRandomNumber(),llvm::sys::path::is_absolute(),llvm::SmallVectorTemplateBase< T, bool >::pop_back(),llvm::SmallVectorTemplateBase< T, bool >::push_back(),llvm::SmallVectorBase< Size_T >::size(),llvm::SmallVectorImpl< T >::swap(), andllvm::sys::path::system_temp_directory().

Referenced bycreateUniqueEntity(), andllvm::DotCfgChangeReporter::handleFunctionCompare().

◆ current_path()

std::error_code llvm::sys::fs::current_path

(

SmallVectorImpl<char > &

result

)

Get the current path.

Parameters

result

Holds the current path on return.

Returns: errc::success if the current path has been stored in result, otherwise a platform-specific error_code.

Referenced bymake_absolute().

◆ disk_space()

ErrorOr<space_info > llvm::sys::fs::disk_space

(

const Twine &

Path

)

Get disk space usage information.

Note: Users must be careful about "Time Of Check, Time Of Use" kind of bug. Note: Windows reports results according to the quota allocated to the user.

Parameters

Path	Input path.

Returns: aspace_info structure filled with the capacity, free, and available space on the devicePath is on. A platform specific error_code is returned on error.

Referenced byllvm::pruneCache().

◆ equivalent()[1/3]

bool llvm::sys::fs::equivalent	(	const Twine &	A,
		const Twine &	B
	)

inline

Simpler version of equivalent for clients that don't need to differentiate between an error and false.

Definition at line499 of fileFileSystem.h.

ReferencesA,B, andequivalent().

◆ equivalent()[2/3]

std::error_code llvm::sys::fs::equivalent	(	const Twine &	A,
		const Twine &	B,
		bool &	result
	)

Do paths represent the same thing?

assert(status_known(A) || status_known(B));

Parameters

A	Input path A.
B	Input path B.
result	Set to true if stat(A) and stat(B) have the same device and inode (or equivalent).

Returns: errc::success if result has been successfully set, otherwise a platform-specific error_code.

◆ equivalent()[3/3]

bool llvm::sys::fs::equivalent	(	file_status	A,
		file_status	B
	)

Dofile_status's represent the same thing?

Parameters

A	Inputfile_status.
B	Inputfile_status.

assert(status_known(A) || status_known(B));

Returns: True if A and B both represent the same file system entity, false otherwise.

Referenced byequivalent(),llvm::sys::Process::FindInEnvPath(), andllvm::MachO::shouldSkipSymLink().

◆ exists()[1/2]

bool llvm::sys::fs::exists

(

const basic_file_status &

status

)

Does file exist?

Parameters

status

Abasic_file_status previously returned from stat.

Returns: True if the file represented by status exists, false if it does not.

Definition at line1077 of filePath.cpp.

Referencesfile_not_found,status(), andstatus_known().

Referenced byllvm::ListeningSocket::createUnix(),llvm::object::BuildIDFetcher::fetch(),llvm::sys::Process::FindInEnvPath(),findInputFile(),getFilename(),is_other(),llvm::LockFileManager::LockFileManager(),llvm::pdb::InputFile::open(),llvm::orc::DumpObjects::operator()(),printMarkupStackTrace(),printSymbolizedStackTrace(),searchForObj(),llvm::LockFileManager::waitForUnlock(), andllvm::ThinLTOCodeGenerator::writeGeneratedObject().

◆ exists()[2/2]

bool llvm::sys::fs::exists

(

const Twine &

Path

)

inline

Does file exist?

Parameters

Path	Input path.

Returns: True if it exists, false otherwise.

Definition at line456 of fileFileSystem.h.

Referencesaccess(), andExist.

◆ expand_tilde()

void llvm::sys::fs::expand_tilde	(	const Twine &	path,
		SmallVectorImpl<char > &	output
	)

Expands ~ expressions to the user's home directory.

On Unix ~user directories are resolved as well.

Parameters

path	The path to resolve.

Referenced byllvm::DotCfgChangeReporter::registerCallbacks().

◆ file_size()

std::error_code llvm::sys::fs::file_size	(	const Twine &	Path,
		uint64_t &	Result
	)

inline

Get file size.

Parameters

Path	Input path.
Result	Set to the size of the file inPath.

Returns: errc::success if result has been successfully set, otherwise a platform-specific error_code.

Definition at line684 of fileFileSystem.h.

Referencesstatus().

Referenced byllvm::xray::loadInstrumentationMap(),llvm::xray::loadProfile(), andllvm::xray::loadTraceFile().

◆ get_file_type()

file_type llvm::sys::fs::get_file_type	(	const Twine &	Path,
		bool	Follow =`true`
	)

Does status represent a directory?

Parameters

Path	The path to get the type of.
Follow	For symbolic links, indicates whether to return the file type of the link itself, or of the target.

Returns: A value from the file_type enumeration indicating the type of file.

Definition at line1085 of filePath.cpp.

Referencesstatus(),status_error, andllvm::sys::fs::basic_file_status::type().

◆ getMainExecutable()

std::string llvm::sys::fs::getMainExecutable	(	const char *	argv0,
		void *	MainExecAddr
	)

Return the path to the main executable, given the value of argv[0] from program startup and the address of main itself.

In extremis, this function may fail and return an empty path.

Referenced byprintMarkupStackTrace(), andprintSymbolizedStackTrace().

◆ getPermissions()

ErrorOr<perms > llvm::sys::fs::getPermissions

(

const Twine &

Path

)

Get file permissions.

Parameters

Path	File to get permissions from.

Returns: the permissions if they were successfully retrieved, otherwise a platform-specific error_code.

Note: On Windows, if the file does not have the FILE_ATTRIBUTE_READONLY attribute, all_all will be returned. Otherwise, all_read | all_exe will be returned.

Definition at line1151 of filePath.cpp.

Referencesstatus().

Referenced byllvm::FileCollector::copyFiles().

◆ getPotentiallyUniqueFileName()

std::error_code llvm::sys::fs::getPotentiallyUniqueFileName	(	const Twine &	Model,
		SmallVectorImpl<char > &	ResultPath
	)

Get a unique name, not currently exisiting in the filesystem.

Subject to race conditions, prefer to use createUniqueFile instead.

Similar to createUniqueFile, but instead of creating a file only checks if it exists. This function is subject to race conditions, if you want to use the returned name to actually create a file, use createUniqueFile instead.

Definition at line893 of filePath.cpp.

ReferencescreateUniqueEntity(), andFS_Name.

◆ getPotentiallyUniqueTempFileName()

std::error_code llvm::sys::fs::getPotentiallyUniqueTempFileName	(	const Twine &	Prefix,
		StringRef	Suffix,
		SmallVectorImpl<char > &	ResultPath
	)

Get a unique temporary file name, not currently exisiting in the filesystem.

Subject to race conditions, prefer to use createTemporaryFile instead.

Similar to createTemporaryFile, but instead of creating a file only checks if it exists. This function is subject to race conditions, if you want to use the returned name to actually create a file, use createTemporaryFile instead.

Definition at line900 of filePath.cpp.

ReferencescreateTemporaryFile(), andFS_Name.

◆ getStderrHandle()

file_t llvm::sys::fs::getStderrHandle

(

)

Return an open handle to standard error.

On Unix, this is typically FD 2. Returns kInvalidFile when the stream is closed.

◆ getStdinHandle()

file_t llvm::sys::fs::getStdinHandle

(

)

Return an open handle to standard in.

On Unix, this is typically FD 0. Returns kInvalidFile when the stream is closed.

Referenced byllvm::MemoryBuffer::getSTDIN().

◆ getStdoutHandle()

file_t llvm::sys::fs::getStdoutHandle

(

)

Return an open handle to standard out.

On Unix, this is typically FD 1. Returns kInvalidFile when the stream is closed.

◆ getUmask()

unsigned llvm::sys::fs::getUmask

(

)

Get file creation mode mask of the process.

Returns: Mask reported by umask(2)

Note: There is no umask on Windows. This function returns 0 always on Windows. This function does not return an error_code because umask(2) never fails. It is not thread safe.

Referenced byllvm::FilePermissionsApplier::apply().

◆ getUniqueID()

std::error_code llvm::sys::fs::getUniqueID	(	const Twine	Path,
		UniqueID &	Result
	)

Definition at line787 of filePath.cpp.

Referencesstatus().

Referenced byllvm::OpenMPIRBuilder::getTargetEntryUniqueInfo().

◆ is_directory()[1/3]

bool llvm::sys::fs::is_directory

(

const basic_file_status &

status

)

Does status represent a directory?

Parameters

status

Abasic_file_status previously returned from status.

Returns: status.type() ==file_type::directory_file.

Definition at line1092 of filePath.cpp.

Referencesdirectory_file, andstatus().

Referenced byllvm::FileCollectorBase::addDirectory(),llvm::object::MachOObjectFile::findDsymObjectMembers(),is_directory(),is_other(),llvm::pruneCache(), andllvm::ThinLTOCodeGenerator::run().

◆ is_directory()[2/3]

bool llvm::sys::fs::is_directory

(

const Twine &

Path

)

inline

Simpler version of is_directory for clients that don't need to differentiate between an error and false.

Definition at line555 of fileFileSystem.h.

Referencesis_directory().

◆ is_directory()[3/3]

std::error_code llvm::sys::fs::is_directory	(	const Twine &	path,
		bool &	result
	)

Is path a directory?

Parameters

path	Input path.
result	Set to true ifpath is a directory (after following symlinks, false if it is not. Undefined otherwise.

Returns: errc::success if result has been successfully set, otherwise a platform-specific error_code.

Definition at line1096 of filePath.cpp.

Referencesis_directory(), andstatus().

◆ is_local()[1/4]

bool llvm::sys::fs::is_local

(

const Twine &

Path

)

inline

Simpler version of is_local for clients that don't need to differentiate between an error and false.

Definition at line518 of fileFileSystem.h.

Referencesis_local().

◆ is_local()[2/4]

std::error_code llvm::sys::fs::is_local	(	const Twine &	path,
		bool &	result
	)

Is the file mounted on a local filesystem?

Parameters

path	Input path.
result	Set to true ifpath is on fixed media such as a hard disk, false if it is not.

Returns: errc::success if result has been successfully set, otherwise a platform specific error_code.

Referenced byis_local().

◆ is_local()[3/4]

bool llvm::sys::fs::is_local

(

int

)

inline

Simpler version of is_local accepting an open file descriptor for clients that don't need to differentiate between an error and false.

Definition at line525 of fileFileSystem.h.

Referencesis_local().

◆ is_local()[4/4]

std::error_code llvm::sys::fs::is_local	(	int	FD,
		bool &	result
	)

Version of is_local accepting an open file descriptor.

◆ is_other()[1/2]

bool llvm::sys::fs::is_other

(

const basic_file_status &

status

)

Does this status represent something that exists but is not a directory or regular file?

Parameters

status

Abasic_file_status previously returned from status.

Returns: exists(s) && !is_regular_file(s) && !is_directory(s)

Definition at line1128 of filePath.cpp.

Referencesexists(),is_directory(),is_regular_file(), andstatus().

Referenced byis_other().

◆ is_other()[2/2]

std::error_code llvm::sys::fs::is_other	(	const Twine &	path,
		bool &	result
	)

Is path something that exists but is not a directory, regular file, or symlink?

Parameters

path	Input path.
result	Set to true ifpath exists, but is not a directory, regular file, or a symlink, false if it does not. Undefined otherwise.

Returns: errc::success if result has been successfully set, otherwise a platform-specific error_code.

Definition at line1134 of filePath.cpp.

Referencesis_other(), andstatus().

◆ is_regular_file()[1/3]

bool llvm::sys::fs::is_regular_file

(

const basic_file_status &

status

)

Does status represent a regular file?

Parameters

status

Abasic_file_status previously returned from status.

Returns: status_known(status) && status.type() ==file_type::regular_file.

Definition at line1104 of filePath.cpp.

Referencesregular_file, andstatus().

Referenced byfindSrcDirMap(),is_other(), andis_regular_file().

◆ is_regular_file()[2/3]

bool llvm::sys::fs::is_regular_file

(

const Twine &

Path

)

inline

Simpler version of is_regular_file for clients that don't need to differentiate between an error and false.

Definition at line577 of fileFileSystem.h.

Referencesis_regular_file().

◆ is_regular_file()[3/3]

std::error_code llvm::sys::fs::is_regular_file	(	const Twine &	path,
		bool &	result
	)

Is path a regular file?

Parameters

path	Input path.
result	Set to true ifpath is a regular file (after following symlinks), false if it is not. Undefined otherwise.

Returns: errc::success if result has been successfully set, otherwise a platform-specific error_code.

Definition at line1108 of filePath.cpp.

Referencesis_regular_file(), andstatus().

◆ is_symlink_file()[1/3]

bool llvm::sys::fs::is_symlink_file

(

const basic_file_status &

status

)

Does status represent a symlink file?

Parameters

status

Abasic_file_status previously returned from status.

Returns: status_known(status) && status.type() ==file_type::symlink_file.

Definition at line1116 of filePath.cpp.

Referencesstatus(), andsymlink_file.

Referenced byis_symlink_file().

◆ is_symlink_file()[2/3]

bool llvm::sys::fs::is_symlink_file

(

const Twine &

Path

)

inline

Simpler version of is_symlink_file for clients that don't need to differentiate between an error and false.

Definition at line601 of fileFileSystem.h.

Referencesis_symlink_file().

◆ is_symlink_file()[3/3]

std::error_code llvm::sys::fs::is_symlink_file	(	const Twine &	path,
		bool &	result
	)

Is path a symlink file?

Parameters

path	Input path.
result	Set to true ifpath is a symlink file, false if it is not. Undefined otherwise.

Returns: errc::success if result has been successfully set, otherwise a platform-specific error_code.

Definition at line1120 of filePath.cpp.

Referencesis_symlink_file(), andstatus().

◆ lockFile()

std::error_code llvm::sys::fs::lockFile

(

int

)

Lock the file.

This function acts astryLockFile but it waits infinitely.

Referenced byllvm::raw_fd_ostream::lock().

◆ make_absolute()[1/2]

void llvm::sys::fs::make_absolute	(	const Twine &	current_directory,
		SmallVectorImpl<char > &	path
	)

Makepath an absolute path.

Makespath absolute using thecurrent_directory if it is not already. An emptypath will result in thecurrent_directory.

/absolute/path => /absolute/path relative/../path => <current-directory>/relative/../path

Parameters

path	A path that is modified to be an absolute path.

Definition at line906 of filePath.cpp.

Referencesllvm::sys::path::append(),llvm::StringRef::begin(),llvm::SmallVectorTemplateCommon< T, typename >::data(),llvm::StringRef::end(),llvm::sys::path::has_root_directory(),llvm::sys::path::has_root_name(),llvm_unreachable,llvm::sys::path::relative_path(),llvm::sys::path::root_directory(),llvm::sys::path::root_name(),llvm::SmallVectorBase< Size_T >::size(),llvm::SmallVectorImpl< T >::swap(), andllvm::Twine::toVector().

Referenced byllvm::canonicalizePath(),llvm::vfs::RedirectingFileSystem::create(),emitExternalFile(),llvm::AsmPrinter::emitRemarksSection(),findSrcDirMap(),llvm::LockFileManager::LockFileManager(),make_absolute(),llvm::MachO::make_relative(),makeAbsolute(),llvm::vfs::FileSystem::makeAbsolute(), andllvm::DotCfgChangeReporter::registerCallbacks().

◆ make_absolute()[2/2]

std::error_code llvm::sys::fs::make_absolute

(

SmallVectorImpl<char > &

path

)

Makepath an absolute path.

Makespath absolute using the current directory if it is not already. An emptypath will result in the current directory.

/absolute/path => /absolute/path relative/../path => <current-directory>/relative/../path

Parameters

path	A path that is modified to be an absolute path.

Returns: errc::success ifpath has been made absolute, otherwise a platform-specific error_code.

Definition at line955 of filePath.cpp.

Referencescurrent_path(),llvm::sys::path::is_absolute(), andmake_absolute().

◆ md5_contents()[1/2]

ErrorOr<MD5::MD5Result > llvm::sys::fs::md5_contents

(

const Twine &

Path

)

Version of compute_md5 that doesn't require an open file descriptor.

Definition at line1067 of filePath.cpp.

Referencesmd5_contents(),OF_None, andopenFileForRead().

◆ md5_contents()[2/2]

ErrorOr<MD5::MD5Result > llvm::sys::fs::md5_contents

(

int

)

Compute anMD5 hash of a file's contents.

Parameters

FD	Input file descriptor.

Returns: An MD5Result with the hash computed, if successful, otherwise a std::error_code.

Definition at line1047 of filePath.cpp.

Referencesllvm::errnoAsErrorCode(),llvm::MD5::final(),llvm::support::endian::read(), andllvm::MD5::update().

Referenced bymd5_contents().

◆ openFile()

std::error_code llvm::sys::fs::openFile	(	const Twine &	Name,
		int &	ResultFD,
		CreationDisposition	Disp,
		FileAccess	Access,
		OpenFlags	Flags,
		unsigned	Mode =`0666`
	)

Opens a file with the specified creation disposition, access mode, and flags and returns a file descriptor.

The caller is responsible for closing the file descriptor once they are finished with it.

Parameters

Name	The path of the file to open, relative or absolute.
ResultFD	If the file could be opened successfully, its descriptor is stored in this location. Otherwise, this is set to -1.
Disp	Value specifying the existing-file behavior.
Access	Value specifying whether to open the file in read, write, or read-write mode.
Flags	Additional flags.
Mode	The access permissions of the file, represented in octal.

Returns: errc::success ifName has been opened, otherwise a platform-specific error_code.

Referenced byopenFileForReadWrite(),openFileForWrite(), andprepareDumpIRFileDescriptor().

◆ openFileForRead()

std::error_code llvm::sys::fs::openFileForRead	(	const Twine &	Name,
		int &	ResultFD,
		OpenFlags	Flags =`OF_None`,
		SmallVectorImpl<char > *	RealPath =`nullptr`
	)

Opens the file with the given name in a read-only mode, returning its open file descriptor.

The caller is responsible for closing the file descriptor once they are finished with it.

Parameters

Name	The path of the file to open, relative or absolute.
ResultFD	If the file could be opened successfully, its descriptor is stored in this location. Otherwise, this is set to -1.
RealPath	If nonnull, extra work is done to determine the real path of the opened file, and that path is stored in this location.

Returns: errc::success ifName has been opened, otherwise a platform-specific error_code.

Referenced bycopy_file(), andmd5_contents().

◆ openFileForReadWrite()

std::error_code llvm::sys::fs::openFileForReadWrite	(	const Twine &	Name,
		int &	ResultFD,
		CreationDisposition	Disp,
		OpenFlags	Flags,
		unsigned	Mode =`0666`
	)

inline

Opens the file with the given name in a write-only or read-write mode, returning its open file descriptor.

If the file does not exist, it is created.

The caller is responsible for closing the file descriptor once they are finished with it.

Parameters

Name	The path of the file to open, relative or absolute.
ResultFD	If the file could be opened successfully, its descriptor is stored in this location. Otherwise, this is set to -1.
Flags	Additional flags used to determine whether the file should be opened in, for example, read-write or in write-only mode.
Mode	The access permissions of the file, represented in octal.

Returns: errc::success ifName has been opened, otherwise a platform-specific error_code.

Definition at line1099 of fileFileSystem.h.

ReferencesFA_Read,FA_Write,Mode,Name, andopenFile().

Referenced bycreateUniqueEntity(), andgetFD().

◆ openFileForWrite()

std::error_code llvm::sys::fs::openFileForWrite	(	const Twine &	Name,
		int &	ResultFD,
		CreationDisposition	Disp =`CD_CreateAlways`,
		OpenFlags	Flags =`OF_None`,
		unsigned	Mode =`0666`
	)

inline

Opens the file with the given name in a write-only or read-write mode, returning its open file descriptor.

If the file does not exist, it is created.

The caller is responsible for closing the file descriptor once they are finished with it.

Parameters

Name	The path of the file to open, relative or absolute.
ResultFD	If the file could be opened successfully, its descriptor is stored in this location. Otherwise, this is set to -1.
Flags	Additional flags used to determine whether the file should be opened in, for example, read-write or in write-only mode.
Mode	The access permissions of the file, represented in octal.

Returns: errc::success ifName has been opened, otherwise a platform-specific error_code.

Definition at line1058 of fileFileSystem.h.

ReferencesFA_Write,Mode,Name, andopenFile().

Referenced byllvm::FilePermissionsApplier::apply(),copy_file(),copyAccessAndModificationTime(),getFD(),llvm::prepareTempFiles(),llvm::unittest::TempFile::TempFile(), andllvm::WriteGraph().

◆ openNativeFile()

Expected<file_t > llvm::sys::fs::openNativeFile	(	const Twine &	Name,
		CreationDisposition	Disp,
		FileAccess	Access,
		OpenFlags	Flags,
		unsigned	Mode =`0666`
	)

Opens a file with the specified creation disposition, access mode, and flags and returns a platform-specific file object.

The caller is responsible for closing the file object once they are finished with it.

Parameters

Name	The path of the file to open, relative or absolute.
Disp	Value specifying the existing-file behavior.
Access	Value specifying whether to open the file in read, write, or read-write mode.
Flags	Additional flags.
Mode	The access permissions of the file, represented in octal.

Returns: errc::success ifName has been opened, otherwise a platform-specific error_code.

Referenced byopenNativeFileForReadWrite(), andopenNativeFileForWrite().

◆ openNativeFileForRead()

Expected<file_t > llvm::sys::fs::openNativeFileForRead	(	const Twine &	Name,
		OpenFlags	Flags =`OF_None`,
		SmallVectorImpl<char > *	RealPath =`nullptr`
	)

Opens the file with the given name in a read-only mode, returning its open file descriptor.

The caller is responsible for closing the freeing the file once they are finished with it.

Parameters

Name	The path of the file to open, relative or absolute.
RealPath	If nonnull, extra work is done to determine the real path of the opened file, and that path is stored in this location.

Returns: a platform-specific file descriptor ifName has been opened, otherwise an error object.

Referenced byllvm::NewArchiveMember::getFile(),llvm::MemoryBuffer::getFileAsStream(),getFileAux(),llvm::xray::loadInstrumentationMap(),llvm::orc::loadLinkableFile(),llvm::orc::loadMachORelocatableObject(),llvm::xray::loadProfile(),llvm::xray::loadTraceFile(),llvm::localCache(), andllvm::streamFile().

◆ openNativeFileForReadWrite()

Expected<file_t > llvm::sys::fs::openNativeFileForReadWrite	(	const Twine &	Name,
		CreationDisposition	Disp,
		OpenFlags	Flags,
		unsigned	Mode =`0666`
	)

inline

Opens the file with the given name in a write-only or read-write mode, returning its open file descriptor.

If the file does not exist, it is created.

The caller is responsible for closing the freeing the file once they are finished with it.

Parameters

Name	The path of the file to open, relative or absolute.
Flags	Additional flags used to determine whether the file should be opened in, for example, read-write or in write-only mode.
Mode	The access permissions of the file, represented in octal.

Returns: a platform-specific file descriptor ifName has been opened, otherwise an error object.

Definition at line1119 of fileFileSystem.h.

ReferencesFA_Read,FA_Write,Mode,Name, andopenNativeFile().

Referenced bygetReadWriteFile().

◆ openNativeFileForWrite()

Expected<file_t > llvm::sys::fs::openNativeFileForWrite	(	const Twine &	Name,
		CreationDisposition	Disp,
		OpenFlags	Flags,
		unsigned	Mode =`0666`
	)

inline

Opens the file with the given name in a write-only or read-write mode, returning its open file descriptor.

If the file does not exist, it is created.

The caller is responsible for closing the freeing the file once they are finished with it.

Parameters

Name	The path of the file to open, relative or absolute.
Flags	Additional flags used to determine whether the file should be opened in, for example, read-write or in write-only mode.
Mode	The access permissions of the file, represented in octal.

Returns: a platform-specific file descriptor ifName has been opened, otherwise an error object.

Definition at line1077 of fileFileSystem.h.

ReferencesFA_Write,Mode,Name, andopenNativeFile().

◆ operator&()

perms llvm::sys::fs::operator&	(	perms	l,
		perms	r
	)

inline

Definition at line111 of fileFileSystem.h.

◆ operator&=()

perms & llvm::sys::fs::operator&=	(	perms &	l,
		perms	r
	)

inline

Definition at line119 of fileFileSystem.h.

◆ operator|()[1/3]

FileAccess llvm::sys::fs::operator\|	(	FileAccess	A,
		FileAccess	B
	)

inline

Definition at line933 of fileFileSystem.h.

ReferencesA, andB.

◆ operator|()[2/3]

OpenFlags llvm::sys::fs::operator\|	(	OpenFlags	A,
		OpenFlags	B
	)

inline

Definition at line924 of fileFileSystem.h.

ReferencesA, andB.

◆ operator|()[3/3]

perms llvm::sys::fs::operator\|	(	perms	l,
		perms	r
	)

inline

Definition at line107 of fileFileSystem.h.

◆ operator|=()[1/3]

FileAccess & llvm::sys::fs::operator\|=	(	FileAccess &	A,
		FileAccess	B
	)

inline

Definition at line937 of fileFileSystem.h.

ReferencesA, andB.

◆ operator|=()[2/3]

OpenFlags & llvm::sys::fs::operator\|=	(	OpenFlags &	A,
		OpenFlags	B
	)

inline

Definition at line928 of fileFileSystem.h.

ReferencesA, andB.

◆ operator|=()[3/3]

perms & llvm::sys::fs::operator\|=	(	perms &	l,
		perms	r
	)

inline

Definition at line115 of fileFileSystem.h.

◆ operator~()

perms llvm::sys::fs::operator~

(

perms

)

inline

Definition at line123 of fileFileSystem.h.

◆ readNativeFile()

Expected< size_t > llvm::sys::fs::readNativeFile	(	file_t	FileHandle,
		MutableArrayRef<char >	Buf
	)

ReadsBuf.size() bytes fromFileHandle intoBuf.

Returns the number of bytes actually read. On Unix, this is equivalent toreturn ::read(FD, Buf.data(), Buf.size()), with error reporting. Returns 0 when reaching EOF.

Parameters

FileHandle	File to read from.
Buf	Buffer to read into.

Returns: The number of bytes read, or error.

Referenced byreadNativeFileToEOF().

◆ readNativeFileSlice()

Expected< size_t > llvm::sys::fs::readNativeFileSlice	(	file_t	FileHandle,
		MutableArrayRef<char >	Buf,
		uint64_t	Offset
	)

ReadsBuf.size() bytes fromFileHandle at offsetOffset intoBuf.

If 'pread' is available, this will use that, otherwise it will use 'lseek'. Returns the number of bytes actually read. Returns 0 when reaching EOF.

Parameters

FileHandle	File to read from.
Buf	Buffer to read into.
Offset	Offset into the file at which the read should occur.

Returns: The number of bytes read, or error.

Referenced bygetOpenFileImpl().

◆ readNativeFileToEOF()

Error llvm::sys::fs::readNativeFileToEOF	(	file_t	FileHandle,
		SmallVectorImpl<char > &	Buffer,
		ssize_t	ChunkSize =`DefaultReadChunkSize`
	)

Reads fromFileHandle until EOF, appending toBuffer in chunks of sizeChunkSize.

This callsreadNativeFile() in a loop. OnError, previous chunks that were read successfully are left inBuffer and returned.

Note: For reading the final chunk at EOF,Buffer's capacity needs extra storage ofChunkSize.

Parameters

FileHandle	File to read from.
Buffer	Where to put the file content.
ChunkSize	Size of chunks.

Returns: The error if EOF was not found.

Definition at line1174 of filePath.cpp.

Referencesllvm::SmallVectorTemplateCommon< T, typename >::begin(),llvm::make_scope_exit(),readNativeFile(),llvm::SmallVectorImpl< T >::resize_for_overwrite(),llvm::SmallVectorBase< Size_T >::size(),Size,llvm::Error::success(),llvm::Expected< T >::takeError(), andllvm::SmallVectorImpl< T >::truncate().

Referenced bygetMemoryBufferForStream().

◆ real_path()

std::error_code llvm::sys::fs::real_path	(	const Twine &	path,
		SmallVectorImpl<char > &	output,
		bool	expand_tilde =`false`
	)

Collapse all .

and .. patterns, resolve all symlinks, and optionally expand ~ expressions to the user's home directory.

Parameters

path	The path to resolve.
output	The location to store the resolved path.
expand_tilde	If true, resolves ~ expressions to the user's home directory.

Referenced byllvm::dwarf_linker::parallel::CompileUnit::getFileName(),isCaseSensitivePath(),llvm::dwarf_linker::classic::CachedPathResolver::resolve(), andllvm::unittest::TempDir::TempDir().

◆ remove()

std::error_code llvm::sys::fs::remove	(	const Twine &	path,
		bool	IgnoreNonExisting =`true`
	)

Remove path.

Equivalent to POSIXremove().

Parameters

path	Input path.

Returns: errc::success if path has been removed or didn't exist, otherwise a platform-specific error code. If IgnoreNonExisting is false, also returns error if the file didn't exist.

Referenced bycleanUpTempFilesImpl(),llvm::LTOCodeGenerator::compileOptimized(),llvm::sys::fs::TempFile::discard(),ExecGraphViewer(),llvm::DotCfgChangeReporter::handleFunctionCompare(),llvm::sys::fs::TempFile::keep(),llvm::LockFileManager::LockFileManager(),llvm::pruneCache(),llvm::FileRemover::setFile(),llvm::LockFileManager::unsafeRemoveLockFile(),llvm::ThinLTOCodeGenerator::writeGeneratedObject(),llvm::CleanupInstaller::~CleanupInstaller(),llvm::FileRemover::~FileRemover(),llvm::LockFileManager::~LockFileManager(),llvm::unittest::TempFile::~TempFile(), andllvm::unittest::TempLink::~TempLink().

◆ remove_directories()

std::error_code llvm::sys::fs::remove_directories	(	const Twine &	path,
		bool	IgnoreErrors =`true`
	)

Recursively delete a directory.

Parameters

path	Input path.

Returns: errc::success if path has been removed or didn't exist, otherwise a platform-specific error code.

Referenced byllvm::unittest::TempDir::~TempDir().

◆ rename()

std::error_code llvm::sys::fs::rename	(	const Twine &	from,
		const Twine &	to
	)

Renamefrom toto.

Files are renamed as if by POSIXrename(), except that on Windows there may be a short interval of time during which the destination file does not exist.

Parameters

from	The path to rename from.
to	The path to rename to. This is created.

Referenced byllvm::sys::fs::TempFile::keep().

◆ resize_file()

std::error_code llvm::sys::fs::resize_file	(	int	FD,
		uint64_t	Size
	)

Resize path to size.

File is resized as if by POSIX truncate().

Parameters

FD	Input file descriptor.
Size	Size to resize to.

Returns: errc::success ifpath has been resized tosize, otherwise a platform-specific error_code.

Referenced byresize_file_before_mapping_readwrite().

◆ resize_file_before_mapping_readwrite()

std::error_code llvm::sys::fs::resize_file_before_mapping_readwrite	(	int	FD,
		uint64_t	Size
	)

inline

ResizeFD toSize before mappingmapped_file_region::readwrite.

On non-Windows, this callsresize_file(). On Windows, this is a no-op, since the subsequent mapping (viaCreateFileMapping) automatically extends the file.

Definition at line411 of fileFileSystem.h.

Referencesresize_file(), andSize.

Referenced bycreateOnDiskBuffer().

◆ set_current_path()

std::error_code llvm::sys::fs::set_current_path

(

const Twine &

path

)

Set the current path.

Parameters

path	The path to set.

Returns: errc::success if the current path was successfully set, otherwise a platform-specific error_code.

◆ setLastAccessAndModificationTime()[1/2]

std::error_code llvm::sys::fs::setLastAccessAndModificationTime	(	int	FD,
		TimePoint<>	AccessTime,
		TimePoint<>	ModificationTime
	)

Set the file modification and access time.

Returns: errc::success if the file times were successfully set, otherwise a platform-specific error_code orerrc::function_not_supported on platforms where the functionality isn't available.

Referenced byllvm::FilePermissionsApplier::apply(),copyAccessAndModificationTime(), andsetLastAccessAndModificationTime().

◆ setLastAccessAndModificationTime()[2/2]

std::error_code llvm::sys::fs::setLastAccessAndModificationTime	(	int	FD,
		TimePoint<>	Time
	)

inline

Simpler version that sets both file modification and access time to the same time.

Definition at line703 of fileFileSystem.h.

ReferencessetLastAccessAndModificationTime().

◆ setPermissions()[1/2]

std::error_code llvm::sys::fs::setPermissions	(	const Twine &	Path,
		perms	Permissions
	)

Set file permissions.

Parameters

Path	File to set permissions on.
Permissions	New file permissions.

Returns: errc::success if the permissions were successfully set, otherwise a platform-specific error_code.

Note: On Windows, all permissions except *_write are ignored. Using any of owner_write, group_write, or all_write will make the file writable. Otherwise, the file will be marked as read-only.

Referenced byllvm::FilePermissionsApplier::apply(), andllvm::FileCollector::copyFiles().

◆ setPermissions()[2/2]

std::error_code llvm::sys::fs::setPermissions	(	int	FD,
		perms	Permissions
	)

Vesion of setPermissions accepting a file descriptor.

TODO Delete the path based overload once we implement the FD based overload on Windows.

◆ status()[1/2]

std::error_code llvm::sys::fs::status	(	const Twine &	path,
		file_status &	result,
		bool	follow =`true`
	)

Get file status as if by POSIX stat().

Parameters

path	Input path.
result	Set to the file status.
follow	When true, follows symlinks. Otherwise, the symlink itself is statted.

Returns: errc::success if result has been successfully set, otherwise a platform-specific error_code.

Referenced byllvm::FilePermissionsApplier::apply(),llvm::FileCollector::copyFiles(),llvm::FileOutputBuffer::create(),llvm::FilePermissionsApplier::create(),exists(),file_size(),llvm::object::MachOObjectFile::findDsymObjectMembers(),get_file_type(),llvm::NewArchiveMember::getFile(),getOpenFileImpl(),getPermissions(),getReadWriteFile(),getUniqueID(),llvm::sys::fs::recursive_directory_iterator::increment(),is_directory(),is_other(),is_regular_file(),is_symlink_file(),llvm::pruneCache(),llvm::MachO::shouldSkipSymLink(), andshouldUseMmap().

◆ status()[2/2]

std::error_code llvm::sys::fs::status	(	int	FD,
		file_status &	Result
	)

A version for when a file descriptor is already available.

◆ status_known()[1/2]

bool llvm::sys::fs::status_known

(

const basic_file_status &

)

Is status available?

Parameters

s	Input file status.

Returns: True ifstatus() != status_error.

Definition at line1081 of filePath.cpp.

Referencesstatus_error, andllvm::sys::fs::basic_file_status::type().

Referenced byexists().

◆ status_known()[2/2]

std::error_code llvm::sys::fs::status_known	(	const Twine &	path,
		bool &	result
	)

Is status available?

Parameters

path	Input path.
result	Set to true ifstatus() != status_error.

Returns: errc::success if result has been successfully set, otherwise a platform-specific error_code.

◆ tryLockFile()

std::error_code llvm::sys::fs::tryLockFile	(	int	FD,
		std::chrono::milliseconds	Timeout =`std::chrono::milliseconds(0)`
	)

Try to locks the file during the specified time.

This function implements advisory locking on entire file. If it returnserrc::success, the file is locked by the calling process. Until the process unlocks the file by callingunlockFile, all attempts to lock the same file will fail/block. The process that locked the file may assume that none of other processes read or write this file, provided that all processes lock the file prior to accessing its content.

Parameters

FD	The descriptor representing the file to lock.
Timeout	Time in milliseconds that the process should wait before reporting lock failure. Zero value means try to get lock only once.

Returns: errc::success if lock is successfully obtained,errc::no_lock_available if the file cannot be locked, or platform-specific error_code otherwise.

Note: Care should be taken when using this function in a multithreaded context, as it may not prevent other threads in the same process from obtaining a lock on the same file, even if they are using a different file descriptor.

Referenced byllvm::raw_fd_ostream::tryLockFor().

◆ unlockFile()

std::error_code llvm::sys::fs::unlockFile

(

int

)

Unlock the file.

Parameters

FD	The descriptor representing the file to unlock.

Returns: errc::success if lock is successfully released or platform-specific error_code otherwise.

Referenced byllvm::sys::fs::FileLocker::unlock(), andllvm::sys::fs::FileLocker::~FileLocker().

Variable Documentation

◆ kInvalidFile

const file_t llvm::sys::fs::kInvalidFile

extern

Referenced byllvm::NewArchiveMember::getFile().

Movatterモバイル変換

Namespaces

Classes

Typedefs

Enumerations

Functions

Variables

Physical Observers

Typedef Documentation

◆ file_t

Enumeration Type Documentation

◆ anonymous enum

◆ AccessMode

◆ CreationDisposition

◆ file_type

◆ FileAccess

◆ OpenFlags

◆ perms

Function Documentation

◆ access()

◆ can_execute()

◆ can_write()

◆ changeFileOwnership()

◆ closeFile()

◆ convertFDToNativeFile()

◆ copy_file()[1/2]

◆ copy_file()[2/2]

◆ copy_file_internal()

◆ create_directories()

◆ create_directory()

◆ create_hard_link()

◆ create_link()

◆ createTemporaryFile()[1/4]

◆ createTemporaryFile()[2/4]

◆ createTemporaryFile()[3/4]

◆ createTemporaryFile()[4/4]

◆ createUniqueDirectory()

◆ createUniqueFile()[1/2]

◆ createUniqueFile()[2/2]

◆ createUniquePath()

◆ current_path()

◆ disk_space()

◆ equivalent()[1/3]

◆ equivalent()[2/3]

◆ equivalent()[3/3]

◆ exists()[1/2]

◆ exists()[2/2]

◆ expand_tilde()

◆ file_size()

◆ get_file_type()

◆ getMainExecutable()

◆ getPermissions()

◆ getPotentiallyUniqueFileName()

◆ getPotentiallyUniqueTempFileName()

◆ getStderrHandle()

◆ getStdinHandle()

◆ getStdoutHandle()

◆ getUmask()

◆ getUniqueID()

◆ is_directory()[1/3]

◆ is_directory()[2/3]

◆ is_directory()[3/3]

◆ is_local()[1/4]

◆ is_local()[2/4]

◆ is_local()[3/4]

◆ is_local()[4/4]

◆ is_other()[1/2]

◆ is_other()[2/2]

◆ is_regular_file()[1/3]

◆ is_regular_file()[2/3]

◆ is_regular_file()[3/3]

◆ is_symlink_file()[1/3]

◆ is_symlink_file()[2/3]

◆ is_symlink_file()[3/3]

◆ lockFile()

◆ make_absolute()[1/2]

◆ make_absolute()[2/2]

◆ md5_contents()[1/2]

◆ md5_contents()[2/2]

◆ openFile()