尽快推进：收紧tooldata工具源码锚点

check-linuxcnc-tooldata-source-map.sh

@@ -22,6 +22,22 @@ grep -F 'TOOL_MMAP_READ_SRCS = emc/tooldata/tool_mmap_read.cc' \
     "$linuxcnc_root/src/emc/tooldata/Submakefile" >/dev/null
 grep -F 'TOOL_WATCH_SRCS = emc/tooldata/tool_watch.cc' \
     "$linuxcnc_root/src/emc/tooldata/Submakefile" >/dev/null
+grep -F 'int main (int argc,char**argv)' \
+    "$linuxcnc_root/src/emc/tooldata/tool_mmap_read.cc" >/dev/null
+grep -F 'if (tool_mmap_user())' \
+    "$linuxcnc_root/src/emc/tooldata/tool_mmap_read.cc" >/dev/null
+grep -F 'idx_last = tooldata_last_index_get();' \
+    "$linuxcnc_root/src/emc/tooldata/tool_mmap_read.cc" >/dev/null
+grep -F 'if (tooldata_get(&tdata,idx) != IDX_OK)' \
+    "$linuxcnc_root/src/emc/tooldata/tool_mmap_read.cc" >/dev/null
+grep -F 'RCS_STAT_CHANNEL *stat = 0;' \
+    "$linuxcnc_root/src/emc/tooldata/tool_watch.cc" >/dev/null
+grep -F 'stat = new RCS_STAT_CHANNEL(emcFormat, "emcStatus", "xemc", nmlfile);' \
+    "$linuxcnc_root/src/emc/tooldata/tool_watch.cc" >/dev/null
+grep -F 'EMC_STAT *emcStatus = static_cast<EMC_STAT*>(stat->get_address());' \
+    "$linuxcnc_root/src/emc/tooldata/tool_watch.cc" >/dev/null
+grep -F 'emcStatus->io.tool.pocketPrepped' \
+    "$linuxcnc_root/src/emc/tooldata/tool_watch.cc" >/dev/null
 grep -F '#define TOOL_MMAP_FILENAME ".tool.mmap"' \
     "$linuxcnc_root/src/emc/tooldata/tooldata_mmap.cc" >/dev/null
 grep -F 'int tool_nml_register(CANON_TOOL_TABLE *tblptr)' \
@@ -54,6 +70,14 @@ grep -F '`src/emc/tooldata/Submakefile` selects `tooldata_mmap.cc`' \
     docs/linuxcnc-tooldata-source-map.md >/dev/null
 grep -F 'Tool table files referenced by switchkins INI files are source coverage only' \
     docs/linuxcnc-tooldata-source-map.md >/dev/null
+grep -F '`src/emc/tooldata/tool_mmap_read.cc` is the mmap tool table reader utility' \
+    docs/linuxcnc-tooldata-source-map.md >/dev/null
+grep -F '`tool_mmap_user()`, `tooldata_last_index_get()`, and `tooldata_get()`' \
+    docs/linuxcnc-tooldata-source-map.md >/dev/null
+grep -F '`src/emc/tooldata/tool_watch.cc` is the NML/mmap tool table watcher utility' \
+    docs/linuxcnc-tooldata-source-map.md >/dev/null
+grep -F '`EMC_STAT::io.tool` fields through `RCS_STAT_CHANNEL`' \
+    docs/linuxcnc-tooldata-source-map.md >/dev/null
 
 grep -F 'tooldata:src/emc/tooldata/tooldata_common.cc:shared tool table parser/format logic' \
     linuxcnc-rs274-source-files.txt >/dev/null
@@ -209,6 +233,8 @@ for phrase in [
     "MAX_DB_PROGRAM_ARGS=10",
     "`strtok_r()` argument splitting",
     "access(..., X_OK)",
+    "mmap tool table reader utility",
+    "NML/mmap tool table watcher utility",
     "inactive-DB return values",
     "./check-linuxcnc-tooldata-source-map.sh",
     "does not interpret G-code",

docs/linuxcnc-tooldata-source-map.md

@@ -18,8 +18,12 @@ source-link/shim guard only; it must not add CNC behavior and must not expand th
 - `src/emc/tooldata/tooldata_db.cc` returns `-1` from
   `tooldata_db_getall()` when the external DB is not live, and returns `0`
   from `tooldata_db_notify()` without side effects in that same state.
-- `src/emc/tooldata/tool_mmap_read.cc` and `src/emc/tooldata/tool_watch.cc` are
-  utility sources from the same LinuxCNC tooldata build metadata.
+- `src/emc/tooldata/tool_mmap_read.cc` is the mmap tool table reader utility
+  source from the same LinuxCNC tooldata build metadata; it reads through
+  `tool_mmap_user()`, `tooldata_last_index_get()`, and `tooldata_get()`.
+- `src/emc/tooldata/tool_watch.cc` is the NML/mmap tool table watcher utility
+  source from the same LinuxCNC tooldata build metadata; it reads
+  `EMC_STAT::io.tool` fields through `RCS_STAT_CHANNEL`.
 - `src/emc/tooldata/tooldata.hh` declares the tooldata API used by RS274 and
   WASM-safe shims.