File: DiskAdaptor.h

package info (click to toggle)
aria2 1.18.8-1
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 19,392 kB
  • ctags: 16,036
  • sloc: cpp: 115,823; sh: 12,015; ansic: 7,394; makefile: 1,445; ruby: 462; python: 216; xml: 176; asm: 58; sed: 16
file content (153 lines) | stat: -rw-r--r-- 4,571 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
/* <!-- copyright */
/*
 * aria2 - The high speed download utility
 *
 * Copyright (C) 2006 Tatsuhiro Tsujikawa
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 *
 * In addition, as a special exception, the copyright holders give
 * permission to link the code of portions of this program with the
 * OpenSSL library under certain conditions as described in each
 * individual source file, and distribute linked combinations
 * including the two.
 * You must obey the GNU General Public License in all respects
 * for all of the code used other than OpenSSL.  If you modify
 * file(s) with this exception, you may extend this exception to your
 * version of the file(s), but you are not obligated to do so.  If you
 * do not wish to do so, delete this exception statement from your
 * version.  If you delete this exception statement from all source
 * files in the program, then also delete it here.
 */
/* copyright --> */
#ifndef D_DISK_ADAPTOR_H
#define D_DISK_ADAPTOR_H

#include "BinaryStream.h"

#include <string>
#include <vector>
#include <memory>

#include "TimeA2.h"

namespace aria2 {

class FileEntry;
class FileAllocationIterator;
class WrDiskCacheEntry;
class OpenedFileCounter;

class DiskAdaptor:public BinaryStream {
public:
  enum FileAllocationMethod {
    FILE_ALLOC_ADAPTIVE,
    FILE_ALLOC_FALLOC,
    FILE_ALLOC_TRUNC
  };

  DiskAdaptor();
  virtual ~DiskAdaptor();

  virtual void openFile() = 0;

  virtual void closeFile() = 0;

  virtual void openExistingFile() = 0;

  virtual void initAndOpenFile() = 0;

  virtual bool fileExists() = 0;

  virtual int64_t size() = 0;

  template<typename InputIterator>
  void setFileEntries(InputIterator first, InputIterator last)
  {
    fileEntries_.assign(first, last);
  }

  const std::vector<std::shared_ptr<FileEntry>>& getFileEntries() const
  {
    return fileEntries_;
  }

  virtual std::unique_ptr<FileAllocationIterator> fileAllocationIterator() = 0;

  virtual void enableReadOnly() {}

  virtual void disableReadOnly() {}

  virtual bool isReadOnlyEnabled() const { return false; }

  // Enables mmap feature. Some derived classes may require that files
  // have been opened before this method call.
  virtual void enableMmap() {}

  // Assumed each file length is stored in fileEntries or DiskAdaptor knows it.
  // If each actual file's length is larger than that, truncate file to that
  // length.
  // Call one of openFile/openExistingFile/initAndOpenFile before calling this
  // function.
  virtual void cutTrailingGarbage() = 0;

  // Returns the number of files, the actime and modtime of which are
  // successfully changed.
  virtual size_t utime(const Time& actime, const Time& modtime) = 0;

  // Just like readData(), but drop cache after read.
  virtual ssize_t readDataDropCache(unsigned char* data, size_t len,
                                    int64_t offset) = 0;

  // Writes cached data to the underlying disk.
  virtual void writeCache(const WrDiskCacheEntry* entry) = 0;

  void setFileAllocationMethod(FileAllocationMethod method)
  {
    fileAllocationMethod_ = method;
  }

  int getFileAllocationMethod() const
  {
    return fileAllocationMethod_;
  }

  // Closes at most |numClose| files if possible. This method is used to
  // ensure that global number of open file stays under certain limit.
  // Returns the number of closed files.
  virtual size_t tryCloseFile(size_t numClose) { return 0; }

  void setOpenedFileCounter
  (std::shared_ptr<OpenedFileCounter> openedFileCounter)
  {
    openedFileCounter_ = std::move(openedFileCounter);
  }

  const std::shared_ptr<OpenedFileCounter>& getOpenedFileCounter() const
  {
    return openedFileCounter_;
  }

private:
  std::vector<std::shared_ptr<FileEntry> > fileEntries_;

  FileAllocationMethod fileAllocationMethod_;

  std::shared_ptr<OpenedFileCounter> openedFileCounter_;
};

} // namespace aria2

#endif // D_DISK_ADAPTOR_H