nsmcp::AccessRecordStoreSQLite method cRead (public)
<instance of nsmcp::AccessRecordStoreSQLite> cRead fid file \ offset stop budget limits redactor ingestOnly [ batched ]
Defined in /usr/local/ns/tcl/nsmcp/log-traffic-record-store.tcl
Read a bounded source slice through the C access-log scanner. Use a connection-local temporary table to materialize raw scanner fields, then cook and redact valid requests. Raw fields are never written to the canonical store. Leave an incomplete tail uncommitted.
- Parameters:
- fid (required)
- Stored source-file identifier.
- file (required)
- Discovered source descriptor.
- offset (required)
- Starting source byte offset.
- stop (required)
- Planned exclusive source boundary.
- budget (required)
- Maximum source bytes to scan in this invocation.
- limits (required)
- Scanner limits, including the maximum line size.
- redactor (required)
- Redaction object used when cooking requests.
- ingestOnly (required)
- True for ingestion; false allows time-dependent records to request the Tcl scanner fallback.
- batched (optional, defaults to
"false")- True to construct prepared rows; false to construct SQL reference tuples.
- Returns:
- A list of end offset, cooked tuples, pending flag, fallback flag and parsing-loss counts.
- Testcases:
- No testcase defined.
![[i]](/resources/acs-subsite/ZoomIn16.gif)