jami::fileutils Namespace Reference

Classes
struct	ArchiveStorageData

Functions
int	accessFile (const std::string &file, int mode)
	Windows compatibility wrapper for checking read-only attribute.
bool	createFileLink (const std::filesystem::path &linkFile, const std::filesystem::path &target, bool hard)
bool	createHardlink (const std::filesystem::path &linkFile, const std::filesystem::path &target)
bool	createSymlink (const std::filesystem::path &linkFile, const std::filesystem::path &target)
bool	eraseFile (const std::string &path, bool dosync)
bool	eraseFile_posix (const std::string &path, bool dosync)
std::string	expand_path (const std::string &path)
	Expand the given path.
const std::filesystem::path &	get_cache_dir ()
std::filesystem::path	get_cache_dir (const char *pkg)
const std::filesystem::path &	get_config_dir ()
std::filesystem::path	get_config_dir (const char *pkg)
const std::filesystem::path &	get_data_dir ()
std::filesystem::path	get_data_dir (const char *pkg)
const std::filesystem::path &	get_home_dir ()
std::filesystem::path	get_home_dir_impl ()
const std::filesystem::path &	get_resource_dir_path ()
	Get the resource directory path that was set with set_resource_dir_path.
std::string	getCleanPath (const std::string &base, const std::string &path)
	If path is contained in base, return the suffix, otherwise return the full path.
std::string_view	getFileExtension (std::string_view filename)
std::filesystem::path	getFullPath (const std::filesystem::path &base, const std::filesystem::path &path)
	If path is relative, it is appended to base.
bool	isDirectoryWritable (const std::string &directory)
bool	isPathRelative (const std::filesystem::path &path)
uint64_t	lastWriteTimeInSeconds (const std::filesystem::path &filePath)
	Return the last write time (epoch time) of a given file path (in seconds).
std::vector< uint8_t >	loadCacheFile (const std::filesystem::path &path, std::chrono::system_clock::duration maxAge)
std::string	loadCacheTextFile (const std::filesystem::path &path, std::chrono::system_clock::duration maxAge)
std::vector< uint8_t >	loadFile (const std::filesystem::path &path, const std::filesystem::path &default_dir={})
	Read the full content of a file at path.
std::string	loadTextFile (const std::filesystem::path &path, const std::filesystem::path &default_dir)
ArchiveStorageData	readArchive (const std::filesystem::path &path, std::string_view scheme, const std::string &pwd)
int	remove (const std::filesystem::path &path, bool erase)
void	saveFile (const std::filesystem::path &path, const std::vector< uint8_t > &data, mode_t mode=0644)
void	saveFile (const std::filesystem::path &path, const uint8_t *data, size_t data_size, mode_t mode=0644)
void	saveFile (const std::filesystem::path &path, const uint8_t *data, size_t data_size, mode_t UNUSED mode)
void	set_resource_dir_path (const std::filesystem::path &resourceDirPath)
	Set the program's resource directory path.
std::string	sha3File (const std::filesystem::path &path)
std::string	sha3sum (const std::vector< uint8_t > &buffer)
std::string	sha3sum (const uint8_t *data, size_t size)
int64_t	size (const std::filesystem::path &path)
bool	writeArchive (const std::string &archive_str, const std::filesystem::path &path, std::string_view scheme, const std::string &password, const std::vector< uint8_t > &password_salt)

Variables
static constexpr auto	ARCHIVE_AUTH_SCHEME_KEY = "key"sv
static constexpr auto	ARCHIVE_AUTH_SCHEME_NONE = ""sv
static constexpr auto	ARCHIVE_AUTH_SCHEME_PASSWORD = "password"sv
static std::filesystem::path	resource_dir_path

Function Documentation

accessFile()

int jami::fileutils::accessFile	(	const std::string &	file,
		int	mode
	)

Windows compatibility wrapper for checking read-only attribute.

Definition at line 819 of file fileutils.cpp.

References jami::emitSignal().

Referenced by isDirectoryWritable().

Here is the call graph for this function:

createFileLink()

bool jami::fileutils::createFileLink	(	const std::filesystem::path &	linkFile,
		const std::filesystem::path &	target,
		bool	hard
	)

Definition at line 216 of file fileutils.cpp.

References createHardlink(), createSymlink(), and jami::emitSignal().

Here is the call graph for this function:

createHardlink()

bool jami::fileutils::createHardlink	(	const std::filesystem::path &	linkFile,
		const std::filesystem::path &	target
	)

Definition at line 202 of file fileutils.cpp.

References jami::emitSignal(), JAMI_LOG, and JAMI_WARNING.

Referenced by createFileLink().

Here is the call graph for this function:

createSymlink()

bool jami::fileutils::createSymlink	(	const std::filesystem::path &	linkFile,
		const std::filesystem::path &	target
	)

Definition at line 188 of file fileutils.cpp.

References jami::emitSignal(), JAMI_LOG, and JAMI_WARNING.

Referenced by createFileLink().

Here is the call graph for this function:

eraseFile()

bool jami::fileutils::eraseFile	(	const std::string &	path,
		bool	dosync
	)

Definition at line 731 of file fileutils.cpp.

References jami::emitSignal(), and eraseFile_posix().

Referenced by remove().

Here is the call graph for this function:

eraseFile_posix()

bool jami::fileutils::eraseFile_posix	(	const std::string &	path,
		bool	dosync
	)

Definition at line 687 of file fileutils.cpp.

References jami::emitSignal(), JAMI_WARN, JAMI_WARNING, S_IWGRP, and S_IWUSR.

Referenced by eraseFile().

Here is the call graph for this function:

expand_path()

std::string jami::fileutils::expand_path

(

const std::string &

path

)

Expand the given path.

Parameters

path	The path to be expanded.

Returns

The expanded path as a string.

Definition at line 139 of file fileutils.cpp.

References jami::emitSignal(), and JAMI_ERR.

Referenced by jami::AudioPreference::setRecordPath().

Here is the call graph for this function:

get_cache_dir() [1/2]

const std::filesystem::path & jami::fileutils::get_cache_dir

(

)

Definition at line 491 of file fileutils.cpp.

References jami::emitSignal(), and get_cache_dir().

Referenced by jami::SIPAccountBase::flush(), get_cache_dir(), jami::Manager::init(), jami::SIPAccountBase::loadConfig(), and jami::NameDirectory::NameDirectory().

Here is the call graph for this function:

get_cache_dir() [2/2]

std::filesystem::path jami::fileutils::get_cache_dir

(

const char *

pkg

)

Definition at line 465 of file fileutils.cpp.

References jami::emitSignal(), get_home_dir(), jami::to_string(), and XDG_CACHE_HOME.

Here is the call graph for this function:

get_config_dir() [1/2]

const std::filesystem::path & jami::fileutils::get_config_dir

(

)

Definition at line 615 of file fileutils.cpp.

References jami::emitSignal(), and get_config_dir().

Referenced by get_config_dir(), jami::Manager::init(), jami::MediaEncoder::readConfig(), and jami::Manager::ManagerPimpl::retrieveConfigPath().

Here is the call graph for this function:

get_config_dir() [2/2]

std::filesystem::path jami::fileutils::get_config_dir

(

const char *

pkg

)

Definition at line 580 of file fileutils.cpp.

References jami::emitSignal(), get_home_dir(), JAMI_DBG, and XDG_CONFIG_HOME.

Here is the call graph for this function:

get_data_dir() [1/2]

const std::filesystem::path & jami::fileutils::get_data_dir

(

)

Definition at line 573 of file fileutils.cpp.

References jami::emitSignal(), and get_data_dir().

Referenced by jami::OutgoingFile::cancel(), jami::ConversationRepository::cloneConversation(), jami::ConversationRepository::createConversation(), jami::ConversationModule::Impl::editMessage(), get_data_dir(), jami::PluginPreferencesUtils::getAllowDenyListsPath(), jami::JamiPluginManager::getInstalledPlugins(), jami::GitServer::GitServer(), jami::ConversationRepository::Impl::Impl(), jami::Conversation::Impl::Impl(), jami::TransferManager::Impl::Impl(), jami::Manager::init(), jami::Conversation::Impl::init(), jami::JamiPluginManager::installPlugin(), jami::Manager::loadAccountAndConversation(), jami::Manager::loadAccountMap(), jami::ConversationModule::loadConversations(), jami::ConversationModule::Impl::loadMetadata(), jami::ConversationModule::loadSingleConversation(), jami::Conversation::Impl::repoPath(), jami::ConversationRepository::Impl::repository(), jami::ConversationModule::saveConvInfos(), jami::ConversationModule::saveConvRequests(), jami::ConversationModule::Impl::saveMetadata(), jami::TransferChannelHandler::TransferChannelHandler(), jami::JamiPluginManager::uninstallPlugin(), and jami::PluginPreferencesUtils::valuesFilePath().

Here is the call graph for this function:

get_data_dir() [2/2]

std::filesystem::path jami::fileutils::get_data_dir

(

const char *

pkg

)

Definition at line 541 of file fileutils.cpp.

References jami::emitSignal(), get_home_dir(), and XDG_DATA_HOME.

Here is the call graph for this function:

get_home_dir()

const std::filesystem::path & jami::fileutils::get_home_dir

(

)

Definition at line 534 of file fileutils.cpp.

References jami::emitSignal(), and get_home_dir_impl().

Referenced by get_cache_dir(), get_config_dir(), get_data_dir(), and jami::Recordable::toggleRecording().

Here is the call graph for this function:

get_home_dir_impl()

std::filesystem::path jami::fileutils::get_home_dir_impl

(

)

Definition at line 498 of file fileutils.cpp.

References jami::emitSignal(), PROTECTED_GETENV, and jami::to_string().

Referenced by get_home_dir().

Here is the call graph for this function:

get_resource_dir_path()

const std::filesystem::path & jami::fileutils::get_resource_dir_path

(

)

Get the resource directory path that was set with set_resource_dir_path.

Returns

The resource directory path.

Definition at line 132 of file fileutils.cpp.

References jami::emitSignal(), and resource_dir_path.

Referenced by jami::Account::loadConfig().

Here is the call graph for this function:

getCleanPath()

std::string jami::fileutils::getCleanPath	(	const std::string &	base,
		const std::string &	path
	)

If path is contained in base, return the suffix, otherwise return the full path.

Parameters

base	must not finish with DIR_SEPARATOR_STR, can be empty
path	the path

Definition at line 251 of file fileutils.cpp.

References DIR_SEPARATOR_STR, and jami::emitSignal().

Here is the call graph for this function:

getFileExtension()

std::string_view jami::fileutils::getFileExtension

(

std::string_view

filename

)

Definition at line 233 of file fileutils.cpp.

References jami::emitSignal().

Referenced by jami::ConversationRepository::Impl::convCommitToMap().

Here is the call graph for this function:

getFullPath()

std::filesystem::path jami::fileutils::getFullPath	(	const std::filesystem::path &	base,
		const std::filesystem::path &	path
	)

If path is relative, it is appended to base.

Definition at line 263 of file fileutils.cpp.

References jami::emitSignal(), and isPathRelative().

Referenced by jami::Conversation::Impl::isAdmin(), jami::ConversationRepository::join(), jami::Account::loadConfig(), loadFile(), loadTextFile(), jami::parsePath(), jami::yaml_utils::parsePath(), jami::yaml_utils::parsePathOptional(), jami::ConversationRepository::resolveVote(), jami::JamiAccountConfig::toMap(), jami::ConversationRepository::voteKick(), and jami::ConversationRepository::voteUnban().

Here is the call graph for this function:

isDirectoryWritable()

bool jami::fileutils::isDirectoryWritable

(

const std::string &

directory

)

Definition at line 182 of file fileutils.cpp.

References accessFile(), and jami::emitSignal().

Referenced by jami::AudioPreference::setRecordPath().

Here is the call graph for this function:

isPathRelative()

bool jami::fileutils::isPathRelative

(

const std::filesystem::path &

path

)

Definition at line 245 of file fileutils.cpp.

References jami::emitSignal().

Referenced by getFullPath().

Here is the call graph for this function:

lastWriteTimeInSeconds()

uint64_t jami::fileutils::lastWriteTimeInSeconds

(

const std::filesystem::path &

filePath

)

Return the last write time (epoch time) of a given file path (in seconds).

Definition at line 829 of file fileutils.cpp.

References jami::emitSignal(), and JAMI_WARNING.

Referenced by jami::Conversation::preferences(), and jami::Conversation::updatePreferences().

Here is the call graph for this function:

loadCacheFile()

std::vector< uint8_t > jami::fileutils::loadCacheFile	(	const std::filesystem::path &	path,
		std::chrono::system_clock::duration	maxAge
	)

Definition at line 322 of file fileutils.cpp.

References jami::emitSignal(), and JAMI_LOG.

Here is the call graph for this function:

loadCacheTextFile()

std::string jami::fileutils::loadCacheTextFile	(	const std::filesystem::path &	path,
		std::chrono::system_clock::duration	maxAge
	)

Definition at line 338 of file fileutils.cpp.

References jami::emitSignal(), JAMI_LOG, and loadTextFile().

Here is the call graph for this function:

loadFile()

std::vector< uint8_t > jami::fileutils::loadFile	(	const std::filesystem::path &	path,
		const std::filesystem::path &	default_dir = {}
	)

Read the full content of a file at path.

If path is relative, it is appended to default_dir.

Definition at line 270 of file fileutils.cpp.

References jami::emitSignal(), and getFullPath().

Referenced by jami::ConversationRepository::Impl::devices(), libjami::getCertificateDetailsPath(), jami::ConversationRepository::infos(), jami::ConversationRepository::leave(), jami::Conversation::Impl::loadActiveCalls(), jami::Conversation::Impl::loadHostedCalls(), jami::ConversationRepository::Impl::loadMembers(), jami::ConversationModule::Impl::loadMetadata(), jami::Conversation::Impl::loadStatus(), jami::TransferManager::Impl::loadWaiting(), jami::Conversation::preferences(), jami::PluginUtils::readPluginCertificate(), jami::ConversationRepository::Impl::resolveBan(), jami::tls::TlsValidator::TlsValidator(), jami::SIPAccount::updateProfile(), jami::ConversationRepository::Impl::uriFromDevice(), jami::ConversationRepository::Impl::validateDevice(), and jami::Conversation::vCard().

Here is the call graph for this function:

loadTextFile()

std::string jami::fileutils::loadTextFile	(	const std::filesystem::path &	path,
		const std::filesystem::path &	default_dir
	)

Definition at line 276 of file fileutils.cpp.

References jami::emitSignal(), getFullPath(), and size().

Referenced by jami::Account::getProfileVcard(), and loadCacheTextFile().

Here is the call graph for this function:

readArchive()

ArchiveStorageData jami::fileutils::readArchive	(	const std::filesystem::path &	path,
		std::string_view	scheme,
		const std::string &	pwd
	)

Definition at line 354 of file fileutils.cpp.

References ARCHIVE_AUTH_SCHEME_KEY, ARCHIVE_AUTH_SCHEME_PASSWORD, jami::base64::decode(), jami::archiver::decompress(), jami::emitSignal(), JAMI_ERROR, JAMI_LOG, JAMI_WARNING, and jami::fileutils::ArchiveStorageData::salt.

Referenced by jami::AccountArchive::load().

Here is the call graph for this function:

remove()

int jami::fileutils::remove	(	const std::filesystem::path &	path,
		bool	erase
	)

Definition at line 741 of file fileutils.cpp.

References jami::emitSignal(), and eraseFile().

Here is the call graph for this function:

saveFile() [1/3]

void jami::fileutils::saveFile ( const std::filesystem::path &  path, const std::vector< uint8_t > &  data, mode_t  mode = 0644  )

inline

Definition at line 114 of file fileutils.h.

References saveFile().

Here is the call graph for this function:

saveFile() [2/3]

void jami::fileutils::saveFile	(	const std::filesystem::path &	path,
		const uint8_t *	data,
		size_t	data_size,
		mode_t	mode = 0644
	)

saveFile() [3/3]

void jami::fileutils::saveFile	(	const std::filesystem::path &	path,
		const uint8_t *	data,
		size_t	data_size,
		mode_t UNUSED	mode
	)

Definition at line 303 of file fileutils.cpp.

References jami::emitSignal(), JAMI_ERROR, and JAMI_WARNING.

Referenced by saveFile(), and writeArchive().

Here is the call graph for this function:

set_resource_dir_path()

LIBJAMI_PUBLIC void jami::fileutils::set_resource_dir_path

(

const std::filesystem::path &

resourceDirPath

)

Set the program's resource directory path.

This is used for clients that may be installed in different locations and are deployed with ringtones and other resources in an application relative directory.

Parameters

resource_dir_path

The path to the ringtone directory.

Definition at line 126 of file fileutils.cpp.

References jami::emitSignal(), and resource_dir_path.

Referenced by libjami::setResourceDirPath().

Here is the call graph for this function:

sha3File()

std::string jami::fileutils::sha3File

(

const std::filesystem::path &

path

)

Definition at line 770 of file fileutils.cpp.

References jami::emitSignal(), and JAMI_ERROR.

Referenced by jami::ConversationModule::onFileChannelRequest(), and jami::IncomingFile::process().

Here is the call graph for this function:

sha3sum() [1/2]

std::string jami::fileutils::sha3sum

(

const std::vector< uint8_t > &

buffer

)

sha3sum() [2/2]

std::string jami::fileutils::sha3sum	(	const uint8_t *	data,
		size_t	size
	)

Definition at line 808 of file fileutils.cpp.

References jami::emitSignal(), and size().

Here is the call graph for this function:

size()

int64_t jami::fileutils::size

(

const std::filesystem::path &

path

)

Definition at line 756 of file fileutils.cpp.

References jami::emitSignal(), and size().

Referenced by loadTextFile(), sha3sum(), and size().

Here is the call graph for this function:

writeArchive()

bool jami::fileutils::writeArchive	(	const std::string &	archive_str,
		const std::filesystem::path &	path,
		std::string_view	scheme,
		const std::string &	password,
		const std::vector< uint8_t > &	password_salt
	)

Definition at line 425 of file fileutils.cpp.

References ARCHIVE_AUTH_SCHEME_KEY, ARCHIVE_AUTH_SCHEME_NONE, ARCHIVE_AUTH_SCHEME_PASSWORD, jami::archiver::compress(), jami::archiver::compressGzip(), jami::base64::decode(), jami::emitSignal(), JAMI_ERROR, JAMI_LOG, JAMI_WARNING, and saveFile().

Referenced by jami::AccountArchive::save().

Here is the call graph for this function:

Variable Documentation

ARCHIVE_AUTH_SCHEME_KEY

constexpr auto jami::fileutils::ARCHIVE_AUTH_SCHEME_KEY = "key"sv

staticconstexpr

Definition at line 126 of file fileutils.h.

Referenced by readArchive(), and writeArchive().

ARCHIVE_AUTH_SCHEME_NONE

constexpr auto jami::fileutils::ARCHIVE_AUTH_SCHEME_NONE = ""sv

staticconstexpr

Definition at line 124 of file fileutils.h.

Referenced by writeArchive().

ARCHIVE_AUTH_SCHEME_PASSWORD

constexpr auto jami::fileutils::ARCHIVE_AUTH_SCHEME_PASSWORD = "password"sv

staticconstexpr

Definition at line 125 of file fileutils.h.

Referenced by readArchive(), and writeArchive().

resource_dir_path

std::filesystem::path jami::fileutils::resource_dir_path

static

Definition at line 123 of file fileutils.cpp.

Referenced by get_resource_dir_path(), and set_resource_dir_path().