]>
Commit | Line | Data |
---|---|---|
1 | // -*- mode: cpp; mode: fold -*- | |
2 | // Description /*{{{*/ | |
3 | // $Id: pkgcache.h,v 1.25 2001/07/01 22:28:24 jgg Exp $ | |
4 | /* ###################################################################### | |
5 | ||
6 | Cache - Structure definitions for the cache file | |
7 | ||
8 | Please see doc/apt-pkg/cache.sgml for a more detailed description of | |
9 | this format. Also be sure to keep that file up-to-date!! | |
10 | ||
11 | Clients should always use the CacheIterators classes for access to the | |
12 | cache. They provide a simple STL-like method for traversing the links | |
13 | of the datastructure. | |
14 | ||
15 | See pkgcachegen.h for information about generating cache structures. | |
16 | ||
17 | ##################################################################### */ | |
18 | /*}}}*/ | |
19 | #ifndef PKGLIB_PKGCACHE_H | |
20 | #define PKGLIB_PKGCACHE_H | |
21 | ||
22 | #ifdef __GNUG__ | |
23 | #pragma interface "apt-pkg/pkgcache.h" | |
24 | #endif | |
25 | ||
26 | #include <string> | |
27 | #include <time.h> | |
28 | #include <apt-pkg/mmap.h> | |
29 | ||
30 | using std::string; | |
31 | ||
32 | class pkgVersioningSystem; | |
33 | class pkgCache | |
34 | { | |
35 | public: | |
36 | // Cache element predeclarations | |
37 | struct Header; | |
38 | struct Package; | |
39 | struct PackageFile; | |
40 | struct Version; | |
41 | struct Provides; | |
42 | struct Dependency; | |
43 | struct StringItem; | |
44 | struct VerFile; | |
45 | ||
46 | // Iterators | |
47 | class PkgIterator; | |
48 | class VerIterator; | |
49 | class DepIterator; | |
50 | class PrvIterator; | |
51 | class PkgFileIterator; | |
52 | class VerFileIterator; | |
53 | friend class PkgIterator; | |
54 | friend class VerIterator; | |
55 | friend class DepIterator; | |
56 | friend class PrvIterator; | |
57 | friend class PkgFileIterator; | |
58 | friend class VerFileIterator; | |
59 | ||
60 | class Namespace; | |
61 | ||
62 | // These are all the constants used in the cache structures | |
63 | struct Dep | |
64 | { | |
65 | enum DepType {Depends=1,PreDepends=2,Suggests=3,Recommends=4, | |
66 | Conflicts=5,Replaces=6,Obsoletes=7}; | |
67 | enum DepCompareOp {Or=0x10,NoOp=0,LessEq=0x1,GreaterEq=0x2,Less=0x3, | |
68 | Greater=0x4,Equals=0x5,NotEquals=0x6}; | |
69 | }; | |
70 | ||
71 | struct State | |
72 | { | |
73 | enum VerPriority {Important=1,Required=2,Standard=3,Optional=4,Extra=5}; | |
74 | enum PkgSelectedState {Unknown=0,Install=1,Hold=2,DeInstall=3,Purge=4}; | |
75 | enum PkgInstState {Ok=0,ReInstReq=1,HoldInst=2,HoldReInstReq=3}; | |
76 | enum PkgCurrentState {NotInstalled=0,UnPacked=1,HalfConfigured=2, | |
77 | HalfInstalled=4,ConfigFiles=5,Installed=6}; | |
78 | }; | |
79 | ||
80 | struct Flag | |
81 | { | |
82 | enum PkgFlags {Auto=(1<<0),Essential=(1<<3),Important=(1<<4)}; | |
83 | enum PkgFFlags {NotSource=(1<<0),NotAutomatic=(1<<1)}; | |
84 | }; | |
85 | ||
86 | protected: | |
87 | ||
88 | // Memory mapped cache file | |
89 | string CacheFile; | |
90 | MMap ⤅ | |
91 | ||
92 | unsigned long sHash(const string &S) const; | |
93 | unsigned long sHash(const char *S) const; | |
94 | ||
95 | public: | |
96 | ||
97 | // Pointers to the arrays of items | |
98 | Header *HeaderP; | |
99 | Package *PkgP; | |
100 | VerFile *VerFileP; | |
101 | PackageFile *PkgFileP; | |
102 | Version *VerP; | |
103 | Provides *ProvideP; | |
104 | Dependency *DepP; | |
105 | StringItem *StringItemP; | |
106 | char *StrP; | |
107 | ||
108 | virtual bool ReMap(); | |
109 | inline bool Sync() {return Map.Sync();}; | |
110 | inline MMap &GetMap() {return Map;}; | |
111 | inline void *DataEnd() {return ((unsigned char *)Map.Data()) + Map.Size();}; | |
112 | ||
113 | // String hashing function (512 range) | |
114 | inline unsigned long Hash(const string &S) const {return sHash(S);}; | |
115 | inline unsigned long Hash(const char *S) const {return sHash(S);}; | |
116 | ||
117 | // Usefull transformation things | |
118 | const char *Priority(unsigned char Priority); | |
119 | ||
120 | // Accessors | |
121 | PkgIterator FindPkg(const string &Name); | |
122 | Header &Head() {return *HeaderP;}; | |
123 | inline PkgIterator PkgBegin(); | |
124 | inline PkgIterator PkgEnd(); | |
125 | inline PkgFileIterator FileBegin(); | |
126 | inline PkgFileIterator FileEnd(); | |
127 | ||
128 | // Make me a function | |
129 | pkgVersioningSystem *VS; | |
130 | ||
131 | // Converters | |
132 | static const char *CompTypeDeb(unsigned char Comp); | |
133 | static const char *CompType(unsigned char Comp); | |
134 | static const char *DepType(unsigned char Dep); | |
135 | ||
136 | pkgCache(MMap *Map,bool DoMap = true); | |
137 | virtual ~pkgCache() {}; | |
138 | }; | |
139 | ||
140 | // Header structure | |
141 | struct pkgCache::Header | |
142 | { | |
143 | // Signature information | |
144 | unsigned long Signature; | |
145 | short MajorVersion; | |
146 | short MinorVersion; | |
147 | bool Dirty; | |
148 | ||
149 | // Size of structure values | |
150 | unsigned short HeaderSz; | |
151 | unsigned short PackageSz; | |
152 | unsigned short PackageFileSz; | |
153 | unsigned short VersionSz; | |
154 | unsigned short DependencySz; | |
155 | unsigned short ProvidesSz; | |
156 | unsigned short VerFileSz; | |
157 | ||
158 | // Structure counts | |
159 | unsigned long PackageCount; | |
160 | unsigned long VersionCount; | |
161 | unsigned long DependsCount; | |
162 | unsigned long PackageFileCount; | |
163 | unsigned long VerFileCount; | |
164 | unsigned long ProvidesCount; | |
165 | ||
166 | // Offsets | |
167 | map_ptrloc FileList; // struct PackageFile | |
168 | map_ptrloc StringList; // struct StringItem | |
169 | map_ptrloc VerSysName; // StringTable | |
170 | map_ptrloc Architecture; // StringTable | |
171 | unsigned long MaxVerFileSize; | |
172 | ||
173 | /* Allocation pools, there should be one of these for each structure | |
174 | excluding the header */ | |
175 | DynamicMMap::Pool Pools[7]; | |
176 | ||
177 | // Rapid package name lookup | |
178 | map_ptrloc HashTable[2*1048]; | |
179 | ||
180 | bool CheckSizes(Header &Against) const; | |
181 | Header(); | |
182 | }; | |
183 | ||
184 | struct pkgCache::Package | |
185 | { | |
186 | // Pointers | |
187 | map_ptrloc Name; // Stringtable | |
188 | map_ptrloc VersionList; // Version | |
189 | map_ptrloc CurrentVer; // Version | |
190 | map_ptrloc Section; // StringTable (StringItem) | |
191 | ||
192 | // Linked list | |
193 | map_ptrloc NextPackage; // Package | |
194 | map_ptrloc RevDepends; // Dependency | |
195 | map_ptrloc ProvidesList; // Provides | |
196 | ||
197 | // Install/Remove/Purge etc | |
198 | unsigned char SelectedState; // What | |
199 | unsigned char InstState; // Flags | |
200 | unsigned char CurrentState; // State | |
201 | ||
202 | unsigned short ID; | |
203 | unsigned long Flags; | |
204 | }; | |
205 | ||
206 | struct pkgCache::PackageFile | |
207 | { | |
208 | // Names | |
209 | map_ptrloc FileName; // Stringtable | |
210 | map_ptrloc Archive; // Stringtable | |
211 | map_ptrloc Component; // Stringtable | |
212 | map_ptrloc Version; // Stringtable | |
213 | map_ptrloc Origin; // Stringtable | |
214 | map_ptrloc Label; // Stringtable | |
215 | map_ptrloc Architecture; // Stringtable | |
216 | map_ptrloc Site; // Stringtable | |
217 | map_ptrloc IndexType; // Stringtable | |
218 | unsigned long Size; | |
219 | unsigned long Flags; | |
220 | ||
221 | // Linked list | |
222 | map_ptrloc NextFile; // PackageFile | |
223 | unsigned short ID; | |
224 | time_t mtime; // Modification time for the file | |
225 | }; | |
226 | ||
227 | struct pkgCache::VerFile | |
228 | { | |
229 | map_ptrloc File; // PackageFile | |
230 | map_ptrloc NextFile; // PkgVerFile | |
231 | map_ptrloc Offset; // File offset | |
232 | unsigned short Size; | |
233 | }; | |
234 | ||
235 | struct pkgCache::Version | |
236 | { | |
237 | map_ptrloc VerStr; // Stringtable | |
238 | map_ptrloc Section; // StringTable (StringItem) | |
239 | map_ptrloc Arch; // StringTable | |
240 | ||
241 | // Lists | |
242 | map_ptrloc FileList; // VerFile | |
243 | map_ptrloc NextVer; // Version | |
244 | map_ptrloc DependsList; // Dependency | |
245 | map_ptrloc ParentPkg; // Package | |
246 | map_ptrloc ProvidesList; // Provides | |
247 | ||
248 | map_ptrloc Size; // These are the .deb size | |
249 | map_ptrloc InstalledSize; | |
250 | unsigned short Hash; | |
251 | unsigned short ID; | |
252 | unsigned char Priority; | |
253 | }; | |
254 | ||
255 | struct pkgCache::Dependency | |
256 | { | |
257 | map_ptrloc Version; // Stringtable | |
258 | map_ptrloc Package; // Package | |
259 | map_ptrloc NextDepends; // Dependency | |
260 | map_ptrloc NextRevDepends; // Dependency | |
261 | map_ptrloc ParentVer; // Version | |
262 | ||
263 | // Specific types of depends | |
264 | map_ptrloc ID; | |
265 | unsigned char Type; | |
266 | unsigned char CompareOp; | |
267 | }; | |
268 | ||
269 | struct pkgCache::Provides | |
270 | { | |
271 | map_ptrloc ParentPkg; // Pacakge | |
272 | map_ptrloc Version; // Version | |
273 | map_ptrloc ProvideVersion; // Stringtable | |
274 | map_ptrloc NextProvides; // Provides | |
275 | map_ptrloc NextPkgProv; // Provides | |
276 | }; | |
277 | ||
278 | struct pkgCache::StringItem | |
279 | { | |
280 | map_ptrloc String; // Stringtable | |
281 | map_ptrloc NextItem; // StringItem | |
282 | }; | |
283 | ||
284 | #include <apt-pkg/cacheiterators.h> | |
285 | ||
286 | inline pkgCache::PkgIterator pkgCache::PkgBegin() | |
287 | {return PkgIterator(*this);}; | |
288 | inline pkgCache::PkgIterator pkgCache::PkgEnd() | |
289 | {return PkgIterator(*this,PkgP);}; | |
290 | inline pkgCache::PkgFileIterator pkgCache::FileBegin() | |
291 | {return PkgFileIterator(*this,PkgFileP + HeaderP->FileList);}; | |
292 | inline pkgCache::PkgFileIterator pkgCache::FileEnd() | |
293 | {return PkgFileIterator(*this,PkgFileP);}; | |
294 | ||
295 | // Oh I wish for Real Name Space Support | |
296 | class pkgCache::Namespace | |
297 | { | |
298 | public: | |
299 | ||
300 | typedef pkgCache::PkgIterator PkgIterator; | |
301 | typedef pkgCache::VerIterator VerIterator; | |
302 | typedef pkgCache::DepIterator DepIterator; | |
303 | typedef pkgCache::PrvIterator PrvIterator; | |
304 | typedef pkgCache::PkgFileIterator PkgFileIterator; | |
305 | typedef pkgCache::VerFileIterator VerFileIterator; | |
306 | typedef pkgCache::Version Version; | |
307 | typedef pkgCache::Package Package; | |
308 | typedef pkgCache::Header Header; | |
309 | typedef pkgCache::Dep Dep; | |
310 | typedef pkgCache::Flag Flag; | |
311 | }; | |
312 | ||
313 | #endif |