update size of dynamic MMap as we write in from the outside
[ntk/apt.git] / apt-pkg / contrib / mmap.h
CommitLineData
578bfd0a
AL
1// -*- mode: cpp; mode: fold -*-
2// Description /*{{{*/
422d9f6e 3// $Id: mmap.h,v 1.12 2001/05/14 05:16:43 jgg Exp $
578bfd0a
AL
4/* ######################################################################
5
6 MMap Class - Provides 'real' mmap or a faked mmap using read().
7
8 The purpose of this code is to provide a generic way for clients to
9 access the mmap function. In enviroments that do not support mmap
10 from file fd's this function will use read and normal allocated
11 memory.
12
13 Writing to a public mmap will always fully comit all changes when the
14 class is deleted. Ie it will rewrite the file, unless it is readonly
15
16 The DynamicMMap class is used to help the on-disk data structure
17 generators. It provides a large allocated workspace and members
18 to allocate space from the workspace in an effecient fashion.
19
20 This source is placed in the Public Domain, do with it what you will
21 It was originally written by Jason Gunthorpe.
22
23 ##################################################################### */
24 /*}}}*/
578bfd0a
AL
25#ifndef PKGLIB_MMAP_H
26#define PKGLIB_MMAP_H
27
6c139d6e 28
578bfd0a 29#include <string>
094a497d 30#include <apt-pkg/fileutl.h>
578bfd0a 31
422d9f6e
AL
32using std::string;
33
349cd3b8
AL
34/* This should be a 32 bit type, larger tyes use too much ram and smaller
35 types are too small. Where ever possible 'unsigned long' should be used
36 instead of this internal type */
37typedef unsigned int map_ptrloc;
38
578bfd0a
AL
39class MMap
40{
41 protected:
42
2d11135a 43 unsigned long Flags;
578bfd0a
AL
44 unsigned long iSize;
45 void *Base;
46
06afffcc
DK
47 // In case mmap can not be used, we keep a dup of the file
48 // descriptor that should have been mmaped so that we can write to
49 // the file in Sync().
50 FileFd *SyncToFd;
51
2d11135a
AL
52 bool Map(FileFd &Fd);
53 bool Close(bool DoSync = true);
578bfd0a
AL
54
55 public:
56
2d11135a 57 enum OpenFlags {NoImmMap = (1<<0),Public = (1<<1),ReadOnly = (1<<2),
d6c4a976 58 UnMapped = (1<<3), Moveable = (1<<4), Fallback = (1 << 5)};
578bfd0a
AL
59
60 // Simple accessors
61 inline operator void *() {return Base;};
62 inline void *Data() {return Base;};
63 inline unsigned long Size() {return iSize;};
00542838 64 inline void AddSize(unsigned long const size) {iSize += size;};
578bfd0a
AL
65
66 // File manipulators
67 bool Sync();
68 bool Sync(unsigned long Start,unsigned long Stop);
69
8e06abb2 70 MMap(FileFd &F,unsigned long Flags);
2d11135a 71 MMap(unsigned long Flags);
578bfd0a
AL
72 virtual ~MMap();
73};
74
75class DynamicMMap : public MMap
76{
77 public:
78
79 // This is the allocation pool structure
80 struct Pool
81 {
82 unsigned long ItemSize;
83 unsigned long Start;
84 unsigned long Count;
85 };
86
87 protected:
88
2d11135a 89 FileFd *Fd;
578bfd0a 90 unsigned long WorkSpace;
d6c4a976
DK
91 unsigned long const GrowFactor;
92 unsigned long const Limit;
578bfd0a
AL
93 Pool *Pools;
94 unsigned int PoolCount;
f1c6a8ca
DK
95
96 bool Grow();
578bfd0a
AL
97
98 public:
99
100 // Allocation
f55a958f 101 unsigned long RawAllocate(unsigned long Size,unsigned long Aln = 0);
578bfd0a 102 unsigned long Allocate(unsigned long ItemSize);
6e52073f 103 unsigned long WriteString(const char *String,unsigned long Len = (unsigned long)-1);
171c75f1 104 inline unsigned long WriteString(const string &S) {return WriteString(S.c_str(),S.length());};
6e52073f 105 void UsePools(Pool &P,unsigned int Count) {Pools = &P; PoolCount = Count;};
578bfd0a 106
d6c4a976
DK
107 DynamicMMap(FileFd &F,unsigned long Flags,unsigned long const &WorkSpace = 2*1024*1024,
108 unsigned long const &Grow = 1024*1024, unsigned long const &Limit = 0);
109 DynamicMMap(unsigned long Flags,unsigned long const &WorkSpace = 2*1024*1024,
110 unsigned long const &Grow = 1024*1024, unsigned long const &Limit = 0);
578bfd0a
AL
111 virtual ~DynamicMMap();
112};
113
114#endif