• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

taosdata / TDengine / #4913

06 Jan 2026 01:30AM UTC coverage: 64.884% (-0.004%) from 64.888%
#4913

push

travis-ci

web-flow
merge: from main to 3.0 branch #34167

180 of 319 new or added lines in 14 files covered. (56.43%)

571 existing lines in 128 files now uncovered.

195016 of 300563 relevant lines covered (64.88%)

117540852.85 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

67.14
/source/util/src/tpagedbuf.c
1
#define _DEFAULT_SOURCE
2
#include "tpagedbuf.h"
3
#include "taoserror.h"
4
#include "tcompression.h"
5
#include "tlog.h"
6
#include "tsimplehash.h"
7

8
#define GET_PAYLOAD_DATA(_p)           ((char*)(_p)->pData + POINTER_BYTES)
9
#define BUF_PAGE_IN_MEM(_p)            ((_p)->pData != NULL)
10
#define CLEAR_BUF_PAGE_IN_MEM_FLAG(_p) ((_p)->pData = NULL)
11
#define HAS_DATA_IN_DISK(_p)           ((_p)->offset >= 0)
12
#define NO_IN_MEM_AVAILABLE_PAGES(_b)  (listNEles((_b)->lruList) >= (_b)->inMemPages)
13

14
typedef struct SPageDiskInfo {
15
  int64_t offset;
16
  int32_t length;
17
} SPageDiskInfo, SFreeListItem;
18

19
struct SPageInfo {
20
  SListNode* pn;  // point to list node struct. it is NULL when the page is evicted from the in-memory buffer
21
  void*      pData;
22
  int64_t    offset;
23
  int32_t    pageId;
24
  int32_t    length : 29;
25
  bool       used : 1;   // set current page is in used
26
  bool       dirty : 1;  // set current buffer page is dirty or not
27
};
28

29
struct SDiskbasedBuf {
30
  int32_t    numOfPages;
31
  int64_t    totalBufSize;
32
  uint64_t   fileSize;  // disk file size
33
  TdFilePtr  pFile;
34
  int32_t    allocateId;  // allocated page id
35
  char*      path;        // file path
36
  char*      prefix;      // file name prefix
37
  int32_t    pageSize;    // current used page size
38
  int32_t    inMemPages;  // numOfPages that are allocated in memory
39
  SList*     freePgList;  // free page list
40
  SArray*    pIdList;     // page id list
41
  SSHashObj* all;
42
  SList*     lruList;
43
  void*      emptyDummyIdList;  // dummy id list
44
  void*      assistBuf;         // assistant buffer for compress/decompress data
45
  SArray*    pFree;             // free area in file
46
  bool       comp;              // compressed before flushed to disk
47
  uint64_t   nextPos;           // next page flush position
48

49
  char*               id;           // for debug purpose
50
  bool                printStatis;  // Print statistics info when closing this buffer.
51
  SDiskbasedBufStatis statis;
52
};
53

54
static int32_t createDiskFile(SDiskbasedBuf* pBuf) {
38,129✔
55
  if (pBuf->path == NULL) {  // prepare the file name when needed it
38,129✔
56
    char path[PATH_MAX] = {0};
38,129✔
57
    taosGetTmpfilePath(pBuf->prefix, "paged-buf", path);
38,129✔
58
    pBuf->path = taosStrdup(path);
38,129✔
59
    if (pBuf->path == NULL) {
38,129✔
60
      return terrno;
×
61
    }
62
  }
63

64
  pBuf->pFile =
38,129✔
65
      taosOpenFile(pBuf->path, TD_FILE_CREATE | TD_FILE_WRITE | TD_FILE_READ | TD_FILE_TRUNC | TD_FILE_AUTO_DEL);
38,129✔
66
  if (pBuf->pFile == NULL) {
38,129✔
67
    return terrno;
×
68
  }
69

70
  return TSDB_CODE_SUCCESS;
38,129✔
71
}
72

73
static char* doCompressData(void* data, int32_t srcSize, int32_t* dst, SDiskbasedBuf* pBuf) {  // do nothing
147,593,309✔
74
  if (!pBuf->comp) {
147,593,309✔
75
    *dst = srcSize;
147,594,665✔
76
    return data;
147,594,665✔
77
  }
78

79
  *dst = tsCompressString(data, srcSize, 1, pBuf->assistBuf, srcSize, ONE_STAGE_COMP, NULL, 0);
×
80

81
  memcpy(data, pBuf->assistBuf, *dst);
×
82
  return data;
×
83
}
84

85
static int32_t doDecompressData(void* data, int32_t srcSize, int32_t* dst, SDiskbasedBuf* pBuf) {  // do nothing
131,224,431✔
86
  int32_t code = 0;
131,224,431✔
87
  if (!pBuf->comp) {
131,224,431✔
88
    *dst = srcSize;
131,224,431✔
89
    return code;
131,223,959✔
90
  }
91

92
  *dst = tsDecompressString(data, srcSize, 1, pBuf->assistBuf, pBuf->pageSize, ONE_STAGE_COMP, NULL, 0);
×
93
  if (*dst > 0) {
×
94
    memcpy(data, pBuf->assistBuf, *dst);
×
95
  } else if (*dst < 0) {
×
96
    return terrno;
×
97
  }
98
  return code;
×
99
  ;
100
}
101

102
static uint64_t allocateNewPositionInFile(SDiskbasedBuf* pBuf, size_t size) {
147,593,279✔
103
  if (pBuf->pFree == NULL) {
147,593,279✔
104
    return pBuf->nextPos;
×
105
  } else {
106
    int32_t offset = -1;
147,593,721✔
107

108
    size_t num = taosArrayGetSize(pBuf->pFree);
147,593,721✔
109
    for (int32_t i = 0; i < num; ++i) {
147,594,163✔
110
      SFreeListItem* pi = taosArrayGet(pBuf->pFree, i);
×
111
      if (pi->length >= size) {
×
112
        offset = pi->offset;
×
113
        pi->offset += (int32_t)size;
×
114
        pi->length -= (int32_t)size;
×
115

116
        return offset;
×
117
      }
118
    }
119

120
    // no available recycle space, allocate new area in file
121
    return pBuf->nextPos;
147,594,163✔
122
  }
123
}
124

125
/**
126
 *   +--------------------------+-------------------+--------------+
127
 *   | PTR to SPageInfo (8bytes)| Payload (PageSize)| 2 Extra Bytes|
128
 *   +--------------------------+-------------------+--------------+
129
 * @param pBuf
130
 * @param pg
131
 * @return
132
 */
133

134
static FORCE_INLINE size_t getAllocPageSize(int32_t pageSize) { return pageSize + POINTER_BYTES + sizeof(SFilePage); }
1,139,758,452✔
135

136
static int32_t doFlushBufPageImpl(SDiskbasedBuf* pBuf, int64_t offset, const char* pData, int32_t size) {
147,594,635✔
137
  int64_t ret = taosLSeekFile(pBuf->pFile, offset, SEEK_SET);
147,594,635✔
138
  if (ret < 0) {
147,594,635✔
139
    return terrno;
×
140
  }
141

142
  ret = (int32_t)taosWriteFile(pBuf->pFile, pData, size);
147,594,635✔
143
  if (ret != size) {
147,595,107✔
144
    return terrno;
×
145
  }
146

147
  // extend the file
148
  if (pBuf->fileSize < offset + size) {
147,595,107✔
149
    pBuf->fileSize = offset + size;
147,594,634✔
150
  }
151

152
  pBuf->statis.flushBytes += size;
147,594,634✔
153
  pBuf->statis.flushPages += 1;
147,594,635✔
154

155
  return TSDB_CODE_SUCCESS;
147,593,751✔
156
}
157

158
static char* doFlushBufPage(SDiskbasedBuf* pBuf, SPageInfo* pg) {
221,663,263✔
159
  if (pg->pData == NULL || pg->used) {
221,663,263✔
160
    uError("invalid params in paged buffer process when flushing buf to disk, %s", pBuf->id);
×
161
    terrno = TSDB_CODE_INVALID_PARA;
×
162
    return NULL;
×
163
  }
164

165
  int32_t size = pBuf->pageSize;
221,663,705✔
166
  int64_t offset = pg->offset;
221,663,705✔
167

168
  char* t = NULL;
221,664,177✔
169
  if ((!HAS_DATA_IN_DISK(pg)) || pg->dirty) {
221,664,177✔
170
    void* payload = GET_PAYLOAD_DATA(pg);
147,594,665✔
171
    t = doCompressData(payload, pBuf->pageSize + sizeof(SFilePage), &size, pBuf);
147,594,193✔
172
    if (size < 0) {
147,593,249✔
173
      uError("failed to compress data when flushing data to disk, %s", pBuf->id);
×
174
      terrno = TSDB_CODE_INVALID_PARA;
×
175
      return NULL;
×
176
    }
177
  }
178

179
  // this page is flushed to disk for the first time
180
  if (pg->dirty) {
221,662,319✔
181
    if (!HAS_DATA_IN_DISK(pg)) {
147,594,193✔
182
      offset = allocateNewPositionInFile(pBuf, size);
147,593,721✔
183
      pBuf->nextPos += size;
147,594,635✔
184

185
      int32_t code = doFlushBufPageImpl(pBuf, offset, t, size);
147,594,635✔
186
      if (code != TSDB_CODE_SUCCESS) {
147,593,279✔
187
        return NULL;
×
188
      }
189
    } else {
190
      // length becomes greater, current space is not enough, allocate new place, otherwise, do nothing
191
      if (pg->length < size) {
×
192
        // 1. add current space to free list
193
        SPageDiskInfo dinfo = {.length = pg->length, .offset = offset};
×
194
        if (NULL == taosArrayPush(pBuf->pFree, &dinfo)) {
×
195
          return NULL;
×
196
        }
197

198
        // 2. allocate new position, and update the info
199
        offset = allocateNewPositionInFile(pBuf, size);
×
200
        pBuf->nextPos += size;
×
201
      }
202

203
      int32_t code = doFlushBufPageImpl(pBuf, offset, t, size);
×
204
      if (code != TSDB_CODE_SUCCESS) {
×
205
        return NULL;
×
206
      }
207
    }
208
  } else {  // NOTE: the size may be -1, the this recycle page has not been flushed to disk yet.
209
    size = pg->length;
74,069,070✔
210
  }
211

212
  char* pDataBuf = pg->pData;
221,662,349✔
213
  memset(pDataBuf, 0, getAllocPageSize(pBuf->pageSize));
443,325,612✔
214

215
#ifdef BUF_PAGE_DEBUG
216
  uDebug("page_flush %p, pageId:%d, offset:%d", pDataBuf, pg->pageId, offset);
217
#endif
218

219
  pg->offset = offset;
221,663,705✔
220
  pg->length = size;  // on disk size
221,663,735✔
221
  return pDataBuf;
221,664,177✔
222
}
223

224
static char* flushBufPage(SDiskbasedBuf* pBuf, SPageInfo* pg) {
221,663,293✔
225
  int32_t ret = TSDB_CODE_SUCCESS;
221,663,293✔
226

227
  if (pBuf->pFile == NULL) {
221,663,293✔
228
    if ((ret = createDiskFile(pBuf)) != TSDB_CODE_SUCCESS) {
38,129✔
229
      terrno = ret;
×
230
      return NULL;
×
231
    }
232
  }
233

234
  char* p = doFlushBufPage(pBuf, pg);
221,663,293✔
235
  CLEAR_BUF_PAGE_IN_MEM_FLAG(pg);
221,662,791✔
236

237
  pg->dirty = false;
221,662,791✔
238
  return p;
221,663,735✔
239
}
240

241
// load file block data in disk
242
static int32_t loadPageFromDisk(SDiskbasedBuf* pBuf, SPageInfo* pg) {
131,223,487✔
243
  if (pg->offset < 0 || pg->length <= 0) {
131,223,487✔
244
    uError("failed to load buf page from disk, offset:%" PRId64 ", length:%d, %s", pg->offset, pg->length, pBuf->id);
×
245
    return TSDB_CODE_INVALID_PARA;
×
246
  }
247

248
  int64_t ret = taosLSeekFile(pBuf->pFile, pg->offset, SEEK_SET);
131,223,487✔
249
  if (ret < 0) {
131,224,431✔
250
    ret = terrno;
×
251
    return ret;
×
252
  }
253

254
  void* pPage = (void*)GET_PAYLOAD_DATA(pg);
131,224,431✔
255
  ret = taosReadFile(pBuf->pFile, pPage, pg->length);
131,224,431✔
256
  if (ret != pg->length) {
131,224,431✔
257
    ret = terrno;
×
258
    return ret;
×
259
  }
260

261
  pBuf->statis.loadBytes += pg->length;
131,224,431✔
262
  pBuf->statis.loadPages += 1;
131,224,431✔
263

264
  int32_t fullSize = 0;
131,224,431✔
265
  return doDecompressData(pPage, pg->length, &fullSize, pBuf);
131,224,431✔
266
}
267

268
static SPageInfo* registerNewPageInfo(SDiskbasedBuf* pBuf, int32_t pageId) {
1,008,561,950✔
269
  pBuf->numOfPages += 1;
1,008,561,950✔
270

271
  SPageInfo* ppi = taosMemoryMalloc(sizeof(SPageInfo));
1,008,596,120✔
272
  if (ppi == NULL) {
1,008,370,618✔
273
    return NULL;
×
274
  }
275

276
  ppi->pageId = pageId;
1,008,370,618✔
277
  ppi->pData = NULL;
1,008,408,924✔
278
  ppi->offset = -1;
1,008,512,753✔
279
  ppi->length = -1;
1,008,430,799✔
280
  ppi->used = true;
1,008,458,219✔
281
  ppi->pn = NULL;
1,008,587,259✔
282
  ppi->dirty = false;
1,008,556,081✔
283

284
  SPageInfo** pRet = taosArrayPush(pBuf->pIdList, &ppi);
1,008,596,803✔
285
  if (NULL == pRet) {
1,008,677,492✔
286
    taosMemoryFree(ppi);
×
287
    return NULL;
×
288
  }
289
  return *pRet;
1,008,677,492✔
290
}
291

292
static SListNode* getEldestUnrefedPage(SDiskbasedBuf* pBuf) {
221,663,293✔
293
  SListIter iter = {0};
221,663,293✔
294
  tdListInitIter(pBuf->lruList, &iter, TD_LIST_BACKWARD);
221,663,293✔
295

296
  SListNode* pn = NULL;
221,663,263✔
297
  while ((pn = tdListNext(&iter)) != NULL) {
254,713,529✔
298
    SPageInfo* pageInfo = *(SPageInfo**)pn->data;
254,714,001✔
299

300
    SPageInfo* p = *(SPageInfo**)(pageInfo->pData);
254,714,001✔
301

302
    if (!pageInfo->used) {
254,714,001✔
303
      break;
221,662,821✔
304
    }
305
  }
306

307
  return pn;
221,662,821✔
308
}
309

310
static char* evictBufPage(SDiskbasedBuf* pBuf) {
221,662,379✔
311
  SListNode* pn = getEldestUnrefedPage(pBuf);
221,662,379✔
312
  if (pn == NULL) {  // no available buffer pages now, return.
221,663,263✔
313
    return NULL;
×
314
  }
315

316
  terrno = 0;
221,663,263✔
317
  pn = tdListPopNode(pBuf->lruList, pn);
221,663,263✔
318

319
  SPageInfo* d = *(SPageInfo**)pn->data;
221,663,293✔
320

321
  d->pn = NULL;
221,663,293✔
322
  taosMemoryFreeClear(pn);
221,663,293✔
323

324
  return flushBufPage(pBuf, d);
221,662,851✔
325
}
326

327
static int32_t lruListPushFront(SList* pList, SPageInfo* pi) {
1,139,638,775✔
328
  int32_t code = tdListPrepend(pList, &pi);
1,139,638,775✔
329
  if (TSDB_CODE_SUCCESS != code) {
1,139,558,257✔
330
    return code;
×
331
  }
332
  SListNode* front = tdListGetHead(pList);
1,139,558,257✔
333
  pi->pn = front;
1,139,652,517✔
334
  return TSDB_CODE_SUCCESS;
1,139,480,012✔
335
}
336

337
static void lruListMoveToFront(SList* pList, SPageInfo* pi) {
2,147,483,647✔
338
  pi->pn = tdListPopNode(pList, pi->pn);
2,147,483,647✔
339
  tdListPrependNode(pList, pi->pn);
2,147,483,647✔
340
}
2,147,483,647✔
341

342
static SPageInfo* getPageInfoFromPayload(void* page) {
2,147,483,647✔
343
  char* p = (char*)page - POINTER_BYTES;
2,147,483,647✔
344

345
  SPageInfo* ppi = ((SPageInfo**)p)[0];
2,147,483,647✔
346
  return ppi;
2,147,483,647✔
347
}
348

349
int32_t createDiskbasedBuf(SDiskbasedBuf** pBuf, int32_t pagesize, int64_t inMemBufSize, const char* id,
334,114,853✔
350
                           const char* dir) {
351
  int32_t code = 0;
334,114,853✔
352
  *pBuf = NULL;
334,114,853✔
353
  SDiskbasedBuf* pPBuf = taosMemoryCalloc(1, sizeof(SDiskbasedBuf));
334,241,653✔
354
  if (pPBuf == NULL) {
333,170,739✔
355
    code = terrno;
×
356
    goto _error;
×
357
  }
358

359
  pPBuf->pageSize = pagesize;
333,170,739✔
360
  pPBuf->numOfPages = 0;  // all pages are in buffer in the first place
333,184,950✔
361
  pPBuf->totalBufSize = 0;
333,195,613✔
362
  pPBuf->allocateId = -1;
333,291,773✔
363
  pPBuf->pFile = NULL;
333,597,784✔
364
  pPBuf->id = taosStrdup(id);
333,882,511✔
365
  if (id != NULL && pPBuf->id == NULL) {
334,128,508✔
366
    code = terrno;
×
367
    goto _error;
×
368
  }
369
  pPBuf->fileSize = 0;
334,091,573✔
370
  pPBuf->pFree = taosArrayInit(4, sizeof(SFreeListItem));
334,085,355✔
371
  pPBuf->freePgList = tdListNew(POINTER_BYTES);
333,895,482✔
372
  if (pPBuf->pFree == NULL || pPBuf->freePgList == NULL) {
333,791,939✔
UNCOV
373
    code = terrno;
×
374
    goto _error;
×
375
  }
376

377
  // at least more than 2 pages must be in memory
378
  if (inMemBufSize < pagesize * 2) {
333,918,030✔
379
    inMemBufSize = pagesize * 2;
1,050,104✔
380
  }
381

382
  pPBuf->inMemPages = inMemBufSize / pagesize;  // maximum allowed pages, it is a soft limit.
333,918,030✔
383
  pPBuf->lruList = tdListNew(POINTER_BYTES);
334,070,454✔
384
  if (pPBuf->lruList == NULL) {
334,152,990✔
385
    code = terrno;
×
386
    goto _error;
×
387
  }
388

389
  // init id hash table
390
  _hash_fn_t fn = taosGetDefaultHashFunction(TSDB_DATA_TYPE_INT);
334,082,647✔
391
  pPBuf->pIdList = taosArrayInit(4, POINTER_BYTES);
334,128,888✔
392
  if (pPBuf->pIdList == NULL) {
334,028,571✔
393
    code = terrno;
×
394
    goto _error;
×
395
  }
396

397
  pPBuf->all = tSimpleHashInit(64, fn);
333,991,540✔
398
  if (pPBuf->all == NULL) {
333,786,773✔
399
    code = terrno;
×
400
    goto _error;
×
401
  }
402

403
  pPBuf->prefix = (char*)dir;
333,827,496✔
404
  pPBuf->emptyDummyIdList = taosArrayInit(1, sizeof(int32_t));
333,852,708✔
405
  if (pPBuf->emptyDummyIdList == NULL) {
334,153,491✔
406
    code = terrno;
×
407
    goto _error;
×
408
  }
409

410
  //  qDebug("QInfo:0x%"PRIx64 ", create resBuf for output, page size:%d, inmem buf pages:%d, file:%s", qId,
411
  //  pPBuf->pageSize, pPBuf->inMemPages, pPBuf->path);
412

413
  *pBuf = pPBuf;
334,101,000✔
414
  return TSDB_CODE_SUCCESS;
334,135,513✔
415

416
_error:
×
417
  destroyDiskbasedBuf(pPBuf);
×
418
  *pBuf = NULL;
×
419
  return code;
×
420
}
421

422
static char* doExtractPage(SDiskbasedBuf* pBuf) {
1,139,677,040✔
423
  char* availablePage = NULL;
1,139,677,040✔
424
  if (NO_IN_MEM_AVAILABLE_PAGES(pBuf)) {
1,139,677,040✔
425
    availablePage = evictBufPage(pBuf);
221,663,735✔
426
    if (availablePage == NULL) {
221,662,790✔
427
      uWarn("no available buf pages, current:%d, max:%d, reason: %s, %s", listNEles(pBuf->lruList), pBuf->inMemPages,
×
428
            terrstr(), pBuf->id)
429
    }
430
  } else {
431
    availablePage =
917,440,074✔
432
        taosMemoryCalloc(1, getAllocPageSize(pBuf->pageSize));  // add extract bytes in case of zipped buffer increased.
1,835,925,273✔
433
  }
434

435
  return availablePage;
1,139,102,303✔
436
}
437

438
void* getNewBufPage(SDiskbasedBuf* pBuf, int32_t* pageId) {
1,008,457,261✔
439
  pBuf->statis.getPages += 1;
1,008,457,261✔
440

441
  char* availablePage = doExtractPage(pBuf);
1,008,576,937✔
442
  if (availablePage == NULL) {
1,007,878,968✔
443
    return NULL;
×
444
  }
445

446
  SPageInfo* pi = NULL;
1,007,878,968✔
447
  int32_t    code = 0;
1,007,883,214✔
448
  if (listNEles(pBuf->freePgList) != 0) {
1,007,883,214✔
449
    SListNode* pItem = tdListPopHead(pBuf->freePgList);
×
450
    pi = *(SPageInfo**)pItem->data;
×
451
    pi->used = true;
×
452
    *pageId = pi->pageId;
×
453
    taosMemoryFreeClear(pItem);
×
454
    code = lruListPushFront(pBuf->lruList, pi);
×
455
    if (TSDB_CODE_SUCCESS != code) {
×
UNCOV
456
      taosMemoryFree(pi);
×
457
      taosMemoryFree(availablePage);
×
458
      terrno = code;
×
459
      return NULL;
×
460
    }
461
  } else {  // create a new pageinfo
462
    // register new id in this group
463
    *pageId = (++pBuf->allocateId);
1,008,240,264✔
464

465
    // register page id info
466
    pi = registerNewPageInfo(pBuf, *pageId);
1,008,519,099✔
467
    if (pi == NULL) {
1,008,461,966✔
468
      taosMemoryFree(availablePage);
×
469
      return NULL;
×
470
    }
471

472
    // add to hash map
473
    int32_t code = tSimpleHashPut(pBuf->all, pageId, sizeof(int32_t), &pi, POINTER_BYTES);
1,008,461,966✔
474

475
    if (TSDB_CODE_SUCCESS == code) {
1,008,577,701✔
476
      // add to LRU list
477
      code = lruListPushFront(pBuf->lruList, pi);
1,008,436,684✔
478
    }
479
    if (TSDB_CODE_SUCCESS == code) {
1,008,392,175✔
480
      pBuf->totalBufSize += pBuf->pageSize;
1,008,392,175✔
481
    } else {
482
      taosMemoryFree(availablePage);
×
483
      SPageInfo **pLast = taosArrayPop(pBuf->pIdList);
×
484
      int32_t ret = tSimpleHashRemove(pBuf->all, pageId, sizeof(int32_t));
×
485
      if (ret != TSDB_CODE_SUCCESS) {
×
486
        uError("%s failed to clear pageId %d from buf hash-set since %s", __func__, *pageId, tstrerror(ret));
×
487
      }
488
      taosMemoryFree(pi);
×
489
      terrno = code;
×
490
      return NULL;
×
491
    }
492
  }
493

494
  pi->pData = availablePage;
1,008,500,322✔
495

496
  ((void**)pi->pData)[0] = pi;
1,008,513,417✔
497
#ifdef BUF_PAGE_DEBUG
498
  uDebug("page_getNewBufPage , pi->pData:%p, pageId:%d, offset:%" PRId64, pi->pData, pi->pageId, pi->offset);
499
#endif
500

501
  return (void*)(GET_PAYLOAD_DATA(pi));
1,008,399,355✔
502
}
503

504
void* getBufPage(SDiskbasedBuf* pBuf, int32_t id) {
2,147,483,647✔
505
  if (id < 0) {
2,147,483,647✔
506
    terrno = TSDB_CODE_INVALID_PARA;
×
507
    uError("invalid page id:%d, %s", id, pBuf->id);
×
508
    return NULL;
×
509
  }
510

511
  pBuf->statis.getPages += 1;
2,147,483,647✔
512

513
  SPageInfo** pi = tSimpleHashGet(pBuf->all, &id, sizeof(int32_t));
2,147,483,647✔
514
  if (pi == NULL || *pi == NULL) {
2,147,483,647✔
515
    uError("failed to locate the buffer page:%d, %s", id, pBuf->id);
436✔
516
    terrno = TSDB_CODE_INVALID_PARA;
436✔
517
    return NULL;
×
518
  }
519

520
  if (BUF_PAGE_IN_MEM(*pi)) {  // it is in memory
2,147,483,647✔
521
    // no need to update the LRU list if only one page exists
522
    if (pBuf->numOfPages == 1) {
2,147,483,647✔
523
      (*pi)->used = true;
2,147,483,647✔
524
      return (void*)(GET_PAYLOAD_DATA(*pi));
2,147,483,647✔
525
    }
526

527
    SPageInfo** pInfo = (SPageInfo**)((*pi)->pn->data);
2,147,483,647✔
528
    if (*pInfo != *pi) {
2,147,483,647✔
529
      terrno = TSDB_CODE_APP_ERROR;
×
530
      uError("inconsistently data in paged buffer, pInfo:%p, pi:%p, %s", *pInfo, *pi, pBuf->id);
×
531
      return NULL;
×
532
    }
533

534
    lruListMoveToFront(pBuf->lruList, (*pi));
2,147,483,647✔
535
    (*pi)->used = true;
2,147,483,647✔
536

537
#ifdef BUF_PAGE_DEBUG
538
    uDebug("page_getBufPage1 pageId:%d, offset:%" PRId64, (*pi)->pageId, (*pi)->offset);
539
#endif
540
    return (void*)(GET_PAYLOAD_DATA(*pi));
2,147,483,647✔
541
  } else {  // not in memory
542

543
    (*pi)->pData = doExtractPage(pBuf);
131,224,431✔
544

545
    // failed to evict buffer page, return with error code.
546
    if ((*pi)->pData == NULL) {
131,224,431✔
547
      return NULL;
×
548
    }
549

550
    // set the ptr to the new SPageInfo
551
    ((void**)((*pi)->pData))[0] = (*pi);
131,224,431✔
552

553
    int32_t code = lruListPushFront(pBuf->lruList, *pi);
131,224,431✔
554
    if (TSDB_CODE_SUCCESS != code) {
131,223,487✔
555
      taosMemoryFree((*pi)->pData);
×
556
      (*pi)->pData = NULL;
×
557
      terrno = code;
×
558
      return NULL;
×
559
    }
560
    (*pi)->used = true;
131,223,487✔
561

562
    // some data has been flushed to disk, and needs to be loaded into buffer again.
563
    if (HAS_DATA_IN_DISK(*pi)) {
131,223,959✔
564
      int32_t code = loadPageFromDisk(pBuf, *pi);
131,223,959✔
565
      if (code != 0) {
131,223,959✔
566
        taosMemoryFree((*pi)->pData);
×
567
        (*pi)->pData = NULL;
×
568
        terrno = code;
×
569
        return NULL;
×
570
      }
571
    }
572
#ifdef BUF_PAGE_DEBUG
573
    uDebug("page_getBufPage2 pageId:%d, offset:%" PRId64, (*pi)->pageId, (*pi)->offset);
574
#endif
575
    return (void*)(GET_PAYLOAD_DATA(*pi));
131,223,959✔
576
  }
577
}
578

579
void releaseBufPage(SDiskbasedBuf* pBuf, void* page) {
2,147,483,647✔
580
  if (page == NULL) {
2,147,483,647✔
581
    return;
×
582
  }
583

584
  SPageInfo* ppi = getPageInfoFromPayload(page);
2,147,483,647✔
585
  releaseBufPageInfo(pBuf, ppi);
2,147,483,647✔
586
}
587

588
void releaseBufPageInfo(SDiskbasedBuf* pBuf, SPageInfo* pi) {
2,147,483,647✔
589
#ifdef BUF_PAGE_DEBUG
590
  uDebug("page_releaseBufPageInfo pageId:%d, used:%d, offset:%" PRId64, pi->pageId, pi->used, pi->offset);
591
#endif
592

593
  if (pi == NULL) {
2,147,483,647✔
594
    return;
×
595
  }
596

597
  if (pi->pData == NULL) {
2,147,483,647✔
598
    uError("pi->pData (page data) is null");
×
599
    return;
×
600
  }
601

602
  pi->used = false;
2,147,483,647✔
603
  pBuf->statis.releasePages += 1;
2,147,483,647✔
604
}
605

606
size_t getTotalBufSize(const SDiskbasedBuf* pBuf) { return (size_t)pBuf->totalBufSize; }
×
607

608
SArray* getDataBufPagesIdList(SDiskbasedBuf* pBuf) { return pBuf->pIdList; }
×
609

610
void destroyDiskbasedBuf(SDiskbasedBuf* pBuf) {
414,283,779✔
611
  if (pBuf == NULL) {
414,283,779✔
612
    return;
79,859,430✔
613
  }
614

615
  dBufPrintStatis(pBuf);
334,424,349✔
616

617
  bool needRemoveFile = false;
334,424,082✔
618
  if (pBuf->pFile != NULL) {
334,424,082✔
619
    needRemoveFile = true;
38,129✔
620
    uDebug(
38,129✔
621
        "Paged buffer closed, total:%.2f Kb (%d Pages), inmem size:%.2f Kb (%d Pages), file size:%.2f Kb, page "
622
        "size:%.2f Kb, %s",
623
        pBuf->totalBufSize / 1024.0, pBuf->numOfPages, listNEles(pBuf->lruList) * pBuf->pageSize / 1024.0,
624
        listNEles(pBuf->lruList), pBuf->fileSize / 1024.0, pBuf->pageSize / 1024.0f, pBuf->id);
625

626
    int32_t code = taosCloseFile(&pBuf->pFile);
38,129✔
627
    if (TSDB_CODE_SUCCESS != code) {
38,129✔
628
      uDebug("WARNING tPage failed to close file when destroy disk basebuf: %s", pBuf->path);
×
629
    }
630
  } else {
631
    uDebug("Paged buffer closed, total:%.2f Kb, no file created, %s", pBuf->totalBufSize / 1024.0, pBuf->id);
334,386,986✔
632
  }
633

634
  // print the statistics information
635
  {
636
    SDiskbasedBufStatis* ps = &pBuf->statis;
334,425,115✔
637
    if (ps->loadPages == 0) {
334,434,633✔
638
      uDebug("Get/Release pages:%d/%d, flushToDisk:%.2f Kb (%d Pages), loadFromDisk:%.2f Kb (%d Pages)", ps->getPages,
334,407,243✔
639
             ps->releasePages, ps->flushBytes / 1024.0f, ps->flushPages, ps->loadBytes / 1024.0f, ps->loadPages);
640
    } else {
641
      uDebug(
38,129✔
642
          "Get/Release pages:%d/%d, flushToDisk:%.2f Kb (%d Pages), loadFromDisk:%.2f Kb (%d Pages), avgPgSize:%.2f Kb",
643
          ps->getPages, ps->releasePages, ps->flushBytes / 1024.0f, ps->flushPages, ps->loadBytes / 1024.0f,
644
          ps->loadPages, ps->loadBytes / (1024.0 * ps->loadPages));
645
    }
646
  }
647

648
  if (needRemoveFile) {
334,421,846✔
649
    int32_t ret = taosRemoveFile(pBuf->path);
38,129✔
650
    if (ret != 0) {  // print the error and discard this error info
38,129✔
651
      uDebug("WARNING tPage remove file failed. path=%s, code:%s", pBuf->path, strerror(ERRNO));
38,129✔
652
    }
653
  }
654

655
  taosMemoryFreeClear(pBuf->path);
334,421,846✔
656

657
  size_t n = taosArrayGetSize(pBuf->pIdList);
334,440,736✔
658
  for (int32_t i = 0; i < n; ++i) {
1,221,324,676✔
659
    SPageInfo* pi = taosArrayGetP(pBuf->pIdList, i);
886,905,941✔
660
    taosMemoryFreeClear(pi->pData);
886,879,377✔
661
    taosMemoryFreeClear(pi);
886,665,651✔
662
  }
663

664
  taosArrayDestroy(pBuf->pIdList);
334,418,735✔
665

666
  pBuf->lruList = tdListFree(pBuf->lruList);
334,423,681✔
667
  pBuf->freePgList = tdListFree(pBuf->freePgList);
334,416,733✔
668

669
  taosArrayDestroy(pBuf->emptyDummyIdList);
334,425,867✔
670
  taosArrayDestroy(pBuf->pFree);
334,401,415✔
671

672
  tSimpleHashCleanup(pBuf->all);
334,412,881✔
673

674
  taosMemoryFreeClear(pBuf->id);
334,421,113✔
675
  taosMemoryFreeClear(pBuf->assistBuf);
334,393,701✔
676
  taosMemoryFreeClear(pBuf);
334,400,070✔
677
}
678

679
SPageInfo* getLastPageInfo(SArray* pList) {
×
680
  size_t     size = taosArrayGetSize(pList);
×
681
  SPageInfo* pPgInfo = taosArrayGetP(pList, size - 1);
×
682
  return pPgInfo;
×
683
}
684

685
int32_t getPageId(const SPageInfo* pPgInfo) { return pPgInfo->pageId; }
×
686

687
int32_t getBufPageSize(const SDiskbasedBuf* pBuf) { return pBuf->pageSize; }
2,147,483,647✔
688

689
int32_t getNumOfInMemBufPages(const SDiskbasedBuf* pBuf) { return pBuf->inMemPages; }
12,101,302✔
690

691
bool isAllDataInMemBuf(const SDiskbasedBuf* pBuf) { return pBuf->fileSize == 0; }
×
692

693
void setBufPageDirty(void* pPage, bool dirty) {
2,147,483,647✔
694
  SPageInfo* ppi = getPageInfoFromPayload(pPage);
2,147,483,647✔
695
  ppi->dirty = dirty;
2,147,483,647✔
696
}
2,147,483,647✔
697

698
int32_t setBufPageCompressOnDisk(SDiskbasedBuf* pBuf, bool comp) {
×
699
  pBuf->comp = comp;
×
700
  if (comp && (pBuf->assistBuf == NULL)) {
×
701
    pBuf->assistBuf = taosMemoryMalloc(pBuf->pageSize + 2);  // EXTRA BYTES
×
702
    if (pBuf->assistBuf) {
×
703
      return terrno;
×
704
    }
705
  }
706
  return TSDB_CODE_SUCCESS;
×
707
}
708

709
int32_t dBufSetBufPageRecycled(SDiskbasedBuf* pBuf, void* pPage) {
×
710
  SPageInfo* ppi = getPageInfoFromPayload(pPage);
×
711

712
  int32_t code = tdListAppend(pBuf->freePgList, &ppi);
×
713
  if (TSDB_CODE_SUCCESS != code) {
×
714
    return code;
×
715
  }
716

717
  ppi->used = false;
×
718
  ppi->dirty = false;
×
719

720
  // add this pageinfo into the free page info list
721
  SListNode* pNode = tdListPopNode(pBuf->lruList, ppi->pn);
×
722
  taosMemoryFreeClear(ppi->pData);
×
723
  taosMemoryFreeClear(pNode);
×
724
  ppi->pn = NULL;
×
725
  return TSDB_CODE_SUCCESS;
×
726
}
727

728
void dBufSetPrintInfo(SDiskbasedBuf* pBuf) { pBuf->printStatis = true; }
29,380,365✔
729

730
SDiskbasedBufStatis getDBufStatis(const SDiskbasedBuf* pBuf) { return pBuf->statis; }
12,492,473✔
731

732
void dBufPrintStatis(const SDiskbasedBuf* pBuf) {
334,422,302✔
733
  if (!pBuf->printStatis) {
334,422,302✔
734
    return;
305,064,206✔
735
  }
736

737
  const SDiskbasedBufStatis* ps = &pBuf->statis;
29,366,307✔
738

739
#if 0
740
  printf(
741
      "Paged buffer closed, total:%.2f Kb (%d Pages), inmem size:%.2f Kb (%d Pages), file size:%.2f Kb, page size:%.2f "
742
      "Kb, %s\n",
743
      pBuf->totalBufSize / 1024.0, pBuf->numOfPages, listNEles(pBuf->lruList) * pBuf->pageSize / 1024.0,
744
      listNEles(pBuf->lruList), pBuf->fileSize / 1024.0, pBuf->pageSize / 1024.0f, pBuf->id);
745
#endif
746

747
  if (ps->loadPages > 0) {
29,381,886✔
748
    (void)printf(
9,688✔
749
        "Get/Release pages:%d/%d, flushToDisk:%.2f Kb (%d Pages), loadFromDisk:%.2f Kb (%d Pages), avgPageSize:%.2f "
750
        "Kb\n",
751
        ps->getPages, ps->releasePages, ps->flushBytes / 1024.0f, ps->flushPages, ps->loadBytes / 1024.0f,
9,688✔
752
        ps->loadPages, ps->loadBytes / (1024.0 * ps->loadPages));
9,688✔
753
  } else {
754
    // printf("no page loaded\n");
755
  }
756
}
757

758
void clearDiskbasedBuf(SDiskbasedBuf* pBuf) {
7,384,542✔
759
  size_t n = taosArrayGetSize(pBuf->pIdList);
7,384,542✔
760
  for (int32_t i = 0; i < n; ++i) {
129,340,396✔
761
    SPageInfo* pi = taosArrayGetP(pBuf->pIdList, i);
121,955,492✔
762
    taosMemoryFreeClear(pi->pData);
121,955,854✔
763
    taosMemoryFreeClear(pi);
121,955,425✔
764
  }
765

766
  taosArrayClear(pBuf->pIdList);
7,384,904✔
767

768
  tdListEmpty(pBuf->lruList);
7,384,904✔
769
  tdListEmpty(pBuf->freePgList);
7,384,904✔
770

771
  taosArrayClear(pBuf->emptyDummyIdList);
7,384,904✔
772
  taosArrayClear(pBuf->pFree);
7,384,904✔
773

774
  tSimpleHashClear(pBuf->all);
7,384,904✔
775

776
  pBuf->numOfPages = 0;  // all pages are in buffer in the first place
7,384,904✔
777
  pBuf->totalBufSize = 0;
7,384,904✔
778
  pBuf->allocateId = -1;
7,384,904✔
779
  pBuf->fileSize = 0;
7,384,904✔
780
}
7,384,542✔
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc