0
0
Fork 0
mirror of https://github.com/matrix-construct/construct synced 2024-08-22 09:34:45 +02:00
construct/include/ircd/fs/fs.h
2018-12-29 19:43:17 -08:00

70 lines
2.1 KiB
C++

// Matrix Construct
//
// Copyright (C) Matrix Construct Developers, Authors & Contributors
// Copyright (C) 2016-2018 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. The
// full license for this software is available in the LICENSE file.
#pragma once
#define HAVE_IRCD_FS_H
/// Local filesystem interface.
///
/// 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.
///
/// Paths are stored in the platform-specific format using plain old character
/// strings, which means you should never directly manipulate path strings to
/// maintain x-platformness; instead use the (or add more) tools provided by
/// this interface (see: path.h).
///
namespace ircd::fs
{
struct init;
struct error; // custom exception; still inherits from ircd::error
}
#include "error.h"
#include "path.h"
#include "iov.h"
#include "fd.h"
#include "aio.h"
#include "read.h"
#include "write.h"
#include "sync.h"
#include "stdin.h"
#include "support.h"
namespace ircd::fs
{
// Observers
bool exists(const string_view &path);
bool is_dir(const string_view &path);
bool is_reg(const string_view &path);
size_t size(const string_view &path);
std::vector<std::string> ls(const string_view &path);
std::vector<std::string> ls_r(const string_view &path);
// Modifiers
bool rename(std::nothrow_t, const string_view &old, const string_view &new_);
bool rename(const string_view &old, const string_view &new_);
bool remove(std::nothrow_t, const string_view &path);
bool remove(const string_view &path);
bool mkdir(const string_view &path);
}
/// Filesystem interface init / fini held by ircd::main().
struct ircd::fs::init
{
aio::init _aio_;
init();
~init() noexcept;
};