jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-23 17:27:19 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update device_tracker.nmap_tracker.markdown (#1577)

Browse Source
This commit is contained in:
Daniel Høyer Iversen 2016-12-10 23:18:49 +01:00 committed by Fabian Affolter
parent 71e424507e
commit 9708133271
1 changed files with 16 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
source/_components/device_tracker.nmap_tracker.markdown
View File

@ -33,6 +33,8 @@ Configuration variables:
- **hosts** (*Required*): The network address to scan (in any supported NMap format). Mixing subnets and IPs is possible. - **hosts** (*Required*): The network address to scan (in any supported NMap format). Mixing subnets and IPs is possible.
- **home_interval** (*Optional*): The number of minutes nmap will not scan this device, assuming it is home, in order to preserve the device battery. - **home_interval** (*Optional*): The number of minutes nmap will not scan this device, assuming it is home, in order to preserve the device battery.
- **exclude** (*Optional*): Hosts not to include in nmap scanning. - **exclude** (*Optional*): Hosts not to include in nmap scanning.
- **scan_options** (*Optional*): Configurable scan options for nmap. Default to `-F --host-timeout 5s`
A full example for the `nmap` tracker could look like the following sample: A full example for the `nmap` tracker could look like the following sample:
@ -59,5 +61,19 @@ device_tracker:
- 10.0.0.15 - 10.0.0.15
``` ```
An example of how the Nmap scanner can be customized:
Add the capabilities to Nmap. Be sure to specify the full path to wherever you installed Nmap:
`sudo setcap cap_net_raw,cap_net_admin,cap_net_bind_service+eip /usr/bin/nmap
`
And you can set up the device tracker as
```yaml
- platform: nmap_tracker
hosts: 192.168.1.1-25
scan_options: " --privileged -sP "
```
See the [device tracker component page](/components/device_tracker/) for instructions how to configure the people to be tracked. See the [device tracker component page](/components/device_tracker/) for instructions how to configure the people to be tracked.