327 lines
10 KiB
C++
327 lines
10 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_FILE_HPP_INCLUDED
|
|
#define TORRENT_FILE_HPP_INCLUDED
|
|
|
|
#include <memory>
|
|
#include <string>
|
|
#include <functional>
|
|
|
|
#include "libtorrent/config.hpp"
|
|
#include "libtorrent/string_view.hpp"
|
|
#include "libtorrent/span.hpp"
|
|
#include "libtorrent/aux_/storage_utils.hpp"
|
|
|
|
#include "libtorrent/aux_/disable_warnings_push.hpp"
|
|
|
|
#include <boost/noncopyable.hpp>
|
|
|
|
#ifdef TORRENT_WINDOWS
|
|
// windows part
|
|
#ifndef WIN32_LEAN_AND_MEAN
|
|
#define WIN32_LEAN_AND_MEAN
|
|
#endif
|
|
#include <windows.h>
|
|
#include <winioctl.h>
|
|
#include <sys/types.h>
|
|
#else
|
|
// posix part
|
|
#define _FILE_OFFSET_BITS 64
|
|
|
|
#ifndef _GNU_SOURCE
|
|
#define _GNU_SOURCE
|
|
#endif
|
|
|
|
#ifndef _XOPEN_SOURCE
|
|
#define _XOPEN_SOURCE 600
|
|
#endif
|
|
|
|
#include <unistd.h>
|
|
#include <sys/uio.h>
|
|
#include <fcntl.h>
|
|
#include <sys/types.h>
|
|
#include <dirent.h> // for DIR
|
|
|
|
#include "libtorrent/aux_/max_path.hpp" // for TORRENT_MAX_PATH
|
|
|
|
#undef _FILE_OFFSET_BITS
|
|
|
|
#endif
|
|
|
|
#include "libtorrent/aux_/disable_warnings_pop.hpp"
|
|
|
|
#include "libtorrent/error_code.hpp"
|
|
#include "libtorrent/assert.hpp"
|
|
#include "libtorrent/time.hpp"
|
|
|
|
namespace libtorrent
|
|
{
|
|
#ifdef TORRENT_WINDOWS
|
|
using handle_type = HANDLE;
|
|
#else
|
|
using handle_type = int;
|
|
#endif
|
|
|
|
struct file_status
|
|
{
|
|
std::int64_t file_size;
|
|
std::uint64_t atime;
|
|
std::uint64_t mtime;
|
|
std::uint64_t ctime;
|
|
enum {
|
|
#if defined TORRENT_WINDOWS
|
|
fifo = 0x1000, // named pipe (fifo)
|
|
character_special = 0x2000, // character special
|
|
directory = 0x4000, // directory
|
|
regular_file = 0x8000 // regular
|
|
#else
|
|
fifo = 0010000, // named pipe (fifo)
|
|
character_special = 0020000, // character special
|
|
directory = 0040000, // directory
|
|
block_special = 0060000, // block special
|
|
regular_file = 0100000, // regular
|
|
link = 0120000, // symbolic link
|
|
socket = 0140000 // socket
|
|
#endif
|
|
} modes_t;
|
|
int mode;
|
|
};
|
|
|
|
// internal flags for stat_file
|
|
enum { dont_follow_links = 1 };
|
|
TORRENT_EXTRA_EXPORT void stat_file(std::string const& f, file_status* s
|
|
, error_code& ec, int flags = 0);
|
|
TORRENT_EXTRA_EXPORT void rename(std::string const& f
|
|
, std::string const& newf, error_code& ec);
|
|
TORRENT_EXTRA_EXPORT void create_directories(std::string const& f
|
|
, error_code& ec);
|
|
TORRENT_EXTRA_EXPORT void create_directory(std::string const& f
|
|
, error_code& ec);
|
|
TORRENT_EXTRA_EXPORT void remove_all(std::string const& f
|
|
, error_code& ec);
|
|
TORRENT_EXTRA_EXPORT void remove(std::string const& f, error_code& ec);
|
|
TORRENT_EXTRA_EXPORT bool exists(std::string const& f, error_code& ec);
|
|
TORRENT_EXTRA_EXPORT bool exists(std::string const& f);
|
|
TORRENT_EXTRA_EXPORT std::int64_t file_size(std::string const& f);
|
|
TORRENT_EXTRA_EXPORT bool is_directory(std::string const& f
|
|
, error_code& ec);
|
|
TORRENT_EXTRA_EXPORT void recursive_copy(std::string const& old_path
|
|
, std::string const& new_path, error_code& ec);
|
|
TORRENT_EXTRA_EXPORT void copy_file(std::string const& f
|
|
, std::string const& newf, error_code& ec);
|
|
TORRENT_EXTRA_EXPORT void move_file(std::string const& f
|
|
, std::string const& newf, error_code& ec);
|
|
|
|
// file is expected to exist, link will be created to point to it. If hard
|
|
// links are not supported by the filesystem or OS, the file will be copied.
|
|
TORRENT_EXTRA_EXPORT void hard_link(std::string const& file
|
|
, std::string const& link, error_code& ec);
|
|
|
|
TORRENT_EXTRA_EXPORT std::string split_path(std::string const& f
|
|
, bool only_first_part = false);
|
|
TORRENT_EXTRA_EXPORT char const* next_path_element(char const* p);
|
|
TORRENT_EXTRA_EXPORT std::string extension(std::string const& f);
|
|
TORRENT_EXTRA_EXPORT std::string remove_extension(std::string const& f);
|
|
TORRENT_EXTRA_EXPORT void replace_extension(std::string& f, std::string const& ext);
|
|
TORRENT_EXTRA_EXPORT bool is_root_path(std::string const& f);
|
|
|
|
|
|
// internal used by create_torrent.hpp
|
|
TORRENT_EXTRA_EXPORT std::string parent_path(std::string const& f);
|
|
TORRENT_EXTRA_EXPORT bool has_parent_path(std::string const& f);
|
|
TORRENT_EXTRA_EXPORT char const* filename_cstr(char const* f);
|
|
|
|
// internal used by create_torrent.hpp
|
|
TORRENT_EXTRA_EXPORT std::string filename(std::string const& f);
|
|
TORRENT_EXTRA_EXPORT std::string combine_path(string_view lhs
|
|
, string_view rhs);
|
|
TORRENT_EXTRA_EXPORT void append_path(std::string& branch
|
|
, string_view leaf);
|
|
|
|
// internal used by create_torrent.hpp
|
|
TORRENT_EXTRA_EXPORT std::string complete(string_view f);
|
|
TORRENT_EXTRA_EXPORT bool is_complete(string_view f);
|
|
TORRENT_EXTRA_EXPORT std::string current_working_directory();
|
|
#if TORRENT_USE_UNC_PATHS
|
|
TORRENT_EXTRA_EXPORT std::string canonicalize_path(string_view f);
|
|
#endif
|
|
|
|
// internal type alias export should be used at unit tests only
|
|
using native_path_string =
|
|
#if TORRENT_USE_WSTRING && defined TORRENT_WINDOWS
|
|
std::wstring;
|
|
#else
|
|
std::string;
|
|
#endif
|
|
|
|
// internal export should be used at unit tests only
|
|
TORRENT_EXTRA_EXPORT native_path_string convert_to_native_path_string(std::string const& path);
|
|
|
|
// internal export should be used at unit tests only
|
|
TORRENT_EXTRA_EXPORT std::string convert_from_native_path(char const* s);
|
|
|
|
#if defined TORRENT_WINDOWS && TORRENT_USE_WSTRING
|
|
// internal export should be used at unit tests only
|
|
TORRENT_EXTRA_EXPORT std::string convert_from_native_path(wchar_t const* s);
|
|
#endif
|
|
|
|
// TODO: move this into a separate header file, TU pair
|
|
class TORRENT_EXTRA_EXPORT directory : public boost::noncopyable
|
|
{
|
|
public:
|
|
directory(std::string const& path, error_code& ec);
|
|
~directory();
|
|
void next(error_code& ec);
|
|
std::string file() const;
|
|
std::uint64_t inode() const;
|
|
bool done() const { return m_done; }
|
|
private:
|
|
#ifdef TORRENT_WINDOWS
|
|
HANDLE m_handle;
|
|
int m_inode;
|
|
#if TORRENT_USE_WSTRING
|
|
WIN32_FIND_DATAW m_fd;
|
|
#else
|
|
WIN32_FIND_DATAA m_fd;
|
|
#endif
|
|
#else
|
|
DIR* m_handle;
|
|
// the dirent struct contains a zero-sized
|
|
// array at the end, it will end up referring
|
|
// to the m_name field
|
|
struct dirent m_dirent;
|
|
char m_name[TORRENT_MAX_PATH + 1]; // +1 to make room for terminating 0
|
|
#endif
|
|
bool m_done;
|
|
};
|
|
|
|
struct file;
|
|
|
|
using file_handle = std::shared_ptr<file>;
|
|
|
|
struct TORRENT_EXTRA_EXPORT file: boost::noncopyable
|
|
{
|
|
// the open mode for files. Used for the file constructor or
|
|
// file::open().
|
|
enum open_mode_t
|
|
{
|
|
// open the file for reading only
|
|
read_only = 0,
|
|
|
|
// open the file for writing only
|
|
write_only = 1,
|
|
|
|
// open the file for reading and writing
|
|
read_write = 2,
|
|
|
|
// the mask for the bits determining read or write mode
|
|
rw_mask = read_only | write_only | read_write,
|
|
|
|
// open the file in sparse mode (if supported by the
|
|
// filesystem).
|
|
sparse = 0x4,
|
|
|
|
// don't update the access timestamps on the file (if
|
|
// supported by the operating system and filesystem).
|
|
// this generally improves disk performance.
|
|
no_atime = 0x8,
|
|
|
|
// open the file for random access. This disables read-ahead
|
|
// logic
|
|
random_access = 0x10,
|
|
|
|
// prevent the file from being opened by another process
|
|
// while it's still being held open by this handle
|
|
lock_file = 0x20,
|
|
|
|
// don't put any pressure on the OS disk cache
|
|
// because of access to this file. We expect our
|
|
// files to be fairly large, and there is already
|
|
// a cache at the bittorrent block level. This
|
|
// may improve overall system performance by
|
|
// leaving running applications in the page cache
|
|
no_cache = 0x40,
|
|
|
|
// this is only used for readv/writev flags
|
|
coalesce_buffers = 0x100,
|
|
|
|
// when creating a file, set the hidden attribute (windows only)
|
|
attribute_hidden = 0x200,
|
|
|
|
// when creating a file, set the executable attribute
|
|
attribute_executable = 0x400,
|
|
|
|
// the mask of all attribute bits
|
|
attribute_mask = attribute_hidden | attribute_executable
|
|
};
|
|
|
|
file();
|
|
file(std::string const& p, int m, error_code& ec);
|
|
~file();
|
|
|
|
bool open(std::string const& p, int m, error_code& ec);
|
|
bool is_open() const;
|
|
void close();
|
|
bool set_size(std::int64_t size, error_code& ec);
|
|
|
|
int open_mode() const { return m_open_mode; }
|
|
|
|
std::int64_t writev(std::int64_t file_offset, span<iovec_t const> bufs
|
|
, error_code& ec, int flags = 0);
|
|
std::int64_t readv(std::int64_t file_offset, span<iovec_t const> bufs
|
|
, error_code& ec, int flags = 0);
|
|
|
|
std::int64_t get_size(error_code& ec) const;
|
|
|
|
// return the offset of the first byte that
|
|
// belongs to a data-region
|
|
std::int64_t sparse_end(std::int64_t start) const;
|
|
|
|
handle_type native_handle() const { return m_file_handle; }
|
|
|
|
private:
|
|
|
|
handle_type m_file_handle;
|
|
|
|
int m_open_mode;
|
|
#if defined TORRENT_WINDOWS
|
|
static bool has_manage_volume_privs;
|
|
#endif
|
|
};
|
|
|
|
TORRENT_EXTRA_EXPORT int bufs_size(span<iovec_t const> bufs);
|
|
|
|
}
|
|
|
|
#endif // TORRENT_FILE_HPP_INCLUDED
|