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-15 05:16:49 +00:00
Code Issues Packages Projects Releases Wiki Activity

More titles (#6332)

Browse Source 
Added a couple of titles to make linking into the page easier. Also expanded on why capabilities are useful.
This commit is contained in:
DubhAd 2018-09-21 20:37:03 +01:00 committed by Fabian Affolter
parent 4832ae832e
commit 24b1de1bf6
1 changed files with 8 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -2,7 +2,7 @@
layout: page layout: page
title: "Nmap" title: "Nmap"
description: "Instructions on how to integrate Nmap into Home Assistant." description: "Instructions on how to integrate Nmap into Home Assistant."
date: 2015-03-23 19:59 date: 2018-09-21 18:59
sidebar: true sidebar: true
comments: false comments: false
sharing: true sharing: true
@ -43,6 +43,7 @@ Configuration variables:
- **exclude** (*Optional*): Hosts not to include in nmap scanning. Scanning the host where Home Assistant is running can cause problems (websocket error), so excluding that host is a good idea. - **exclude** (*Optional*): Hosts not to include in nmap scanning. Scanning the host where Home Assistant is running can cause problems (websocket error), so excluding that host is a good idea.
- **scan_options** (*Optional*): Configurable scan options for nmap. Default to `-F --host-timeout 5s` - **scan_options** (*Optional*): Configurable scan options for nmap. Default to `-F --host-timeout 5s`
## {% linkable_title Examples %}
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:
@ -73,10 +74,13 @@ In the above example, Nmap will be call with the process:
An example of how the Nmap scanner can be customized: 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: ### {% linkable_title Linux capabilities %}
`sudo setcap cap_net_raw,cap_net_admin,cap_net_bind_service+eip /usr/bin/nmap On Linux systems you can extend the functionality of Nmap, without having to run it as root, by using *Linux capabilities*. Be sure to specify the full path to wherever you installed Nmap:
`
```bash
$ 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 And you can set up the device tracker as
```yaml ```yaml
@ -85,5 +89,4 @@ And you can set up the device tracker as
scan_options: " --privileged -sP " 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.