#4103

Committed 17 May 2025 02:18AM UTC coverage: 63.264% (+0.4%) from 62.905%

Build # #4103

Build Type

push

travis-ci

Committed by

web-flow

Commit Message

Merge pull request #31110 from taosdata/3.0

merge 3.0

Run Details

158149 of 318142 branches covered (49.71%)

Branch coverage included in aggregate %.

3 of 5 new or added lines in 1 file covered. (60.0%)

1725 existing lines in 138 files now uncovered.

243642 of 316962 relevant lines covered (76.87%)

16346281.8 hits per line

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

55.3

/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) {	14,591,389✔
61	if(tsSafetyCheckLevel == TSDB_SAFETY_CHECK_LEVELL_NEVER) {	14,591,389!
62	return TSDB_CODE_SUCCESS;	×
63	}
64	if (pInput == NULL \|\| pInput->pData == NULL \|\| pInput->pData->info.rows <= 0) {	14,591,389!
65	qError("invalid input data");	×
66	return TSDB_CODE_QRY_INVALID_INPUT;	×
67	}
68	SDataBlockDescNode* pSchema = pHandle->pSchema;	14,592,379✔
69	if (pSchema == NULL \|\| pSchema->totalRowSize != pInput->pData->info.rowSize) {	14,592,379!
UNCOV 70	qError("invalid schema");	×
71	return TSDB_CODE_QRY_INVALID_INPUT;	×
72	}
73
74	if (pHandle->outPutColCounts > taosArrayGetSize(pInput->pData->pDataBlock)) {	14,592,937✔
75	qError("invalid column number, schema:%d, input:%zu", pHandle->outPutColCounts, taosArrayGetSize(pInput->pData->pDataBlock));	791!
76	return TSDB_CODE_QRY_INVALID_INPUT;	×
77	}
78
79	SNode* pNode;
80	int32_t colNum = 0;	14,589,803✔
81	FOREACH(pNode, pHandle->pSchema->pSlots) {	73,202,533!
82	SSlotDescNode* pSlotDesc = (SSlotDescNode*)pNode;	58,619,681✔
83	if (pSlotDesc->output) {	58,619,681✔
84	SColumnInfoData* pColInfoData = taosArrayGet(pInput->pData->pDataBlock, colNum);	57,994,050✔
85	if (pColInfoData == NULL) {	57,980,311!
86	return -1;	×
87	}
88	if (pColInfoData->info.bytes < 0) {	57,980,311!
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) &&	57,980,311!
93	TYPE_BYTES[pColInfoData->info.type] != pColInfoData->info.bytes) {	45,587,714!
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) {	57,980,311!
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) {	57,980,311!
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)) {	57,980,311!
108	qError("invalid column type, type:%d", pColInfoData->info.type);	×
109	return TSDB_CODE_TSC_INTERNAL_ERROR;	×
110	}
111	++colNum;	57,987,099✔
112	}
113	}
114
115
116	return TSDB_CODE_SUCCESS;	14,582,852✔
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) {	14,592,714✔
129	int32_t numOfCols = 0;	14,592,714✔
130	SNode* pNode;
131
132	int32_t code = inputSafetyCheck(pHandle, pInput);	14,592,714✔
133	if (code) {	14,549,800!
134	qError("failed to check input data, code:%d", code);	×
135	return code;	×
136	}
137
138	FOREACH(pNode, pHandle->pSchema->pSlots) {	73,435,640!
139	SSlotDescNode* pSlotDesc = (SSlotDescNode*)pNode;	58,883,799✔
140	if (pSlotDesc->output) {	58,883,799✔
141	++numOfCols;	58,257,072✔
142	}
143	}
144
145	SDataCacheEntry* pEntry = (SDataCacheEntry*)pBuf->pData;	14,551,841✔
146	pEntry->compressed = 0;	14,551,841✔
147	pEntry->numOfRows = pInput->pData->info.rows;	14,551,841✔
148	pEntry->numOfCols = numOfCols;	14,551,841✔
149	pEntry->dataLen = 0;	14,551,841✔
150	pEntry->rawLen = 0;	14,551,841✔
151
152	pBuf->useSize = sizeof(SDataCacheEntry);	14,551,841✔
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;	14,551,841✔
157	if ((pBuf->allocSize > tsCompressMsgSize) && (tsCompressMsgSize > 0) && pHandle->pManager->cfg.compress) {	14,551,841!
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);	14,551,841✔
196	if(pEntry->dataLen < 0) {	14,562,152!
197	qError("failed to encode data block, code: %d", pEntry->dataLen);	×
198	return terrno;	×
199	}
200	pEntry->rawLen = pEntry->dataLen;	14,564,953✔
201	}
202	}
203
204	pBuf->useSize += pEntry->dataLen;	14,564,953✔
205
206	(void)atomic_add_fetch_64(&pHandle->cachedSize, pEntry->dataLen);	14,564,953✔
207	(void)atomic_add_fetch_64(&gDataSinkStat.cachedSize, pEntry->dataLen);	14,600,763✔
208
209	return TSDB_CODE_SUCCESS;	14,599,299✔
210	}
211
212	static int32_t allocBuf(SDataDispatchHandle* pDispatcher, const SInputData* pInput, SDataDispatchBuf* pBuf) {	14,596,687✔
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);	14,596,687✔
223
224	pBuf->pData = taosMemoryMalloc(pBuf->allocSize);	14,539,990!
225	if (pBuf->pData == NULL) {	14,594,774!
226	qError("SinkNode failed to malloc memory, size:%d, code:%x", pBuf->allocSize, terrno);	×
227	return terrno;	×
228	}
229
230	return TSDB_CODE_SUCCESS;	14,594,774✔
231	}
232
233	static int32_t updateStatus(SDataDispatchHandle* pDispatcher) {	28,690,815✔
234	(void)taosThreadMutexLock(&pDispatcher->mutex);	28,690,815✔
235	int32_t blockNums = taosQueueItemSize(pDispatcher->pDataBlocks);	28,712,553✔
236	int32_t status =	28,717,591✔
237	(0 == blockNums ? DS_BUF_EMPTY
238	: (blockNums < pDispatcher->pManager->cfg.maxDataBlockNumPerQuery ? DS_BUF_LOW : DS_BUF_FULL));	28,717,591✔
239	pDispatcher->status = status;	28,717,591✔
240	(void)taosThreadMutexUnlock(&pDispatcher->mutex);	28,717,591✔
241	return status;	28,723,859✔
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) {	14,580,028✔
252	int32_t code = 0;	14,580,028✔
253	SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;	14,580,028✔
254	SDataDispatchBuf* pBuf = NULL;	14,580,028✔
255
256	code = taosAllocateQitem(sizeof(SDataDispatchBuf), DEF_QITEM, 0, (void**)&pBuf);	14,580,028✔
257	if (code) {	14,598,821!
258	return code;	×
259	}
260
261	code = allocBuf(pDispatcher, pInput, pBuf);	14,598,821✔
262	if (code) {	14,594,289!
263	taosFreeQitem(pBuf);	×
264	return code;	×
265	}
266
267	QRY_ERR_JRET(toDataCacheEntry(pDispatcher, pInput, pBuf));	14,594,289!
268	QRY_ERR_JRET(taosWriteQitem(pDispatcher->pDataBlocks, pBuf));	14,598,476!
269
270	int32_t status = updateStatus(pDispatcher);	14,601,544✔
271	*pContinue = (status == DS_BUF_LOW \|\| status == DS_BUF_EMPTY) && !(pDispatcher->flags & DS_FLAG_PROCESS_ONE_BLOCK);	14,602,490!
272	return TSDB_CODE_SUCCESS;	14,602,490✔
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,240,538✔
282	SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;	8,240,538✔
283	(void)taosThreadMutexLock(&pDispatcher->mutex);	8,240,538✔
284	pDispatcher->queryEnd = true;	8,243,304✔
285	pDispatcher->useconds = useconds;	8,243,304✔
286	(void)taosThreadMutexUnlock(&pDispatcher->mutex);	8,243,304✔
287	}	8,243,125✔
288
289	static void resetDispatcher(struct SDataSinkHandle* pHandle) {	1,281✔
290	SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;	1,281✔
291	(void)taosThreadMutexLock(&pDispatcher->mutex);	1,281✔
292	pDispatcher->queryEnd = false;	1,281✔
293	(void)taosThreadMutexUnlock(&pDispatcher->mutex);	1,281✔
294	}	1,281✔
295
296	static void getDataLength(SDataSinkHandle* pHandle, int64_t* pLen, int64_t* pRowLen, bool* pQueryEnd) {	16,527,164✔
297	SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;	16,527,164✔
298	if (taosQueueEmpty(pDispatcher->pDataBlocks)) {	16,527,164✔
299	*pQueryEnd = pDispatcher->queryEnd;	2,434,429✔
300	*pLen = 0;	2,434,429✔
301	return;	2,434,429✔
302	}
303
304	SDataDispatchBuf* pBuf = NULL;	14,122,868✔
305	taosReadQitem(pDispatcher->pDataBlocks, (void**)&pBuf);	14,122,868✔
306	if (pBuf != NULL) {	14,121,495!
307	TAOS_MEMCPY(&pDispatcher->nextOutput, pBuf, sizeof(SDataDispatchBuf));	14,121,991✔
308	taosFreeQitem(pBuf);	14,121,991✔
309	}
310
311	SDataCacheEntry* pEntry = (SDataCacheEntry*)pDispatcher->nextOutput.pData;	14,111,632✔
312	*pLen = pEntry->dataLen;	14,111,632✔
313	*pRowLen = pEntry->rawLen;	14,111,632✔
314
315	*pQueryEnd = pDispatcher->queryEnd;	14,111,632✔
316	qDebug("got data len %" PRId64 ", row num %d in sink", *pLen,	14,111,632✔
317	((SDataCacheEntry*)(pDispatcher->nextOutput.pData))->numOfRows);
318	}
319
320	static int32_t getDataBlock(SDataSinkHandle* pHandle, SOutputData* pOutput) {	16,334,657✔
321	SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;	16,334,657✔
322	if (NULL == pDispatcher->nextOutput.pData) {	16,334,657✔
323	if (!pDispatcher->queryEnd) {	2,250,688!
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,250,688✔
329	pOutput->precision = pDispatcher->pSchema->precision;	2,250,688✔
330	pOutput->bufStatus = DS_BUF_EMPTY;	2,250,688✔
331	pOutput->queryEnd = pDispatcher->queryEnd;	2,250,688✔
332	return TSDB_CODE_SUCCESS;	2,250,688✔
333	}
334
335	SDataCacheEntry* pEntry = (SDataCacheEntry*)(pDispatcher->nextOutput.pData);	14,083,969✔
336	TAOS_MEMCPY(pOutput->pData, pEntry->data, pEntry->dataLen);	14,083,969✔
337	pOutput->numOfRows = pEntry->numOfRows;	14,083,969✔
338	pOutput->numOfCols = pEntry->numOfCols;	14,083,969✔
339	pOutput->compressed = pEntry->compressed;	14,083,969✔
340
341	(void)atomic_sub_fetch_64(&pDispatcher->cachedSize, pEntry->dataLen);	14,083,969✔
342	(void)atomic_sub_fetch_64(&gDataSinkStat.cachedSize, pEntry->dataLen);	14,131,201✔
343
344	taosMemoryFreeClear(pDispatcher->nextOutput.pData); // todo persistent	14,122,054!
345	pOutput->bufStatus = updateStatus(pDispatcher);	14,111,062✔
346
347	(void)taosThreadMutexLock(&pDispatcher->mutex);	14,120,267✔
348	pOutput->queryEnd = pDispatcher->queryEnd;	14,123,473✔
349	pOutput->useconds = pDispatcher->useconds;	14,123,473✔
350	pOutput->precision = pDispatcher->pSchema->precision;	14,123,473✔
351	(void)taosThreadMutexUnlock(&pDispatcher->mutex);	14,123,473✔
352
353	return TSDB_CODE_SUCCESS;	14,126,159✔
354	}
355
356	static int32_t destroyDataSinker(SDataSinkHandle* pHandle) {	8,301,644✔
357	SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;	8,301,644✔
358	(void)atomic_sub_fetch_64(&gDataSinkStat.cachedSize, pDispatcher->cachedSize);	8,301,644✔
359	taosMemoryFreeClear(pDispatcher->nextOutput.pData);	8,305,462!
360	nodesDestroyNode((SNode*)pDispatcher->pSinkNode);	8,305,462✔
361
362	while (!taosQueueEmpty(pDispatcher->pDataBlocks)) {	8,756,631✔
363	SDataDispatchBuf* pBuf = NULL;	453,606✔
364	taosReadQitem(pDispatcher->pDataBlocks, (void**)&pBuf);	453,606✔
365	if (pBuf != NULL) {	453,729!
366	taosMemoryFreeClear(pBuf->pData);	453,736!
367	taosFreeQitem(pBuf);	453,294✔
368	}
369	}
370
371	taosCloseQueue(pDispatcher->pDataBlocks);	8,303,036✔
372	taosMemoryFreeClear(pDispatcher->pCompressBuf);	8,302,934!
373	pDispatcher->bufSize = 0;	8,302,934✔
374
375	(void)taosThreadMutexDestroy(&pDispatcher->mutex);	8,302,934✔
376	taosMemoryFree(pDispatcher->pManager);	8,301,271!
377	return TSDB_CODE_SUCCESS;	8,302,718✔
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,676,503✔
388	SDataDispatchHandle* pDispatcher = (SDataDispatchHandle*)pHandle;	8,676,503✔
389
390	*pFlags = atomic_load_64(&pDispatcher->flags);	8,676,503✔
391	return TSDB_CODE_SUCCESS;	8,674,412✔
392	}
393
394	static int32_t blockDescNodeCheck(SDataBlockDescNode* pInputDataBlockDesc) {	8,282,785✔
395	if(tsSafetyCheckLevel == TSDB_SAFETY_CHECK_LEVELL_NEVER) {	8,282,785!
396	return TSDB_CODE_SUCCESS;	×
397	}
398
399	if (pInputDataBlockDesc == NULL) {	8,282,785!
400	qError("invalid schema");	×
401	return TSDB_CODE_QRY_INVALID_INPUT;	×
402	}
403
404	SNode* pNode;
405	int32_t realOutputRowSize = 0;	8,282,785✔
406	FOREACH(pNode, pInputDataBlockDesc->pSlots) {	43,148,324!
407	SSlotDescNode* pSlotDesc = (SSlotDescNode*)pNode;	35,239,744✔
408	if (pSlotDesc->output) {	35,239,744✔
409	realOutputRowSize += pSlotDesc->dataType.bytes;	34,865,539✔
410	} else {
411	// Slots must be sorted, and slots with 'output' set to true must come first
412	break;	374,205✔
413	}
414	}
415	if (realOutputRowSize != pInputDataBlockDesc->outputRowSize) {	8,282,785!
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,282,785✔
420	}
421
422	int32_t getOutputColCounts(SDataBlockDescNode* pInputDataBlockDesc) {	8,294,880✔
423	if (pInputDataBlockDesc == NULL) {	8,294,880!
424	qError("invalid schema");	×
425	return 0;	×
426	}
427	SNode* pNode;
428	int32_t numOfCols = 0;	8,294,880✔
429	FOREACH(pNode, pInputDataBlockDesc->pSlots) {	43,159,941!
430	SSlotDescNode* pSlotDesc = (SSlotDescNode*)pNode;	35,239,260✔
431	if (pSlotDesc->output) {	35,239,260✔
432	++numOfCols;	34,865,061✔
433	} else {
434	// Slots must be sorted, and slots with 'output' set to true must come first
435	break;	374,199✔
436	}
437	}
438	return numOfCols;	8,294,880✔
439	}
440
441	int32_t createDataDispatcher(SDataSinkManager* pManager, SDataSinkNode** ppDataSink, DataSinkHandle* pHandle, bool processOneBlock) {	8,281,841✔
442	int32_t code;
443	SDataSinkNode* pDataSink = *ppDataSink;	8,281,841✔
444	code = blockDescNodeCheck(pDataSink->pInputDataBlockDesc);	8,281,841✔
445	if (code) {	8,302,613!
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,302,613✔
451	if (NULL == dispatcher) {	8,290,501!
452	goto _return;	×
453	}
454
455	dispatcher->sink.fPut = putDataBlock;	8,290,501✔
456	dispatcher->sink.fEndPut = endPut;	8,290,501✔
457	dispatcher->sink.fReset = resetDispatcher;	8,290,501✔
458	dispatcher->sink.fGetLen = getDataLength;	8,290,501✔
459	dispatcher->sink.fGetData = getDataBlock;	8,290,501✔
460	dispatcher->sink.fDestroy = destroyDataSinker;	8,290,501✔
461	dispatcher->sink.fGetCacheSize = getCacheSize;	8,290,501✔
462	dispatcher->sink.fGetFlags = getSinkFlags;	8,290,501✔
463	dispatcher->pManager = pManager;	8,290,501✔
464	pManager = NULL;	8,290,501✔
465	dispatcher->pSchema = pDataSink->pInputDataBlockDesc;	8,290,501✔
466	dispatcher->pSinkNode = pDataSink;	8,290,501✔
467	*ppDataSink = NULL;	8,290,501✔
468	dispatcher->outPutColCounts = getOutputColCounts(dispatcher->pSchema);	8,290,501✔
469	dispatcher->status = DS_BUF_EMPTY;	8,301,933✔
470	dispatcher->queryEnd = false;	8,301,933✔
471	code = taosOpenQueue(&dispatcher->pDataBlocks);	8,301,933✔
472	if (code) {	8,292,867!
473	terrno = code;	×
474	goto _return;	×
475	}
476	code = taosThreadMutexInit(&dispatcher->mutex, NULL);	8,292,867✔
477	if (code) {	8,299,334!
UNCOV 478	terrno = code;	×
479	goto _return;	×
480	}
481
482	dispatcher->flags = DS_FLAG_USE_MEMPOOL;	8,301,098✔
483	if (processOneBlock) {	8,301,098!
484	dispatcher->flags \|= DS_FLAG_PROCESS_ONE_BLOCK;	×
485	}
486
487	*pHandle = dispatcher;	8,301,098✔
488	return TSDB_CODE_SUCCESS;	8,301,098✔
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 / #4103

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