mirror of
https://github.com/matrix-construct/construct
synced 2024-08-16 22:54:41 +02:00
This is to not force string conversions in callerspace. Right now everything gets converted to std::string internally but eventually string_view may be preferable. Either way the overload finds the best behavior for now.
112 lines
3.8 KiB
C++
112 lines
3.8 KiB
C++
/*
|
|
* Copyright (C) 2016 Charybdis Development Team
|
|
* Copyright (C) 2016 Jason Volk <jason@zemos.net>
|
|
*
|
|
* Permission to use, copy, modify, and/or distribute this software for any
|
|
* purpose with or without fee is hereby granted, provided that the above
|
|
* copyright notice and this permission notice is present in all copies.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 AUTHOR 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.
|
|
*/
|
|
|
|
#pragma once
|
|
#define HAVE_IRCD_FS_H
|
|
|
|
/*
|
|
* Directory paths and filenames for UNIX systems.
|
|
* IRCD_PREFIX is set using ./configure --prefix, see INSTALL.
|
|
* Do not change these without corresponding changes in the build system.
|
|
*
|
|
* IRCD_PREFIX = prefix for all directories,
|
|
* DPATH = root directory of installation,
|
|
* BINPATH = directory for binary files,
|
|
* ETCPATH = directory for configuration files,
|
|
* LOGPATH = directory for logfiles,
|
|
* MODPATH = directory for modules,
|
|
* AUTOMODPATH = directory for autoloaded modules
|
|
*/
|
|
|
|
/// Tools for working with the local filesystem.
|
|
///
|
|
/// IRCd has wrapped operations for the local filesystem to maintain a
|
|
/// cross-platform implementation of asynchronous file IO in conjunction with
|
|
/// the ircd::ctx userspace context system. These operations will yield your
|
|
/// ircd::ctx when necessary to not block the event loop on the main thread
|
|
/// during IOs.
|
|
namespace ircd::fs
|
|
{
|
|
IRCD_EXCEPTION(ircd::error, error)
|
|
IRCD_EXCEPTION(error, filesystem_error)
|
|
|
|
constexpr auto DPATH = IRCD_PREFIX;
|
|
constexpr auto BINPATH = IRCD_PREFIX "/bin";
|
|
constexpr auto ETCPATH = RB_ETC_DIR;
|
|
constexpr auto LOGPATH = RB_LOG_DIR;
|
|
constexpr auto MODPATH = RB_MODULE_DIR;
|
|
constexpr auto CPATH = RB_ETC_DIR "/ircd.conf"; // ircd.conf file
|
|
constexpr auto SPATH = RB_BIN_DIR "/" BRANDING_NAME; // ircd executable
|
|
constexpr auto DBPATH = PKGLOCALSTATEDIR "/db"; // database prefix
|
|
|
|
// Below are the elements for default paths.
|
|
enum index
|
|
{
|
|
PREFIX,
|
|
BIN,
|
|
ETC,
|
|
LOG,
|
|
LIBEXEC,
|
|
MODULES,
|
|
IRCD_CONF,
|
|
IRCD_EXEC,
|
|
DB,
|
|
|
|
_NUM_
|
|
};
|
|
|
|
const char *get(index) noexcept;
|
|
const char *name(index) noexcept;
|
|
|
|
std::string make_path(const std::initializer_list<std::string> &);
|
|
|
|
bool exists(const std::string &path);
|
|
bool is_dir(const std::string &path);
|
|
bool is_reg(const std::string &path);
|
|
|
|
size_t size(const std::string &path);
|
|
size_t size(const string_view &path);
|
|
|
|
std::vector<std::string> ls(const std::string &path);
|
|
std::vector<std::string> ls_recursive(const std::string &path);
|
|
|
|
std::string cwd();
|
|
void chdir(const std::string &path);
|
|
bool mkdir(const std::string &path);
|
|
|
|
// This suite of IO functions may yield your context.
|
|
std::string read(const std::string &name);
|
|
string_view read(const std::string &name, const mutable_raw_buffer &buf);
|
|
string_view read(const string_view &name, const mutable_raw_buffer &buf);
|
|
bool write(const std::string &name, const const_raw_buffer &buf);
|
|
bool append(const std::string &name, const const_raw_buffer &buf);
|
|
bool overwrite(const std::string &name, const const_raw_buffer &buf);
|
|
bool overwrite(const string_view &name, const const_raw_buffer &buf);
|
|
|
|
struct init;
|
|
}
|
|
|
|
struct ircd::fs::init
|
|
{
|
|
init();
|
|
~init() noexcept;
|
|
};
|