#4696

Committed 29 Aug 2025 06:36AM UTC coverage: 58.25% (+0.2%) from 58.041%

Build # #4696

Build Type

push

travis-ci

Committed by

web-flow

Commit Message

fix(gpt): fix race-condition in preparing tmp files (#32800)

Run Details

133424 of 291873 branches covered (45.71%)

Branch coverage included in aggregate %.

5 of 34 new or added lines in 6 files covered. (14.71%)

444 existing lines in 69 files now uncovered.

201767 of 283561 relevant lines covered (71.15%)

17907122.76 hits per line

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

54.72

/source/libs/executor/src/dataDispatcher.c

/*
 * Copyright (c) 2019 TAOS Data, Inc. <jhtao@taosdata.com>
 *
 * This program is free software: you can use, redistribute, and/or modify
 * it under the terms of the GNU Affero General Public License, version 3
 * or later ("AGPL"), as published by the Free Software Foundation.
 *
 * 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.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
 */

#include "dataSinkInt.h"
#include "dataSinkMgt.h"
#include "executorInt.h"
#include "planner.h"
#include "tcompression.h"
#include "tdatablock.h"
#include "tglobal.h"
#include "tqueue.h"

extern SDataSinkStat gDataSinkStat;

typedef struct SDataDispatchBuf {
  int32_t useSize;
  int32_t allocSize;
  char*   pData;
} SDataDispatchBuf;

typedef struct SDataCacheEntry {
  int32_t rawLen;
  int32_t dataLen;
  int32_t numOfRows;
  int32_t numOfCols;
  int8_t  compressed;
  char    data[];
} SDataCacheEntry;

typedef struct SDataDispatchHandle {
  SDataSinkHandle     sink;
  SDataSinkManager*   pManager;
  SDataBlockDescNode* pSchema;
  SDataSinkNode*      pSinkNode;
  STaosQueue*         pDataBlocks;
  SDataDispatchBuf    nextOutput;
  int32_t             outPutColCounts;
  int32_t             status;
  bool                queryEnd;
  uint64_t            useconds;
  uint64_t            cachedSize;
  uint64_t            flags;
  void*               pCompressBuf;
  int32_t             bufSize;
  TdThreadMutex       mutex;
} SDataDispatchHandle;

static int32_t inputSafetyCheck(SDataDispatchHandle* pHandle, const SInputData* pInput)  {
  if(tsSafetyCheckLevel == TSDB_SAFETY_CHECK_LEVELL_NEVER) {
    return TSDB_CODE_SUCCESS;
  }
  if (pInput == NULL || pInput->pData == NULL || pInput->pData->info.rows <= 0) {
    qError("invalid input data");
    return TSDB_CODE_QRY_INVALID_INPUT;
  }
  SDataBlockDescNode* pSchema = pHandle->pSchema;
  if (pSchema == NULL || pSchema->totalRowSize != pInput->pData->info.rowSize) {
    qError("invalid schema");
    return TSDB_CODE_QRY_INVALID_INPUT;
  }

  if (pHandle->outPutColCounts > taosArrayGetSize(pInput->pData->pDataBlock)) {
    qError("invalid column number, schema:%d, input:%zu", pHandle->outPutColCounts, taosArrayGetSize(pInput->pData->pDataBlock));
    return TSDB_CODE_QRY_INVALID_INPUT;
  }

  SNode*  pNode;
  int32_t colNum = 0;
  FOREACH(pNode, pHandle->pSchema->pSlots) {
    SSlotDescNode* pSlotDesc = (SSlotDescNode*)pNode;
    if (pSlotDesc->output) {
      SColumnInfoData* pColInfoData = taosArrayGet(pInput->pData->pDataBlock, colNum);
      if (pColInfoData == NULL) {
        return -1;
      }
      if (pColInfoData->info.bytes < 0) {
        qError("invalid column bytes, schema:%d, input:%d", pSlotDesc->dataType.bytes, pColInfoData->info.bytes);
        return TSDB_CODE_TSC_INTERNAL_ERROR;
      }
      if (!IS_VAR_DATA_TYPE(pColInfoData->info.type) &&
          TYPE_BYTES[pColInfoData->info.type] != pColInfoData->info.bytes) {
        qError("invalid column bytes, schema:%d, input:%d", TYPE_BYTES[pColInfoData->info.type],
               pColInfoData->info.bytes);
        return TSDB_CODE_TSC_INTERNAL_ERROR;
      }
      if (pColInfoData->info.type != pSlotDesc->dataType.type) {
        qError("invalid column type, schema:%d, input:%d", pSlotDesc->dataType.type, pColInfoData->info.type);
        return TSDB_CODE_QRY_INVALID_INPUT;
      }
      if (pColInfoData->info.bytes != pSlotDesc->dataType.bytes) {
        qError("invalid column bytes, schema:%d, input:%d", pSlotDesc->dataType.bytes, pColInfoData->info.bytes);
        return TSDB_CODE_QRY_INVALID_INPUT;
      }

      if (IS_INVALID_TYPE(pColInfoData->info.type)) {
        qError("invalid column type, type:%d", pColInfoData->info.type);
        return TSDB_CODE_TSC_INTERNAL_ERROR;
      }
      ++colNum;
    }
  }


  return TSDB_CODE_SUCCESS;
}

// clang-format off
// data format:
// +----------------+------------------+--------------+--------------+------------------+--------------------------------------------+------------------------------------+-------------+-----------+-------------+-----------+
// |SDataCacheEntry |  version         | total length | numOfRows    |     group id     | col1_schema | col2_schema | col3_schema... | column#1 length, column#2 length...| col1 bitmap | col1 data | col2 bitmap | col2 data |
// |                |  sizeof(int32_t) |sizeof(int32) | sizeof(int32)| sizeof(uint64_t) | (sizeof(int8_t)+sizeof(int32_t))*numOfCols | sizeof(int32_t) * numOfCols        | actual size |           |                         |
// +----------------+------------------+--------------+--------------+------------------+--------------------------------------------+------------------------------------+-------------+-----------+-------------+-----------+
// The length of bitmap is decided by number of rows of this data block, and the length of each column data is
// recorded in the first segment, next to the struct header
// clang-format on
static int32_t toDataCacheEntry(SDataDispatchHandle* pHandle, const SInputData* pInput, SDataDispatchBuf* pBuf) {
  int32_t numOfCols = 0;
  SNode*  pNode;

  int32_t code = inputSafetyCheck(pHandle, pInput);
  if (code) {
    qError("failed to check input data, code:%d", code);
    return code;
  }

  FOREACH(pNode, pHandle->pSchema->pSlots) {
    SSlotDescNode* pSlotDesc = (SSlotDescNode*)pNode;
    if (pSlotDesc->output) {
      ++numOfCols;
    }
  }

  SDataCacheEntry* pEntry = (SDataCacheEntry*)pBuf->pData;
  pEntry->compressed = 0;
  pEntry->numOfRows = pInput->pData->info.rows;
  pEntry->numOfCols = numOfCols;
  pEntry->dataLen = 0;
  pEntry->rawLen = 0;

  pBuf->useSize = sizeof(SDataCacheEntry);

  {
    // allocate additional 8 bytes to avoid invalid write if compress failed to reduce the size
    size_t dataEncodeBufSize = pBuf->allocSize + 8;
    if ((pBuf->allocSize > tsCompressMsgSize) && (tsCompressMsgSize > 0) && pHandle->pManager->cfg.compress) {
      if (pHandle->pCompressBuf == NULL) {
        pHandle->pCompressBuf = taosMemoryMalloc(dataEncodeBufSize);
        if (NULL == pHandle->pCompressBuf) {
          QRY_RET(terrno);
        }
        pHandle->bufSize = dataEncodeBufSize;
      } else {
        if (pHandle->bufSize < dataEncodeBufSize) {
          pHandle->bufSize = dataEncodeBufSize;
          void* p = taosMemoryRealloc(pHandle->pCompressBuf, pHandle->bufSize);
          if (p != NULL) {
            pHandle->pCompressBuf = p;
          } else {
            qError("failed to prepare compress buf:%d, code: %x", pHandle->bufSize, terrno);
            return terrno;
          }
        }
      }

      int32_t dataLen = blockEncode(pInput->pData, pHandle->pCompressBuf, dataEncodeBufSize, numOfCols);
      if(dataLen < 0) {
        qError("failed to encode data block, code: %d", dataLen);
        return terrno;
      }
      int32_t len =
          tsCompressString(pHandle->pCompressBuf, dataLen, 1, pEntry->data, pBuf->allocSize, ONE_STAGE_COMP, NULL, 0);
      if (len < dataLen) {
        pEntry->compressed = 1;
        pEntry->dataLen = len;
        pEntry->rawLen = dataLen;
      } else {  // no need to compress data
        pEntry->compressed = 0;
        pEntry->dataLen = dataLen;
        pEntry->rawLen = dataLen;
        TAOS_MEMCPY(pEntry->data, pHandle->pCompressBuf, dataLen);
      }
    } else {
      pEntry->dataLen = blockEncode(pInput->pData, pEntry->data,  pBuf->allocSize, numOfCols);
      if(pEntry->dataLen < 0) {
        qError("failed to encode data block, code: %d", pEntry->dataLen);
        return terrno;
      }
      pEntry->rawLen = pEntry->dataLen;
    }
  }

  pBuf->useSize += pEntry->dataLen;

  (void)atomic_add_fetch_64(&pHandle->cachedSize, pEntry->dataLen);
  (void)atomic_add_fetch_64(&gDataSinkStat.cachedSize, pEntry->dataLen);

  return TSDB_CODE_SUCCESS;
}

static int32_t allocBuf(SDataDispatchHandle* pDispatcher, const SInputData* pInput, SDataDispatchBuf* pBuf) {
  /*
    uint32_t capacity = pDispatcher->pManager->cfg.maxDataBlockNumPerQuery;
    if (taosQueueItemSize(pDispatcher->pDataBlocks) > capacity) {
      qError("SinkNode queue is full, no capacity, max:%d, current:%d, no capacity", capacity,
             taosQueueItemSize(pDispatcher->pDataBlocks));
      return false;
    }
  */

  pBuf->allocSize = sizeof(SDataCacheEntry) + blockGetEncodeSize(pInput->pData);

  pBuf->pData = taosMemoryMalloc(pBuf->allocSize);
  if (pBuf->pData == NULL) {
    qError("SinkNode failed to malloc memory, size:%d, code:%x", pBuf->allocSize, terrno);
    return terrno;
  }

  return TSDB_CODE_SUCCESS;
}

static int32_t updateStatus(SDataDispatchHandle* pDispatcher) {
  (void)taosThreadMutexLock(&pDispatcher->mutex);
  int32_t blockNums = taosQueueItemSize(pDispatcher->pDataBlocks);
  int32_t status =
      (0 == blockNums ? DS_BUF_EMPTY
                      : (blockNums < pDispatcher->pManager->cfg.maxDataBlockNumPerQuery ? DS_BUF_LOW : DS_BUF_FULL));
  pDispatcher->status = status;
  (void)taosThreadMutexUnlock(&pDispatcher->mutex);
  return status;
}

static int32_t getStatus(SDataDispatchHandle* pDispatcher) {
  (void)taosThreadMutexLock(&pDispatcher->mutex);
  int32_t status = pDispatcher->status;
  (void)taosThreadMutexUnlock(&pDispatcher->mutex);
  return status;
}

static int32_t putDataBlock(SDataSinkHandle* pHandle, const SInputData* pInput, bool* pContinue) {
  int32_t              code = 0;
  SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;
  SDataDispatchBuf*    pBuf = NULL;

  code = taosAllocateQitem(sizeof(SDataDispatchBuf), DEF_QITEM, 0, (void**)&pBuf);
  if (code) {
    return code;
  }

  code = allocBuf(pDispatcher, pInput, pBuf);
  if (code) {
    taosFreeQitem(pBuf);
    return code;
  }

  QRY_ERR_JRET(toDataCacheEntry(pDispatcher, pInput, pBuf));
  QRY_ERR_JRET(taosWriteQitem(pDispatcher->pDataBlocks, pBuf));

  int32_t status = updateStatus(pDispatcher);
  *pContinue = (status == DS_BUF_LOW || status == DS_BUF_EMPTY) && !(pDispatcher->flags & DS_FLAG_PROCESS_ONE_BLOCK);
  return TSDB_CODE_SUCCESS;

_return:

  taosMemoryFreeClear(pBuf->pData);
  taosFreeQitem(pBuf);
  return code;
}

static void endPut(struct SDataSinkHandle* pHandle, uint64_t useconds) {
  SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;
  (void)taosThreadMutexLock(&pDispatcher->mutex);
  pDispatcher->queryEnd = true;
  pDispatcher->useconds = useconds;
  (void)taosThreadMutexUnlock(&pDispatcher->mutex);
}

static void resetDispatcher(struct SDataSinkHandle* pHandle) {
  SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;
  (void)taosThreadMutexLock(&pDispatcher->mutex);
  pDispatcher->queryEnd = false;
  (void)taosThreadMutexUnlock(&pDispatcher->mutex);
}

static void getDataLength(SDataSinkHandle* pHandle, int64_t* pLen, int64_t* pRowLen, bool* pQueryEnd) {
  SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;
  if (taosQueueEmpty(pDispatcher->pDataBlocks)) {
    *pQueryEnd = pDispatcher->queryEnd;
    *pLen = 0;
    return;
  }

  SDataDispatchBuf* pBuf = NULL;
  taosReadQitem(pDispatcher->pDataBlocks, (void**)&pBuf);
  if (pBuf != NULL) {
    TAOS_MEMCPY(&pDispatcher->nextOutput, pBuf, sizeof(SDataDispatchBuf));
    taosFreeQitem(pBuf);
  }

  SDataCacheEntry* pEntry = (SDataCacheEntry*)pDispatcher->nextOutput.pData;
  *pLen = pEntry->dataLen;
  *pRowLen = pEntry->rawLen;

  *pQueryEnd = pDispatcher->queryEnd;
  qDebug("got data len %" PRId64 ", row num %d in sink", *pLen,
         ((SDataCacheEntry*)(pDispatcher->nextOutput.pData))->numOfRows);
}

static int32_t getDataBlock(SDataSinkHandle* pHandle, SOutputData* pOutput) {
  SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;
  if (NULL == pDispatcher->nextOutput.pData) {
    if (!pDispatcher->queryEnd) {
      qError("empty res while query not end in data dispatcher");
      return TSDB_CODE_QRY_EXECUTOR_INTERNAL_ERROR;
    }

    pOutput->useconds = pDispatcher->useconds;
    pOutput->precision = pDispatcher->pSchema->precision;
    pOutput->bufStatus = DS_BUF_EMPTY;
    pOutput->queryEnd = pDispatcher->queryEnd;
    return TSDB_CODE_SUCCESS;
  }

  SDataCacheEntry* pEntry = (SDataCacheEntry*)(pDispatcher->nextOutput.pData);
  TAOS_MEMCPY(pOutput->pData, pEntry->data, pEntry->dataLen);
  pOutput->numOfRows = pEntry->numOfRows;
  pOutput->numOfCols = pEntry->numOfCols;
  pOutput->compressed = pEntry->compressed;

  (void)atomic_sub_fetch_64(&pDispatcher->cachedSize, pEntry->dataLen);
  (void)atomic_sub_fetch_64(&gDataSinkStat.cachedSize, pEntry->dataLen);

  taosMemoryFreeClear(pDispatcher->nextOutput.pData);  // todo persistent
  pOutput->bufStatus = updateStatus(pDispatcher);
  
  (void)taosThreadMutexLock(&pDispatcher->mutex);
  pOutput->queryEnd = pDispatcher->queryEnd;
  pOutput->useconds = pDispatcher->useconds;
  pOutput->precision = pDispatcher->pSchema->precision;
  (void)taosThreadMutexUnlock(&pDispatcher->mutex);

  return TSDB_CODE_SUCCESS;
}

static int32_t destroyDataSinker(SDataSinkHandle* pHandle) {
  SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;
  (void)atomic_sub_fetch_64(&gDataSinkStat.cachedSize, pDispatcher->cachedSize);
  taosMemoryFreeClear(pDispatcher->nextOutput.pData);
  nodesDestroyNode((SNode*)pDispatcher->pSinkNode);

  while (!taosQueueEmpty(pDispatcher->pDataBlocks)) {
    SDataDispatchBuf* pBuf = NULL;
    taosReadQitem(pDispatcher->pDataBlocks, (void**)&pBuf);
    if (pBuf != NULL) {
      taosMemoryFreeClear(pBuf->pData);
      taosFreeQitem(pBuf);
    }
  }

  taosCloseQueue(pDispatcher->pDataBlocks);
  taosMemoryFreeClear(pDispatcher->pCompressBuf);
  pDispatcher->bufSize = 0;

  (void)taosThreadMutexDestroy(&pDispatcher->mutex);
  taosMemoryFree(pDispatcher->pManager);
  return TSDB_CODE_SUCCESS;
}

static int32_t getCacheSize(struct SDataSinkHandle* pHandle, uint64_t* size) {
  SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;

  *size = atomic_load_64(&pDispatcher->cachedSize);
  return TSDB_CODE_SUCCESS;
}

static int32_t getSinkFlags(struct SDataSinkHandle* pHandle, uint64_t* pFlags) {
  SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;

  *pFlags = atomic_load_64(&pDispatcher->flags);
  return TSDB_CODE_SUCCESS;
}

static int32_t blockDescNodeCheck(SDataBlockDescNode* pInputDataBlockDesc)  {
  if(tsSafetyCheckLevel == TSDB_SAFETY_CHECK_LEVELL_NEVER) {
    return TSDB_CODE_SUCCESS;
  }

  if (pInputDataBlockDesc == NULL) {
    qError("invalid schema");
    return TSDB_CODE_QRY_INVALID_INPUT;
  }

  SNode*  pNode;
  int32_t realOutputRowSize = 0;
  FOREACH(pNode, pInputDataBlockDesc->pSlots) {
    SSlotDescNode* pSlotDesc = (SSlotDescNode*)pNode;
    if (pSlotDesc->output) {
      realOutputRowSize += pSlotDesc->dataType.bytes;
    } else {
      // Slots must be sorted, and slots with 'output' set to true must come first
      break;
    }
  }
  if (realOutputRowSize !=  pInputDataBlockDesc->outputRowSize) {
    qError("invalid schema, realOutputRowSize:%d, outputRowSize:%d", realOutputRowSize, pInputDataBlockDesc->outputRowSize);
    return TSDB_CODE_QRY_INVALID_INPUT;
  }
  return TSDB_CODE_SUCCESS;
}

int32_t getOutputColCounts(SDataBlockDescNode* pInputDataBlockDesc) {
  if (pInputDataBlockDesc == NULL) {
    qError("invalid schema");
    return 0;
  }
  SNode*  pNode;
  int32_t numOfCols = 0;
  FOREACH(pNode, pInputDataBlockDesc->pSlots) {
    SSlotDescNode* pSlotDesc = (SSlotDescNode*)pNode;
    if (pSlotDesc->output) {
      ++numOfCols;
    } else {
      // Slots must be sorted, and slots with 'output' set to true must come first
      break;
    }
  }
  return numOfCols;
}

int32_t createDataDispatcher(SDataSinkManager* pManager, SDataSinkNode** ppDataSink, DataSinkHandle* pHandle, bool processOneBlock) {
  int32_t code;
  SDataSinkNode* pDataSink = *ppDataSink;
  code = blockDescNodeCheck(pDataSink->pInputDataBlockDesc);
  if (code) {
    qError("failed to check input data block desc, code:%d", code);
    goto _return;
  }

  SDataDispatchHandle* dispatcher = taosMemoryCalloc(1, sizeof(SDataDispatchHandle));
  if (NULL == dispatcher) {
    goto _return;
  }

  dispatcher->sink.fPut = putDataBlock;
  dispatcher->sink.fEndPut = endPut;
  dispatcher->sink.fReset = resetDispatcher;
  dispatcher->sink.fGetLen = getDataLength;
  dispatcher->sink.fGetData = getDataBlock;
  dispatcher->sink.fDestroy = destroyDataSinker;
  dispatcher->sink.fGetCacheSize = getCacheSize;
  dispatcher->sink.fGetFlags = getSinkFlags;
  dispatcher->pManager = pManager;
  pManager = NULL;
  dispatcher->pSchema = pDataSink->pInputDataBlockDesc;
  dispatcher->pSinkNode = pDataSink;
  *ppDataSink = NULL;
  dispatcher->outPutColCounts = getOutputColCounts(dispatcher->pSchema);
  dispatcher->status = DS_BUF_EMPTY;
  dispatcher->queryEnd = false;
  code = taosOpenQueue(&dispatcher->pDataBlocks);
  if (code) {
    terrno = code;
    goto _return;
  }
  code = taosThreadMutexInit(&dispatcher->mutex, NULL);
  if (code) {
    terrno = code;
    goto _return;
  }

  dispatcher->flags = DS_FLAG_USE_MEMPOOL;
  if (processOneBlock) {
    dispatcher->flags |= DS_FLAG_PROCESS_ONE_BLOCK;
  }

  *pHandle = dispatcher;
  return TSDB_CODE_SUCCESS;

_return:

  taosMemoryFree(pManager);
  
  if (dispatcher) {
    dsDestroyDataSinker(dispatcher);
  }

  nodesDestroyNode((SNode *)*ppDataSink);
  *ppDataSink = NULL;
  
  return terrno;
}

1	/*
2	* Copyright (c) 2019 TAOS Data, Inc. <jhtao@taosdata.com>
3	*
4	* This program is free software: you can use, redistribute, and/or modify
5	* it under the terms of the GNU Affero General Public License, version 3
6	* or later ("AGPL"), as published by the Free Software Foundation.
7	*
8	* This program is distributed in the hope that it will be useful, but WITHOUT
9	* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10	* FITNESS FOR A PARTICULAR PURPOSE.
11	*
12	* You should have received a copy of the GNU Affero General Public License
13	* along with this program. If not, see <http://www.gnu.org/licenses/>.
14	*/
15
16	#include "dataSinkInt.h"
17	#include "dataSinkMgt.h"
18	#include "executorInt.h"
19	#include "planner.h"
20	#include "tcompression.h"
21	#include "tdatablock.h"
22	#include "tglobal.h"
23	#include "tqueue.h"
24
25	extern SDataSinkStat gDataSinkStat;
26
27	typedef struct SDataDispatchBuf {
28	int32_t useSize;
29	int32_t allocSize;
30	char* pData;
31	} SDataDispatchBuf;
32
33	typedef struct SDataCacheEntry {
34	int32_t rawLen;
35	int32_t dataLen;
36	int32_t numOfRows;
37	int32_t numOfCols;
38	int8_t compressed;
39	char data[];
40	} SDataCacheEntry;
41
42	typedef struct SDataDispatchHandle {
43	SDataSinkHandle sink;
44	SDataSinkManager* pManager;
45	SDataBlockDescNode* pSchema;
46	SDataSinkNode* pSinkNode;
47	STaosQueue* pDataBlocks;
48	SDataDispatchBuf nextOutput;
49	int32_t outPutColCounts;
50	int32_t status;
51	bool queryEnd;
52	uint64_t useconds;
53	uint64_t cachedSize;
54	uint64_t flags;
55	void* pCompressBuf;
56	int32_t bufSize;
57	TdThreadMutex mutex;
58	} SDataDispatchHandle;
59
60	static int32_t inputSafetyCheck(SDataDispatchHandle* pHandle, const SInputData* pInput) {	15,641,481✔
61	if(tsSafetyCheckLevel == TSDB_SAFETY_CHECK_LEVELL_NEVER) {	15,641,481!
62	return TSDB_CODE_SUCCESS;	×
63	}
64	if (pInput == NULL \|\| pInput->pData == NULL \|\| pInput->pData->info.rows <= 0) {	15,641,481!
65	qError("invalid input data");	×
66	return TSDB_CODE_QRY_INVALID_INPUT;	×
67	}
68	SDataBlockDescNode* pSchema = pHandle->pSchema;	15,641,843✔
69	if (pSchema == NULL \|\| pSchema->totalRowSize != pInput->pData->info.rowSize) {	15,641,843!
UNCOV 70	qError("invalid schema");	×
71	return TSDB_CODE_QRY_INVALID_INPUT;	×
72	}
73
74	if (pHandle->outPutColCounts > taosArrayGetSize(pInput->pData->pDataBlock)) {	15,642,273!
UNCOV 75	qError("invalid column number, schema:%d, input:%zu", pHandle->outPutColCounts, taosArrayGetSize(pInput->pData->pDataBlock));	×
76	return TSDB_CODE_QRY_INVALID_INPUT;	×
77	}
78
79	SNode* pNode;
80	int32_t colNum = 0;	15,639,690✔
81	FOREACH(pNode, pHandle->pSchema->pSlots) {	66,955,690!
82	SSlotDescNode* pSlotDesc = (SSlotDescNode*)pNode;	51,324,184✔
83	if (pSlotDesc->output) {	51,324,184✔
84	SColumnInfoData* pColInfoData = taosArrayGet(pInput->pData->pDataBlock, colNum);	50,704,894✔
85	if (pColInfoData == NULL) {	50,695,099!
86	return -1;	×
87	}
88	if (pColInfoData->info.bytes < 0) {	50,695,099!
89	qError("invalid column bytes, schema:%d, input:%d", pSlotDesc->dataType.bytes, pColInfoData->info.bytes);	×
90	return TSDB_CODE_TSC_INTERNAL_ERROR;	×
91	}
92	if (!IS_VAR_DATA_TYPE(pColInfoData->info.type) &&	50,695,099!
93	TYPE_BYTES[pColInfoData->info.type] != pColInfoData->info.bytes) {	41,067,804!
94	qError("invalid column bytes, schema:%d, input:%d", TYPE_BYTES[pColInfoData->info.type],	×
95	pColInfoData->info.bytes);
96	return TSDB_CODE_TSC_INTERNAL_ERROR;	×
97	}
98	if (pColInfoData->info.type != pSlotDesc->dataType.type) {	50,695,099!
99	qError("invalid column type, schema:%d, input:%d", pSlotDesc->dataType.type, pColInfoData->info.type);	×
100	return TSDB_CODE_QRY_INVALID_INPUT;	×
101	}
102	if (pColInfoData->info.bytes != pSlotDesc->dataType.bytes) {	50,695,099!
103	qError("invalid column bytes, schema:%d, input:%d", pSlotDesc->dataType.bytes, pColInfoData->info.bytes);	×
104	return TSDB_CODE_QRY_INVALID_INPUT;	×
105	}
106
107	if (IS_INVALID_TYPE(pColInfoData->info.type)) {	50,695,099!
108	qError("invalid column type, type:%d", pColInfoData->info.type);	×
109	return TSDB_CODE_TSC_INTERNAL_ERROR;	×
110	}
111	++colNum;	50,696,710✔
112	}
113	}
114
115
116	return TSDB_CODE_SUCCESS;	15,631,506✔
117	}
118
119	// clang-format off
120	// data format:
121	// +----------------+------------------+--------------+--------------+------------------+--------------------------------------------+------------------------------------+-------------+-----------+-------------+-----------+
122	// \|SDataCacheEntry \| version \| total length \| numOfRows \| group id \| col1_schema \| col2_schema \| col3_schema... \| column#1 length, column#2 length...\| col1 bitmap \| col1 data \| col2 bitmap \| col2 data \|
123	// \| \| sizeof(int32_t) \|sizeof(int32) \| sizeof(int32)\| sizeof(uint64_t) \| (sizeof(int8_t)+sizeof(int32_t))numOfCols \| sizeof(int32_t) numOfCols \| actual size \| \| \|
124	// +----------------+------------------+--------------+--------------+------------------+--------------------------------------------+------------------------------------+-------------+-----------+-------------+-----------+
125	// The length of bitmap is decided by number of rows of this data block, and the length of each column data is
126	// recorded in the first segment, next to the struct header
127	// clang-format on
128	static int32_t toDataCacheEntry(SDataDispatchHandle* pHandle, const SInputData* pInput, SDataDispatchBuf* pBuf) {	15,641,586✔
129	int32_t numOfCols = 0;	15,641,586✔
130	SNode* pNode;
131
132	int32_t code = inputSafetyCheck(pHandle, pInput);	15,641,586✔
133	if (code) {	15,635,872!
134	qError("failed to check input data, code:%d", code);	×
135	return code;	×
136	}
137
138	FOREACH(pNode, pHandle->pSchema->pSlots) {	67,018,287!
139	SSlotDescNode* pSlotDesc = (SSlotDescNode*)pNode;	51,382,218✔
140	if (pSlotDesc->output) {	51,382,218✔
141	++numOfCols;	50,761,573✔
142	}
143	}
144
145	SDataCacheEntry* pEntry = (SDataCacheEntry*)pBuf->pData;	15,636,069✔
146	pEntry->compressed = 0;	15,636,069✔
147	pEntry->numOfRows = pInput->pData->info.rows;	15,636,069✔
148	pEntry->numOfCols = numOfCols;	15,636,069✔
149	pEntry->dataLen = 0;	15,636,069✔
150	pEntry->rawLen = 0;	15,636,069✔
151
152	pBuf->useSize = sizeof(SDataCacheEntry);	15,636,069✔
153
154	{
155	// allocate additional 8 bytes to avoid invalid write if compress failed to reduce the size
156	size_t dataEncodeBufSize = pBuf->allocSize + 8;	15,636,069✔
157	if ((pBuf->allocSize > tsCompressMsgSize) && (tsCompressMsgSize > 0) && pHandle->pManager->cfg.compress) {	15,636,069!
158	if (pHandle->pCompressBuf == NULL) {	×
159	pHandle->pCompressBuf = taosMemoryMalloc(dataEncodeBufSize);	×
160	if (NULL == pHandle->pCompressBuf) {	×
161	QRY_RET(terrno);	×
162	}
163	pHandle->bufSize = dataEncodeBufSize;	×
164	} else {
165	if (pHandle->bufSize < dataEncodeBufSize) {	×
166	pHandle->bufSize = dataEncodeBufSize;	×
167	void* p = taosMemoryRealloc(pHandle->pCompressBuf, pHandle->bufSize);	×
168	if (p != NULL) {	×
169	pHandle->pCompressBuf = p;	×
170	} else {
171	qError("failed to prepare compress buf:%d, code: %x", pHandle->bufSize, terrno);	×
172	return terrno;	×
173	}
174	}
175	}
176
177	int32_t dataLen = blockEncode(pInput->pData, pHandle->pCompressBuf, dataEncodeBufSize, numOfCols);	×
178	if(dataLen < 0) {	×
179	qError("failed to encode data block, code: %d", dataLen);	×
180	return terrno;	×
181	}
182	int32_t len =
183	tsCompressString(pHandle->pCompressBuf, dataLen, 1, pEntry->data, pBuf->allocSize, ONE_STAGE_COMP, NULL, 0);	×
184	if (len < dataLen) {	×
185	pEntry->compressed = 1;	×
186	pEntry->dataLen = len;	×
187	pEntry->rawLen = dataLen;	×
188	} else { // no need to compress data
189	pEntry->compressed = 0;	×
190	pEntry->dataLen = dataLen;	×
191	pEntry->rawLen = dataLen;	×
192	TAOS_MEMCPY(pEntry->data, pHandle->pCompressBuf, dataLen);	×
193	}
194	} else {
195	pEntry->dataLen = blockEncode(pInput->pData, pEntry->data, pBuf->allocSize, numOfCols);	15,636,069✔
196	if(pEntry->dataLen < 0) {	15,640,522!
197	qError("failed to encode data block, code: %d", pEntry->dataLen);	×
198	return terrno;	×
199	}
200	pEntry->rawLen = pEntry->dataLen;	15,641,573✔
201	}
202	}
203
204	pBuf->useSize += pEntry->dataLen;	15,641,573✔
205
206	(void)atomic_add_fetch_64(&pHandle->cachedSize, pEntry->dataLen);	15,641,573✔
207	(void)atomic_add_fetch_64(&gDataSinkStat.cachedSize, pEntry->dataLen);	15,643,965✔
208
209	return TSDB_CODE_SUCCESS;	15,644,161✔
210	}
211
212	static int32_t allocBuf(SDataDispatchHandle* pDispatcher, const SInputData* pInput, SDataDispatchBuf* pBuf) {	15,642,874✔
213	/*
214	uint32_t capacity = pDispatcher->pManager->cfg.maxDataBlockNumPerQuery;
215	if (taosQueueItemSize(pDispatcher->pDataBlocks) > capacity) {
216	qError("SinkNode queue is full, no capacity, max:%d, current:%d, no capacity", capacity,
217	taosQueueItemSize(pDispatcher->pDataBlocks));
218	return false;
219	}
220	*/
221
222	pBuf->allocSize = sizeof(SDataCacheEntry) + blockGetEncodeSize(pInput->pData);	15,642,874✔
223
224	pBuf->pData = taosMemoryMalloc(pBuf->allocSize);	15,635,613!
225	if (pBuf->pData == NULL) {	15,641,718!
226	qError("SinkNode failed to malloc memory, size:%d, code:%x", pBuf->allocSize, terrno);	×
227	return terrno;	×
228	}
229
230	return TSDB_CODE_SUCCESS;	15,641,718✔
231	}
232
233	static int32_t updateStatus(SDataDispatchHandle* pDispatcher) {	30,937,352✔
234	(void)taosThreadMutexLock(&pDispatcher->mutex);	30,937,352✔
235	int32_t blockNums = taosQueueItemSize(pDispatcher->pDataBlocks);	30,941,803✔
236	int32_t status =	30,942,441✔
237	(0 == blockNums ? DS_BUF_EMPTY
238	: (blockNums < pDispatcher->pManager->cfg.maxDataBlockNumPerQuery ? DS_BUF_LOW : DS_BUF_FULL));	30,942,441✔
239	pDispatcher->status = status;	30,942,441✔
240	(void)taosThreadMutexUnlock(&pDispatcher->mutex);	30,942,441✔
241	return status;	30,942,488✔
242	}
243
244	static int32_t getStatus(SDataDispatchHandle* pDispatcher) {	×
245	(void)taosThreadMutexLock(&pDispatcher->mutex);	×
246	int32_t status = pDispatcher->status;	×
247	(void)taosThreadMutexUnlock(&pDispatcher->mutex);	×
248	return status;	×
249	}
250
251	static int32_t putDataBlock(SDataSinkHandle* pHandle, const SInputData* pInput, bool* pContinue) {	15,640,955✔
252	int32_t code = 0;	15,640,955✔
253	SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;	15,640,955✔
254	SDataDispatchBuf* pBuf = NULL;	15,640,955✔
255
256	code = taosAllocateQitem(sizeof(SDataDispatchBuf), DEF_QITEM, 0, (void**)&pBuf);	15,640,955✔
257	if (code) {	15,643,020!
258	return code;	×
259	}
260
261	code = allocBuf(pDispatcher, pInput, pBuf);	15,643,020✔
262	if (code) {	15,641,677!
263	taosFreeQitem(pBuf);	×
264	return code;	×
265	}
266
267	QRY_ERR_JRET(toDataCacheEntry(pDispatcher, pInput, pBuf));	15,641,677!
268	QRY_ERR_JRET(taosWriteQitem(pDispatcher->pDataBlocks, pBuf));	15,644,132!
269
270	int32_t status = updateStatus(pDispatcher);	15,643,205✔
271	*pContinue = (status == DS_BUF_LOW \|\| status == DS_BUF_EMPTY) && !(pDispatcher->flags & DS_FLAG_PROCESS_ONE_BLOCK);	15,643,804!
272	return TSDB_CODE_SUCCESS;	15,643,804✔
273
274	_return:	×
275
276	taosMemoryFreeClear(pBuf->pData);	×
277	taosFreeQitem(pBuf);	×
278	return code;	×
279	}
280
281	static void endPut(struct SDataSinkHandle* pHandle, uint64_t useconds) {	8,009,951✔
282	SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;	8,009,951✔
283	(void)taosThreadMutexLock(&pDispatcher->mutex);	8,009,951✔
284	pDispatcher->queryEnd = true;	8,012,036✔
285	pDispatcher->useconds = useconds;	8,012,036✔
286	(void)taosThreadMutexUnlock(&pDispatcher->mutex);	8,012,036✔
287	}	8,011,898✔
288
289	static void resetDispatcher(struct SDataSinkHandle* pHandle) {	1,306✔
290	SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;	1,306✔
291	(void)taosThreadMutexLock(&pDispatcher->mutex);	1,306✔
292	pDispatcher->queryEnd = false;	1,306✔
293	(void)taosThreadMutexUnlock(&pDispatcher->mutex);	1,306✔
294	}	1,306✔
295
296	static void getDataLength(SDataSinkHandle* pHandle, int64_t* pLen, int64_t* pRowLen, bool* pQueryEnd) {	17,872,991✔
297	SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;	17,872,991✔
298	if (taosQueueEmpty(pDispatcher->pDataBlocks)) {	17,872,991✔
299	*pQueryEnd = pDispatcher->queryEnd;	2,583,808✔
300	*pLen = 0;	2,583,808✔
301	return;	2,583,808✔
302	}
303
304	SDataDispatchBuf* pBuf = NULL;	15,297,020✔
305	taosReadQitem(pDispatcher->pDataBlocks, (void**)&pBuf);	15,297,020✔
306	if (pBuf != NULL) {	15,298,736!
307	TAOS_MEMCPY(&pDispatcher->nextOutput, pBuf, sizeof(SDataDispatchBuf));	15,298,797✔
308	taosFreeQitem(pBuf);	15,298,797✔
309	}
310
311	SDataCacheEntry* pEntry = (SDataCacheEntry*)pDispatcher->nextOutput.pData;	15,295,864✔
312	*pLen = pEntry->dataLen;	15,295,864✔
313	*pRowLen = pEntry->rawLen;	15,295,864✔
314
315	*pQueryEnd = pDispatcher->queryEnd;	15,295,864✔
316	qDebug("got data len %" PRId64 ", row num %d in sink", *pLen,	15,295,864✔
317	((SDataCacheEntry*)(pDispatcher->nextOutput.pData))->numOfRows);
318	}
319
320	static int32_t getDataBlock(SDataSinkHandle* pHandle, SOutputData* pOutput) {	17,397,995✔
321	SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;	17,397,995✔
322	if (NULL == pDispatcher->nextOutput.pData) {	17,397,995✔
323	if (!pDispatcher->queryEnd) {	2,104,765!
324	qError("empty res while query not end in data dispatcher");	×
325	return TSDB_CODE_QRY_EXECUTOR_INTERNAL_ERROR;	×
326	}
327
328	pOutput->useconds = pDispatcher->useconds;	2,104,765✔
329	pOutput->precision = pDispatcher->pSchema->precision;	2,104,765✔
330	pOutput->bufStatus = DS_BUF_EMPTY;	2,104,765✔
331	pOutput->queryEnd = pDispatcher->queryEnd;	2,104,765✔
332	return TSDB_CODE_SUCCESS;	2,104,765✔
333	}
334
335	SDataCacheEntry* pEntry = (SDataCacheEntry*)(pDispatcher->nextOutput.pData);	15,293,230✔
336	TAOS_MEMCPY(pOutput->pData, pEntry->data, pEntry->dataLen);	15,293,230✔
337	pOutput->numOfRows = pEntry->numOfRows;	15,293,230✔
338	pOutput->numOfCols = pEntry->numOfCols;	15,293,230✔
339	pOutput->compressed = pEntry->compressed;	15,293,230✔
340
341	(void)atomic_sub_fetch_64(&pDispatcher->cachedSize, pEntry->dataLen);	15,293,230✔
342	(void)atomic_sub_fetch_64(&gDataSinkStat.cachedSize, pEntry->dataLen);	15,299,342✔
343
344	taosMemoryFreeClear(pDispatcher->nextOutput.pData); // todo persistent	15,299,409!
345	pOutput->bufStatus = updateStatus(pDispatcher);	15,296,778✔
346
347	(void)taosThreadMutexLock(&pDispatcher->mutex);	15,298,890✔
348	pOutput->queryEnd = pDispatcher->queryEnd;	15,298,893✔
349	pOutput->useconds = pDispatcher->useconds;	15,298,893✔
350	pOutput->precision = pDispatcher->pSchema->precision;	15,298,893✔
351	(void)taosThreadMutexUnlock(&pDispatcher->mutex);	15,298,893✔
352
353	return TSDB_CODE_SUCCESS;	15,298,965✔
354	}
355
356	static int32_t destroyDataSinker(SDataSinkHandle* pHandle) {	8,043,622✔
357	SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;	8,043,622✔
358	(void)atomic_sub_fetch_64(&gDataSinkStat.cachedSize, pDispatcher->cachedSize);	8,043,622✔
359	taosMemoryFreeClear(pDispatcher->nextOutput.pData);	8,047,243!
360	nodesDestroyNode((SNode*)pDispatcher->pSinkNode);	8,047,243✔
361
362	while (!taosQueueEmpty(pDispatcher->pDataBlocks)) {	8,387,831✔
363	SDataDispatchBuf* pBuf = NULL;	343,422✔
364	taosReadQitem(pDispatcher->pDataBlocks, (void**)&pBuf);	343,422✔
365	if (pBuf != NULL) {	343,427!
366	taosMemoryFreeClear(pBuf->pData);	343,427!
367	taosFreeQitem(pBuf);	343,425✔
368	}
369	}
370
371	taosCloseQueue(pDispatcher->pDataBlocks);	8,044,948✔
372	taosMemoryFreeClear(pDispatcher->pCompressBuf);	8,044,166!
373	pDispatcher->bufSize = 0;	8,044,166✔
374
375	(void)taosThreadMutexDestroy(&pDispatcher->mutex);	8,044,166✔
376	taosMemoryFree(pDispatcher->pManager);	8,042,402!
377	return TSDB_CODE_SUCCESS;	8,044,321✔
378	}
379
380	static int32_t getCacheSize(struct SDataSinkHandle* pHandle, uint64_t* size) {	×
381	SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;	×
382
383	*size = atomic_load_64(&pDispatcher->cachedSize);	×
384	return TSDB_CODE_SUCCESS;	×
385	}
386
387	static int32_t getSinkFlags(struct SDataSinkHandle* pHandle, uint64_t* pFlags) {	8,789,052✔
388	SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;	8,789,052✔
389
390	*pFlags = atomic_load_64(&pDispatcher->flags);	8,789,052✔
391	return TSDB_CODE_SUCCESS;	8,786,775✔
392	}
393
394	static int32_t blockDescNodeCheck(SDataBlockDescNode* pInputDataBlockDesc) {	8,029,194✔
395	if(tsSafetyCheckLevel == TSDB_SAFETY_CHECK_LEVELL_NEVER) {	8,029,194!
396	return TSDB_CODE_SUCCESS;	×
397	}
398
399	if (pInputDataBlockDesc == NULL) {	8,029,194!
400	qError("invalid schema");	×
401	return TSDB_CODE_QRY_INVALID_INPUT;	×
402	}
403
404	SNode* pNode;
405	int32_t realOutputRowSize = 0;	8,029,194✔
406	FOREACH(pNode, pInputDataBlockDesc->pSlots) {	42,401,787!
407	SSlotDescNode* pSlotDesc = (SSlotDescNode*)pNode;	34,723,980✔
408	if (pSlotDesc->output) {	34,723,980✔
409	realOutputRowSize += pSlotDesc->dataType.bytes;	34,372,593✔
410	} else {
411	// Slots must be sorted, and slots with 'output' set to true must come first
412	break;	351,387✔
413	}
414	}
415	if (realOutputRowSize != pInputDataBlockDesc->outputRowSize) {	8,029,194!
416	qError("invalid schema, realOutputRowSize:%d, outputRowSize:%d", realOutputRowSize, pInputDataBlockDesc->outputRowSize);	×
417	return TSDB_CODE_QRY_INVALID_INPUT;	×
418	}
419	return TSDB_CODE_SUCCESS;	8,029,194✔
420	}
421
422	int32_t getOutputColCounts(SDataBlockDescNode* pInputDataBlockDesc) {	8,039,871✔
423	if (pInputDataBlockDesc == NULL) {	8,039,871!
424	qError("invalid schema");	×
425	return 0;	×
426	}
427	SNode* pNode;
428	int32_t numOfCols = 0;	8,039,871✔
429	FOREACH(pNode, pInputDataBlockDesc->pSlots) {	42,415,452!
430	SSlotDescNode* pSlotDesc = (SSlotDescNode*)pNode;	34,726,961✔
431	if (pSlotDesc->output) {	34,726,961✔
432	++numOfCols;	34,375,581✔
433	} else {
434	// Slots must be sorted, and slots with 'output' set to true must come first
435	break;	351,380✔
436	}
437	}
438	return numOfCols;	8,039,871✔
439	}
440
441	int32_t createDataDispatcher(SDataSinkManager* pManager, SDataSinkNode** ppDataSink, DataSinkHandle* pHandle, bool processOneBlock) {	8,029,493✔
442	int32_t code;
443	SDataSinkNode* pDataSink = *ppDataSink;	8,029,493✔
444	code = blockDescNodeCheck(pDataSink->pInputDataBlockDesc);	8,029,493✔
445	if (code) {	8,045,069!
446	qError("failed to check input data block desc, code:%d", code);	×
447	goto _return;	×
448	}
449
450	SDataDispatchHandle* dispatcher = taosMemoryCalloc(1, sizeof(SDataDispatchHandle));	8,045,069!
451	if (NULL == dispatcher) {	8,036,285!
452	goto _return;	×
453	}
454
455	dispatcher->sink.fPut = putDataBlock;	8,036,285✔
456	dispatcher->sink.fEndPut = endPut;	8,036,285✔
457	dispatcher->sink.fReset = resetDispatcher;	8,036,285✔
458	dispatcher->sink.fGetLen = getDataLength;	8,036,285✔
459	dispatcher->sink.fGetData = getDataBlock;	8,036,285✔
460	dispatcher->sink.fDestroy = destroyDataSinker;	8,036,285✔
461	dispatcher->sink.fGetCacheSize = getCacheSize;	8,036,285✔
462	dispatcher->sink.fGetFlags = getSinkFlags;	8,036,285✔
463	dispatcher->pManager = pManager;	8,036,285✔
464	pManager = NULL;	8,036,285✔
465	dispatcher->pSchema = pDataSink->pInputDataBlockDesc;	8,036,285✔
466	dispatcher->pSinkNode = pDataSink;	8,036,285✔
467	*ppDataSink = NULL;	8,036,285✔
468	dispatcher->outPutColCounts = getOutputColCounts(dispatcher->pSchema);	8,036,285✔
469	dispatcher->status = DS_BUF_EMPTY;	8,043,814✔
470	dispatcher->queryEnd = false;	8,043,814✔
471	code = taosOpenQueue(&dispatcher->pDataBlocks);	8,043,814✔
472	if (code) {	8,038,464!
473	terrno = code;	×
474	goto _return;	×
475	}
476	code = taosThreadMutexInit(&dispatcher->mutex, NULL);	8,038,464✔
477	if (code) {	8,041,772!
478	terrno = code;	×
479	goto _return;	×
480	}
481
482	dispatcher->flags = DS_FLAG_USE_MEMPOOL;	8,042,622✔
483	if (processOneBlock) {	8,042,622✔
484	dispatcher->flags \|= DS_FLAG_PROCESS_ONE_BLOCK;	24✔
485	}
486
487	*pHandle = dispatcher;	8,042,622✔
488	return TSDB_CODE_SUCCESS;	8,042,622✔
489
490	_return:	×
491
492	taosMemoryFree(pManager);	×
493
494	if (dispatcher) {	×
495	dsDestroyDataSinker(dispatcher);	×
496	}
497
498	nodesDestroyNode((SNode )ppDataSink);	×
499	*ppDataSink = NULL;	×
500
501	return terrno;	×
502	}

taosdata / TDengine / #4696

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

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