mirror of
https://github.com/oxen-io/oxen-core.git
synced 2023-12-14 02:22:56 +01:00
143 lines
4.2 KiB
C++
143 lines
4.2 KiB
C++
// Copyright (c) 2018-2020, The Loki Project
|
|
// Copyright (c) 2014-2019, The Monero Project
|
|
//
|
|
// All rights reserved.
|
|
//
|
|
// Redistribution and use in source and binary forms, with or without modification, are
|
|
// permitted provided that the following conditions are met:
|
|
//
|
|
// 1. Redistributions of source code must retain the above copyright notice, this list of
|
|
// conditions and the following disclaimer.
|
|
//
|
|
// 2. Redistributions in binary form must reproduce the above copyright notice, this list
|
|
// of conditions and the following disclaimer in the documentation and/or other
|
|
// materials provided with the distribution.
|
|
//
|
|
// 3. Neither the name of the copyright holder nor the names of its contributors may be
|
|
// used to endorse or promote products derived from this software without specific
|
|
// prior written permission.
|
|
//
|
|
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
|
|
// EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
|
// MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
|
|
// THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
|
// PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
|
// STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
|
|
// THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
//
|
|
// Parts of this file are originally copyright (c) 2012-2013 The Cryptonote developers
|
|
//
|
|
#pragma once
|
|
|
|
#include <string>
|
|
#include <cstdio>
|
|
#include <memory>
|
|
#include <optional>
|
|
#include <system_error>
|
|
#include "fs.h"
|
|
|
|
#ifdef _WIN32
|
|
#include "windows.h"
|
|
#endif
|
|
|
|
|
|
/**
|
|
* Various utilities for dealing with files/directories.
|
|
*/
|
|
|
|
namespace tools {
|
|
|
|
//! Functional class for closing C file handles.
|
|
struct close_file
|
|
{
|
|
void operator()(std::FILE* handle) const noexcept
|
|
{
|
|
if (handle)
|
|
{
|
|
std::fclose(handle);
|
|
}
|
|
}
|
|
};
|
|
|
|
//! A file restricted to process owner AND process. Deletes file on destruction.
|
|
class private_file {
|
|
std::unique_ptr<std::FILE, close_file> m_handle;
|
|
fs::path m_filename;
|
|
|
|
private_file(std::FILE* handle, fs::path filename) noexcept;
|
|
public:
|
|
|
|
//! `handle() == nullptr && filename.empty()`.
|
|
private_file() noexcept;
|
|
|
|
/*! \return File only readable by owner and only used by this process
|
|
OR `private_file{}` on error. */
|
|
static private_file create(fs::path filename);
|
|
|
|
private_file(private_file&&) = default;
|
|
private_file& operator=(private_file&&) = default;
|
|
|
|
//! Deletes `filename()` and closes `handle()`.
|
|
~private_file() noexcept;
|
|
|
|
std::FILE* handle() const noexcept { return m_handle.get(); }
|
|
const fs::path& filename() const noexcept { return m_filename; }
|
|
};
|
|
|
|
class file_locker
|
|
{
|
|
public:
|
|
file_locker(const fs::path& filename);
|
|
~file_locker();
|
|
bool locked() const;
|
|
private:
|
|
#ifdef WIN32
|
|
HANDLE m_fd;
|
|
#else
|
|
int m_fd;
|
|
#endif
|
|
};
|
|
|
|
/*! \brief Returns the default data directory.
|
|
*
|
|
* \details Windows < Vista: C:\\Documents and Settings\\Username\\Application Data\\CRYPTONOTE_NAME
|
|
*
|
|
* Windows >= Vista: C:\\Users\\Username\\AppData\\Roaming\\CRYPTONOTE_NAME
|
|
*
|
|
* Mac: ~/Library/Application Support/CRYPTONOTE_NAME
|
|
*
|
|
* Unix: ~/.CRYPTONOTE_NAME
|
|
*/
|
|
fs::path get_default_data_dir();
|
|
|
|
#ifdef WIN32
|
|
/**
|
|
* @brief
|
|
*
|
|
* @param nfolder
|
|
* @param iscreate
|
|
*
|
|
* @return
|
|
*/
|
|
fs::path get_special_folder_path(int nfolder, bool iscreate);
|
|
#endif
|
|
|
|
/*! \brief creates directories for a path
|
|
*
|
|
* wrapper around fs::create_directories.
|
|
*/
|
|
bool create_directories_if_necessary(const fs::path& path);
|
|
|
|
void set_strict_default_file_permissions(bool strict);
|
|
|
|
void closefrom(int fd);
|
|
|
|
/// Reads a (binary) file from disk into the string `contents`.
|
|
bool slurp_file(const fs::path& filename, std::string& contents);
|
|
|
|
/// Dumps (binary) string contents to disk. The file is overwritten if it already exists.
|
|
bool dump_file(const fs::path& filename, std::string_view contents);
|
|
|
|
}
|