124 lines
4.4 KiB
C++
124 lines
4.4 KiB
C++
/*
|
|
|
|
Copyright (c) 2003-2016, Arvid Norberg
|
|
All rights reserved.
|
|
|
|
Redistribution and use in source and binary forms, with or without
|
|
modification, are permitted provided that the following conditions
|
|
are met:
|
|
|
|
* Redistributions of source code must retain the above copyright
|
|
notice, this list of conditions and the following disclaimer.
|
|
* 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.
|
|
* Neither the name of the author 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 OWNER 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.
|
|
|
|
*/
|
|
|
|
#ifndef TORRENT_STORAGE_DEFS_HPP_INCLUDE
|
|
#define TORRENT_STORAGE_DEFS_HPP_INCLUDE
|
|
|
|
#include "libtorrent/config.hpp"
|
|
#include "libtorrent/units.hpp"
|
|
#include "libtorrent/aux_/vector.hpp"
|
|
#include <functional>
|
|
#include <string>
|
|
|
|
namespace libtorrent
|
|
{
|
|
struct TORRENT_EXPORT storage_interface;
|
|
class file_storage;
|
|
struct file_pool;
|
|
class torrent_info;
|
|
|
|
struct storage_index_tag_t {};
|
|
using storage_index_t = aux::strong_typedef<std::uint32_t, storage_index_tag_t>;
|
|
|
|
// types of storage allocation used for add_torrent_params::storage_mode.
|
|
enum storage_mode_t
|
|
{
|
|
// All pieces will be written to their final position, all files will be
|
|
// allocated in full when the torrent is first started. This is done with
|
|
// ``fallocate()`` and similar calls. This mode minimizes fragmentation.
|
|
storage_mode_allocate,
|
|
|
|
// All pieces will be written to the place where they belong and sparse files
|
|
// will be used. This is the recommended, and default mode.
|
|
storage_mode_sparse
|
|
};
|
|
|
|
enum class status_t : std::uint8_t
|
|
{
|
|
// return values from check_fastresume, and move_storage
|
|
no_error,
|
|
fatal_disk_error,
|
|
need_full_check,
|
|
file_exist
|
|
};
|
|
|
|
// flags for async_move_storage
|
|
enum move_flags_t
|
|
{
|
|
// replace any files in the destination when copying
|
|
// or moving the storage
|
|
always_replace_files,
|
|
|
|
// if any files that we want to copy exist in the destination
|
|
// exist, fail the whole operation and don't perform
|
|
// any copy or move. There is an inherent race condition
|
|
// in this mode. The files are checked for existence before
|
|
// the operation starts. In between the check and performing
|
|
// the copy, the destination files may be created, in which
|
|
// case they are replaced.
|
|
fail_if_exist,
|
|
|
|
// if any file exist in the target, take those files instead
|
|
// of the ones we may have in the source.
|
|
dont_replace
|
|
};
|
|
|
|
// see default_storage::default_storage()
|
|
struct TORRENT_EXPORT storage_params
|
|
{
|
|
storage_params(): files(nullptr), mapped_files(nullptr), pool(nullptr)
|
|
, mode(storage_mode_sparse), priorities(nullptr), info(nullptr) {}
|
|
file_storage const* files;
|
|
file_storage const* mapped_files; // optional
|
|
std::string path;
|
|
file_pool* pool;
|
|
storage_mode_t mode;
|
|
aux::vector<std::uint8_t, file_index_t> const* priorities; // optional
|
|
torrent_info const* info; // optional
|
|
};
|
|
|
|
using storage_constructor_type = std::function<storage_interface*(storage_params const& params)>;
|
|
|
|
// the constructor function for the regular file storage. This is the
|
|
// default value for add_torrent_params::storage.
|
|
TORRENT_EXPORT storage_interface* default_storage_constructor(storage_params const&);
|
|
|
|
// the constructor function for the disabled storage. This can be used for
|
|
// testing and benchmarking. It will throw away any data written to
|
|
// it and return garbage for anything read from it.
|
|
TORRENT_EXPORT storage_interface* disabled_storage_constructor(storage_params const&);
|
|
|
|
TORRENT_EXPORT storage_interface* zero_storage_constructor(storage_params const&);
|
|
}
|
|
|
|
#endif
|