From 46781ed71ac778f0344f26342bd482bc1be8d9e9 Mon Sep 17 00:00:00 2001 From: jokob-sk Date: Sun, 15 Feb 2026 07:50:33 +1100 Subject: [PATCH] DOCS: dummy devices Signed-off-by: jokob-sk --- docs/DEVICE_MANAGEMENT.md | 21 ++++++++++++++++++--- docs/REMOTE_NETWORKS.md | 2 +- 2 files changed, 19 insertions(+), 4 deletions(-) diff --git a/docs/DEVICE_MANAGEMENT.md b/docs/DEVICE_MANAGEMENT.md index 51685323..658edc58 100755 --- a/docs/DEVICE_MANAGEMENT.md +++ b/docs/DEVICE_MANAGEMENT.md @@ -39,9 +39,24 @@ The **MAC** field and the **Last IP** field will then become editable. ![Save Dummy Device](./img/DEVICE_MANAGEMENT/DeviceEdit_SaveDummyDevice.png) -> [!NOTE] -> -> You can couple this with the `ICMP` plugin which can be used to monitor the status of these devices, if they are actual devices reachable with the `ping` command. If not, you can use a loopback IP address so they appear online, such as `0.0.0.0` or `127.0.0.1`. +## Dummy or Manually Created Device Status + +You can control a dummy device’s status either via `ICMP` (automatic) or the `Force Status` field (manual). Choose based on whether the device is real and how important **data hygiene** is. + +### `ICMP` (Real Devices) + +Use a real IP that responds to ping so status is updated automatically. + +### `Force Status` (Best for Data Hygiene) + +Manually set the status when the device is not reachable or is purely logical. +This keeps your data clean and avoids fake IPs. + +### Loopback IP (`127.0.0.1`, `0.0.0.0`) + +Use when you want the device to always appear online via `ICMP`. +Note this simulates reachability and introduces artificial data. This approach might be preferred, if you want to filter and distinguish dummy devices based on IP when filtering your asset lists. + ## Copying data from an existing device. diff --git a/docs/REMOTE_NETWORKS.md b/docs/REMOTE_NETWORKS.md index 8ff4848c..4e066344 100755 --- a/docs/REMOTE_NETWORKS.md +++ b/docs/REMOTE_NETWORKS.md @@ -51,7 +51,7 @@ If you don't need to discover new devices and only need to report on their statu For more information on how to add devices manually (or dummy devices), refer to the [Device Management](./DEVICE_MANAGEMENT.md) documentation. -To create truly dummy devices, you can use a loopback IP address (e.g., `0.0.0.0` or `127.0.0.1`) so they appear online. +To create truly dummy devices, you can use a loopback IP address (e.g., `0.0.0.0` or `127.0.0.1`) or the `Force Status` field so they appear online. ## NMAP and Fake MAC Addresses