# LibreNMS reference checkout

A shallow clone lives at `/home/svcuser/src/librenms` (commit 06080bb3) for reference only. It is outside this repo. Set `NMON_LIBRENMS_DIR` to point tests and the importer at it.

| Path | What it is | Used for |
|---|---|---|
| `mibs/` | 4,865 MIBs (standard at the top level, vendors in subdirs) | copied into `nmon/mibs/` (DEVIATIONS #6) |
| `resources/definitions/os_detection/*.yaml` (817) | OS matchers: `sysObjectID`, `sysDescr`, `mib_dir` | `nmon-librenms-import` (separate offline tool), the profile `match:` section |
| `resources/definitions/os_discovery/*.yaml` (708) | per-OS processors, mempools, storage, sensors with `oid`, `num_oid`, `divisor`, `skip_values` | the importer, and checking vendor OIDs in shipped profiles |
| `tests/snmpsim/*.snmprec` (2,054) | real device recordings | optional real-device fixture tests (DEVIATIONS #8) |
| `LibreNMS/OS/*.php`, `includes/polling/` | poller logic | reading only; the converter contains no LibreNMS code |

LibreNMS is GPLv3. Nothing from it except the MIB files (which are third-party) is copied into nmon.