613 lines
23 KiB
C++
613 lines
23 KiB
C++
/*
|
|
|
|
Copyright (c) 2003-2014, 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_FILE_STORAGE_HPP_INCLUDED
|
|
#define TORRENT_FILE_STORAGE_HPP_INCLUDED
|
|
|
|
#include <string>
|
|
#include <vector>
|
|
#include <ctime>
|
|
#include <boost/cstdint.hpp>
|
|
|
|
#include "libtorrent/assert.hpp"
|
|
#include "libtorrent/peer_request.hpp"
|
|
#include "libtorrent/peer_id.hpp"
|
|
|
|
namespace libtorrent
|
|
{
|
|
struct file;
|
|
|
|
#ifndef TORRENT_NO_DEPRECATE
|
|
// information about a file in a file_storage
|
|
struct TORRENT_EXPORT file_entry
|
|
{
|
|
// hidden
|
|
file_entry();
|
|
// hidden
|
|
~file_entry();
|
|
|
|
// the full path of this file. The paths are unicode strings
|
|
// encoded in UTF-8.
|
|
std::string path;
|
|
|
|
// the path which this is a symlink to, or empty if this is
|
|
// not a symlink. This field is only used if the ``symlink_attribute`` is set.
|
|
std::string symlink_path;
|
|
|
|
// the offset of this file inside the torrent
|
|
boost::int64_t offset;
|
|
|
|
// the size of the file (in bytes) and ``offset`` is the byte offset
|
|
// of the file within the torrent. i.e. the sum of all the sizes of the files
|
|
// before it in the list.
|
|
boost::int64_t size;
|
|
|
|
// the offset in the file where the storage should start. The normal
|
|
// case is to have this set to 0, so that the storage starts saving data at the start
|
|
// if the file. In cases where multiple files are mapped into the same file though,
|
|
// the ``file_base`` should be set to an offset so that the different regions do
|
|
// not overlap. This is used when mapping "unselected" files into a so-called part
|
|
// file.
|
|
boost::int64_t file_base;
|
|
|
|
// the modification time of this file specified in posix time.
|
|
std::time_t mtime;
|
|
|
|
// a sha-1 hash of the content of the file, or zeroes, if no
|
|
// file hash was present in the torrent file. It can be used to potentially
|
|
// find alternative sources for the file.
|
|
sha1_hash filehash;
|
|
|
|
// set to true for files that are not part of the data of the torrent.
|
|
// They are just there to make sure the next file is aligned to a particular byte offset
|
|
// or piece boundry. These files should typically be hidden from an end user. They are
|
|
// not written to disk.
|
|
bool pad_file:1;
|
|
|
|
// true if the file was marked as hidden (on windows).
|
|
bool hidden_attribute:1;
|
|
|
|
// true if the file was marked as executable (posix)
|
|
bool executable_attribute:1;
|
|
|
|
// true if the file was a symlink. If this is the case
|
|
// the ``symlink_index`` refers to a string which specifies the original location
|
|
// where the data for this file was found.
|
|
bool symlink_attribute:1;
|
|
};
|
|
#endif // TORRENT_NO_DEPRECATE
|
|
|
|
// internal
|
|
struct TORRENT_DEPRECATED_EXPORT internal_file_entry
|
|
{
|
|
friend class file_storage;
|
|
#ifdef TORRENT_DEBUG
|
|
// for torrent_info::invariant_check
|
|
friend class torrent_info;
|
|
#endif
|
|
|
|
internal_file_entry()
|
|
: offset(0)
|
|
, symlink_index(not_a_symlink)
|
|
, no_root_dir(false)
|
|
, size(0)
|
|
, name_len(name_is_owned)
|
|
, pad_file(false)
|
|
, hidden_attribute(false)
|
|
, executable_attribute(false)
|
|
, symlink_attribute(false)
|
|
, name(NULL)
|
|
, path_index(-1)
|
|
{}
|
|
|
|
internal_file_entry(internal_file_entry const& fe);
|
|
internal_file_entry& operator=(internal_file_entry const& fe);
|
|
|
|
~internal_file_entry();
|
|
|
|
void set_name(char const* n, bool borrow_string = false, int string_len = 0);
|
|
std::string filename() const;
|
|
char const* filename_ptr() const { return name; }
|
|
int filename_len() const { return name_len == name_is_owned?strlen(name):name_len; }
|
|
|
|
enum {
|
|
name_is_owned = (1<<12)-1,
|
|
not_a_symlink = (1<<15)-1
|
|
};
|
|
|
|
// the offset of this file inside the torrent
|
|
boost::uint64_t offset:48;
|
|
|
|
// index into file_storage::m_symlinks or not_a_symlink
|
|
// if this is not a symlink
|
|
boost::uint64_t symlink_index:15;
|
|
|
|
// if this is true, don't include m_name as part of the
|
|
// path to this file
|
|
boost::uint64_t no_root_dir:1;
|
|
|
|
// the size of this file
|
|
boost::uint64_t size:48;
|
|
|
|
// the number of characters in the name. If this is
|
|
// name_is_owned, name is null terminated and owned by this object
|
|
// (i.e. it should be freed in the destructor). If
|
|
// the len is not name_is_owned, the name pointer doesn not belong
|
|
// to this object, and it's not null terminated
|
|
boost::uint64_t name_len:12;
|
|
boost::uint64_t pad_file:1;
|
|
boost::uint64_t hidden_attribute:1;
|
|
boost::uint64_t executable_attribute:1;
|
|
boost::uint64_t symlink_attribute:1;
|
|
|
|
// make it available for logging
|
|
private:
|
|
// This string is not necessarily null terminated!
|
|
// that's why it's private, to keep people away from it
|
|
char const* name;
|
|
public:
|
|
|
|
// the index into file_storage::m_paths. To get
|
|
// the full path to this file, concatenate the path
|
|
// from that array with the 'name' field in
|
|
// this struct
|
|
// values for path_index include:
|
|
// -1 means no path (i.e. single file torrent)
|
|
// -2, it means the filename
|
|
// in this field contains the full, absolute path
|
|
// to the file
|
|
int path_index;
|
|
};
|
|
|
|
// represents a window of a file in a torrent.
|
|
//
|
|
// The ``file_index`` refers to the index of the file (in the torrent_info).
|
|
// To get the path and filename, use ``file_at()`` and give the ``file_index``
|
|
// as argument. The ``offset`` is the byte offset in the file where the range
|
|
// starts, and ``size`` is the number of bytes this range is. The size + offset
|
|
// will never be greater than the file size.
|
|
struct TORRENT_EXPORT file_slice
|
|
{
|
|
// the index of the file
|
|
int file_index;
|
|
|
|
// the offset from the start of the file, in bytes
|
|
boost::int64_t offset;
|
|
|
|
// the size of the window, in bytes
|
|
boost::int64_t size;
|
|
};
|
|
|
|
// The ``file_storage`` class represents a file list and the piece
|
|
// size. Everything necessary to interpret a regular bittorrent storage
|
|
// file structure.
|
|
class TORRENT_EXPORT file_storage
|
|
{
|
|
friend class torrent_info;
|
|
public:
|
|
// hidden
|
|
file_storage();
|
|
// hidden
|
|
~file_storage();
|
|
|
|
// returns true if the piece length has been initialized
|
|
// on the file_storage. This is typically taken as a proxy
|
|
// of whether the file_storage as a whole is initialized or
|
|
// not.
|
|
bool is_valid() const { return m_piece_length > 0; }
|
|
|
|
// file attribute flags
|
|
enum flags_t
|
|
{
|
|
// the file is a pad file. It's required to contain zeroes
|
|
// at it will not be saved to disk. Its purpose is to make
|
|
// the following file start on a piece boundary.
|
|
pad_file = 1,
|
|
|
|
// this file has the hidden attribute set. This is primarily
|
|
// a windows attribute
|
|
attribute_hidden = 2,
|
|
|
|
// this file has the executable attribute set.
|
|
attribute_executable = 4,
|
|
|
|
// this file is a symbilic link. It should have a link
|
|
// target string associated with it.
|
|
attribute_symlink = 8
|
|
};
|
|
|
|
// allocates space for ``num_files`` in the internal file list. This can
|
|
// be used to avoid reallocating the internal file list when the number
|
|
// of files to be added is known up-front.
|
|
void reserve(int num_files);
|
|
|
|
// Adds a file to the file storage. The ``add_file_borrow`` version
|
|
// expects that ``filename`` points to a string of ``filename_len``
|
|
// bytes that is the file name (without a path) of the file that's
|
|
// being added. This memory is *borrowed*, i.e. it is the caller's
|
|
// responsibility to make sure it stays valid throughout the lifetime
|
|
// of this file_storage object or any copy of it. The same thing applies
|
|
// to ``filehash``, wich is an optional pointer to a 20 byte binary
|
|
// SHA-1 hash of the file.
|
|
//
|
|
// if ``filename`` is NULL, the filename from ``path`` is used and not
|
|
// borrowed. In this case ``filename_len`` is ignored.
|
|
//
|
|
// The ``path`` argument is the full path (in the torrent file) to
|
|
// the file to add. Note that this is not supposed to be an absolute
|
|
// path, but it is expected to include the name of the torrent as the
|
|
// first path element.
|
|
//
|
|
// ``file_size`` is the size of the file in bytes.
|
|
//
|
|
// The ``file_flags`` argument sets attributes on the file. The file
|
|
// attributes is an extension and may not work in all bittorrent clients.
|
|
//
|
|
// For possible file attributes, see file_storage::flags_t.
|
|
//
|
|
// The ``mtime`` argument is optional and can be set to 0. If non-zero,
|
|
// it is the posix time of the last modification time of this file.
|
|
//
|
|
// ``symlink_path`` is the path the file is a symlink to. To make this a
|
|
// symlink you also need to set the file_storage::flag_symlink file flag.
|
|
//
|
|
// If more files than one are added, certain restrictions to their paths
|
|
// apply. In a multi-file file storage (torrent), all files must share
|
|
// the same root directory.
|
|
//
|
|
// That is, the first path element of all files must be the same.
|
|
// This shared path element is also set to the name of the torrent. It
|
|
// can be changed by calling ``set_name``.
|
|
void add_file_borrow(char const* filename, int filename_len
|
|
, std::string const& path, boost::int64_t file_size
|
|
, boost::uint32_t file_flags = 0, char const* filehash = 0
|
|
, boost::int64_t mtime = 0, std::string const& symlink_path = "");
|
|
void add_file(std::string const& path, boost::int64_t file_size, int file_flags = 0
|
|
, std::time_t mtime = 0, std::string const& symlink_path = "");
|
|
|
|
// renames the file at ``index`` to ``new_filename``. Keep in mind
|
|
// that filenames are expected to be UTF-8 encoded.
|
|
void rename_file(int index, std::string const& new_filename);
|
|
|
|
#ifndef TORRENT_NO_DEPRECATE
|
|
TORRENT_DEPRECATED_PREFIX
|
|
void add_file(file_entry const& fe, char const* infohash = NULL) TORRENT_DEPRECATED;
|
|
|
|
#if TORRENT_USE_WSTRING
|
|
// all wstring APIs are deprecated since 0.16.11
|
|
// instead, use the wchar -> utf8 conversion functions
|
|
// and pass in utf8 strings
|
|
TORRENT_DEPRECATED_PREFIX
|
|
void add_file(std::wstring const& p, boost::int64_t size, int flags = 0
|
|
, std::time_t mtime = 0, std::string const& s_p = "") TORRENT_DEPRECATED;
|
|
TORRENT_DEPRECATED_PREFIX
|
|
void rename_file(int index, std::wstring const& new_filename) TORRENT_DEPRECATED;
|
|
TORRENT_DEPRECATED_PREFIX
|
|
void set_name(std::wstring const& n) TORRENT_DEPRECATED;
|
|
|
|
void rename_file_deprecated(int index, std::wstring const& new_filename);
|
|
#endif // TORRENT_USE_WSTRING
|
|
#endif // TORRENT_NO_DEPRECATE
|
|
|
|
// returns a list of file_slice objects representing the portions of
|
|
// files the specified piece index, byte offset and size range overlaps.
|
|
// this is the inverse mapping of map_file().
|
|
std::vector<file_slice> map_block(int piece, boost::int64_t offset
|
|
, int size) const;
|
|
|
|
// returns a peer_request representing the piece index, byte offset
|
|
// and size the specified file range overlaps. This is the inverse
|
|
// mapping ove map_block().
|
|
peer_request map_file(int file, boost::int64_t offset, int size) const;
|
|
|
|
#ifndef TORRENT_NO_DEPRECATE
|
|
// all functions depending on internal_file_entry
|
|
// were deprecated in 1.0. Use the variants that take an
|
|
// index instead
|
|
typedef std::vector<internal_file_entry>::const_iterator iterator;
|
|
typedef std::vector<internal_file_entry>::const_reverse_iterator reverse_iterator;
|
|
|
|
TORRENT_DEPRECATED_PREFIX
|
|
iterator file_at_offset(boost::int64_t offset) const TORRENT_DEPRECATED;
|
|
TORRENT_DEPRECATED_PREFIX
|
|
iterator begin() const TORRENT_DEPRECATED { return m_files.begin(); }
|
|
TORRENT_DEPRECATED_PREFIX
|
|
iterator end() const TORRENT_DEPRECATED { return m_files.end(); }
|
|
TORRENT_DEPRECATED_PREFIX
|
|
reverse_iterator rbegin() const TORRENT_DEPRECATED { return m_files.rbegin(); }
|
|
TORRENT_DEPRECATED_PREFIX
|
|
reverse_iterator rend() const TORRENT_DEPRECATED { return m_files.rend(); }
|
|
TORRENT_DEPRECATED_PREFIX
|
|
internal_file_entry const& internal_at(int index) const TORRENT_DEPRECATED
|
|
{
|
|
TORRENT_ASSERT(index >= 0);
|
|
TORRENT_ASSERT(index < int(m_files.size()));
|
|
return m_files[index];
|
|
}
|
|
TORRENT_DEPRECATED_PREFIX
|
|
file_entry at(iterator i) const TORRENT_DEPRECATED;
|
|
|
|
// returns a file_entry with information about the file
|
|
// at ``index``. Index must be in the range [0, ``num_files()`` ).
|
|
TORRENT_DEPRECATED_PREFIX
|
|
file_entry at(int index) const TORRENT_DEPRECATED;
|
|
|
|
iterator begin_deprecated() const { return m_files.begin(); }
|
|
iterator end_deprecated() const { return m_files.end(); }
|
|
reverse_iterator rbegin_deprecated() const { return m_files.rbegin(); }
|
|
reverse_iterator rend_deprecated() const { return m_files.rend(); }
|
|
iterator file_at_offset_deprecated(boost::int64_t offset) const;
|
|
#endif // TORRENT_NO_DEPRECATE
|
|
|
|
// returns the number of files in the file_storage
|
|
int num_files() const
|
|
{ return int(m_files.size()); }
|
|
|
|
// returns the total number of bytes all the files in this torrent spans
|
|
boost::int64_t total_size() const { return m_total_size; }
|
|
|
|
// set and get the number of pieces in the torrent
|
|
void set_num_pieces(int n) { m_num_pieces = n; }
|
|
int num_pieces() const { TORRENT_ASSERT(m_piece_length > 0); return m_num_pieces; }
|
|
|
|
// set and get the size of each piece in this torrent. This size is typically an even power
|
|
// of 2. It doesn't have to be though. It should be divisible by 16kiB however.
|
|
void set_piece_length(int l) { m_piece_length = l; }
|
|
int piece_length() const { TORRENT_ASSERT(m_piece_length > 0); return m_piece_length; }
|
|
|
|
// returns the piece size of ``index``. This will be the same as piece_length(), except
|
|
// for the last piece, which may be shorter.
|
|
int piece_size(int index) const;
|
|
|
|
// set and get the name of this torrent. For multi-file torrents, this is also
|
|
// the name of the root directory all the files are stored in.
|
|
void set_name(std::string const& n) { m_name = n; }
|
|
std::string const& name() const { return m_name; }
|
|
|
|
// swap all content of *this* with *ti*.
|
|
void swap(file_storage& ti)
|
|
{
|
|
using std::swap;
|
|
swap(ti.m_files, m_files);
|
|
swap(ti.m_num_files, m_num_files);
|
|
swap(ti.m_file_hashes, m_file_hashes);
|
|
swap(ti.m_symlinks, m_symlinks);
|
|
swap(ti.m_mtime, m_mtime);
|
|
#ifndef TORRENT_NO_DEPRECATE
|
|
swap(ti.m_file_base, m_file_base);
|
|
#endif
|
|
swap(ti.m_paths, m_paths);
|
|
swap(ti.m_name, m_name);
|
|
swap(ti.m_total_size, m_total_size);
|
|
swap(ti.m_num_pieces, m_num_pieces);
|
|
swap(ti.m_piece_length, m_piece_length);
|
|
}
|
|
|
|
// deallocates most of the memory used by this
|
|
// instance, leaving it only partially usable
|
|
void unload();
|
|
|
|
// returns true when populated with at least one file
|
|
bool is_loaded() const { return !m_files.empty(); }
|
|
|
|
// if pad_file_limit >= 0, files larger than that limit will be padded,
|
|
// default is to not add any padding (-1). The alignment specifies the
|
|
// alignment files should be padded to. This defaults to the piece size
|
|
// (-1) but it may also make sense to set it to 16 kiB, or something
|
|
// divisible by 16 kiB.
|
|
// If pad_file_limit is 0, every file will be padded (except empty ones).
|
|
void optimize(int pad_file_limit = -1, int alignment = -1);
|
|
|
|
// These functions are used to query attributes of files at
|
|
// a given index.
|
|
//
|
|
// The ``hash()`` is a sha-1 hash of the file, or 0 if none was
|
|
// provided in the torrent file. This can potentially be used to
|
|
// join a bittorrent network with other file sharing networks.
|
|
//
|
|
// The ``mtime()`` is the modification time is the posix
|
|
// time when a file was last modified when the torrent
|
|
// was created, or 0 if it was not included in the torrent file.
|
|
//
|
|
// ``file_path()`` returns the full path to a file.
|
|
//
|
|
// ``file_size()`` returns the size of a file.
|
|
//
|
|
// ``pad_file_at()`` returns true if the file at the given
|
|
// index is a pad-file.
|
|
//
|
|
// ``file_name()`` returns *just* the name of the file, whereas
|
|
// ``file_path()`` returns the path (inside the torrent file) with
|
|
// the filename appended.
|
|
//
|
|
// ``file_offset()`` returns the byte offset within the torrent file
|
|
// where this file starts. It can be used to map the file to a piece
|
|
// index (given the piece size).
|
|
sha1_hash hash(int index) const;
|
|
std::string const& symlink(int index) const;
|
|
time_t mtime(int index) const;
|
|
std::string file_path(int index, std::string const& save_path = "") const;
|
|
std::string file_name(int index) const;
|
|
boost::int64_t file_size(int index) const;
|
|
bool pad_file_at(int index) const;
|
|
boost::int64_t file_offset(int index) const;
|
|
|
|
// returns the crc32 hash of file_path(index)
|
|
boost::uint32_t file_path_hash(int index, std::string const& save_path) const;
|
|
|
|
// returns the crc32 hash of the path at index. Note, this index does not
|
|
// refer to a file, but to a path in the vector returned by paths().
|
|
boost::uint32_t path_hash(int index, std::string const& save_path) const;
|
|
|
|
// flags indicating various attributes for files in
|
|
// a file_storage.
|
|
enum file_flags_t
|
|
{
|
|
// this file is a pad file. The creator of the
|
|
// torrent promises the file is entirely filled with
|
|
// zeroes and does not need to be downloaded. The
|
|
// purpose is just to align the next file to either
|
|
// a block or piece boundary.
|
|
flag_pad_file = 1,
|
|
|
|
// this file is hiddent (sets the hidden attribute
|
|
// on windows)
|
|
flag_hidden = 2,
|
|
|
|
// this file is executable (sets the executable bit
|
|
// on posix like systems)
|
|
flag_executable = 4,
|
|
|
|
// this file is a symlink. The symlink target is
|
|
// specified in a separate field
|
|
flag_symlink = 8
|
|
};
|
|
|
|
std::vector<std::string> const& paths() const { return m_paths; }
|
|
|
|
// returns a bitmask of flags from file_flags_t that apply
|
|
// to file at ``index``.
|
|
int file_flags(int index) const;
|
|
|
|
// returns the index of the file at the given offset in the torrent
|
|
int file_index_at_offset(boost::int64_t offset) const;
|
|
|
|
// low-level function. returns a pointer to the internal storage for
|
|
// the filename. This string may not be null terinated!
|
|
// the ``file_name_len()`` function returns the length of the filename.
|
|
char const* file_name_ptr(int index) const;
|
|
int file_name_len(int index) const;
|
|
|
|
#ifndef TORRENT_NO_DEPRECATE
|
|
// deprecated in 1.1
|
|
TORRENT_DEPRECATED_PREFIX
|
|
boost::int64_t file_base(int index) const TORRENT_DEPRECATED;
|
|
TORRENT_DEPRECATED_PREFIX
|
|
void set_file_base(int index, boost::int64_t off) TORRENT_DEPRECATED;
|
|
|
|
// these were deprecated in 1.0. Use the versions that take an index instead
|
|
TORRENT_DEPRECATED_PREFIX
|
|
sha1_hash hash(internal_file_entry const& fe) const TORRENT_DEPRECATED;
|
|
TORRENT_DEPRECATED_PREFIX
|
|
std::string const& symlink(internal_file_entry const& fe) const TORRENT_DEPRECATED;
|
|
TORRENT_DEPRECATED_PREFIX
|
|
time_t mtime(internal_file_entry const& fe) const TORRENT_DEPRECATED;
|
|
TORRENT_DEPRECATED_PREFIX
|
|
int file_index(internal_file_entry const& fe) const TORRENT_DEPRECATED;
|
|
TORRENT_DEPRECATED_PREFIX
|
|
boost::int64_t file_base(internal_file_entry const& fe) const TORRENT_DEPRECATED;
|
|
TORRENT_DEPRECATED_PREFIX
|
|
void set_file_base(internal_file_entry const& fe, boost::int64_t off) TORRENT_DEPRECATED;
|
|
TORRENT_DEPRECATED_PREFIX
|
|
std::string file_path(internal_file_entry const& fe, std::string const& save_path = "") const TORRENT_DEPRECATED;
|
|
TORRENT_DEPRECATED_PREFIX
|
|
std::string file_name(internal_file_entry const& fe) const TORRENT_DEPRECATED;
|
|
TORRENT_DEPRECATED_PREFIX
|
|
boost::int64_t file_size(internal_file_entry const& fe) const TORRENT_DEPRECATED;
|
|
TORRENT_DEPRECATED_PREFIX
|
|
bool pad_file_at(internal_file_entry const& fe) const TORRENT_DEPRECATED;
|
|
TORRENT_DEPRECATED_PREFIX
|
|
boost::int64_t file_offset(internal_file_entry const& fe) const TORRENT_DEPRECATED;
|
|
#endif
|
|
|
|
// if the backing buffer changed for this storage, this is the pointer
|
|
// offset to add to any pointers to make them point into the new buffer
|
|
void apply_pointer_offset(ptrdiff_t off);
|
|
|
|
private:
|
|
|
|
// the number of bytes in a regular piece
|
|
// (i.e. not the potentially truncated last piece)
|
|
int m_piece_length;
|
|
|
|
// the number of pieces in the torrent
|
|
int m_num_pieces;
|
|
|
|
void update_path_index(internal_file_entry& e, std::string const& path
|
|
, bool set_name = true);
|
|
void reorder_file(int index, int dst);
|
|
|
|
// the list of files that this torrent consists of
|
|
std::vector<internal_file_entry> m_files;
|
|
|
|
// if there are sha1 hashes for each individual file there are as many
|
|
// entries in this array as the m_files array. Each entry in m_files has
|
|
// a corresponding hash pointer in this array. The reason to split it up
|
|
// in separate arrays is to save memory in case the torrent doesn't have
|
|
// file hashes
|
|
// the pointers in this vector are pointing into the .torrent file in
|
|
// memory which is _not_ owned by this file_storage object. It's simply
|
|
// a non-owning pointer. It is the user's responsibility that the hash
|
|
// stays valid throughout the lifetime of this file_storage object.
|
|
std::vector<char const*> m_file_hashes;
|
|
|
|
// for files that are symlinks, the symlink
|
|
// path_index in the internal_file_entry indexes
|
|
// this vector of strings
|
|
std::vector<std::string> m_symlinks;
|
|
|
|
// the modification times of each file. This vector
|
|
// is empty if no file have a modification time.
|
|
// each element corresponds to the file with the same
|
|
// index in m_files
|
|
std::vector<time_t> m_mtime;
|
|
|
|
#ifndef TORRENT_NO_DEPRECATE
|
|
// if any file has a non-zero file base (i.e. multiple
|
|
// files residing in the same physical file at different
|
|
// offsets)
|
|
std::vector<boost::int64_t> m_file_base;
|
|
#endif
|
|
|
|
// all unique paths files have. The internal_file_entry::path_index
|
|
// points into this array. The paths don't include the root directory
|
|
// name for multi-file torrents. The m_name field need to be
|
|
// prepended to these paths, and the filename of a specific file
|
|
// entry appended, to form full file paths
|
|
std::vector<std::string> m_paths;
|
|
|
|
// name of torrent. For multi-file torrents
|
|
// this is always the root directory
|
|
std::string m_name;
|
|
|
|
// the sum of all filesizes
|
|
boost::int64_t m_total_size;
|
|
|
|
// the number of files. This is used when
|
|
// the torrent is unloaded
|
|
int m_num_files;
|
|
};
|
|
}
|
|
|
|
#endif // TORRENT_FILE_STORAGE_HPP_INCLUDED
|
|
|