GP3 Netscan (en)

- in Deutsch

- in English

Overview of the found devices

The gemininetscan Plugin scans the local network for available devices. Subsequently (depending on the settings) a port scan is performed to discover open Ports. The result is displayed on the TV screen. Following functions are covered by the plugin:

• Scan the local network for available devices (via eth0 or wlan0).
• List the services of the discovered devices.
• Display the MAC adresses of the devices, including the manufacturer info.
• Scans for available Samba and NFS shares.
• Can transfer the found shares directly to the Automount Editor.
• Supports WOL, to wake up devices.
• Can initiate a shutdown or reboot, if a Telnet server is installed on the device.
• Displays active / inactive devices ( = online / = offline).

Installation / Deinstallation

The gemininetscan plugin can be installed / removed in different ways:

see article: GP3 Addons - Category: Gemini Plugins

see article: WebAdmin - Package name: gemininetscan

see article: OPKG - Package name: gemininetscan

Restart Enigma2 after the installation, or reboot the Dreambox.

Operation

Scan settings

Completed scan

After starting the plugin, you can open the settings with the red button. The following table lists the different options. The scan can be started with the Start button. Once the scan of the network is completed, a list of available devices is displayed. Including the informations concerning the services, MAC addresses, .... An additional scan can be started at any moment over the red button.

Settings

Entry	Description
Network interface:	Selection of the network interface e.g. eth0 or wlan0, which will be used for the scan (if multiple interfaces are available).
Start: / End:	Range or IP addresses for the scan.
Search the Ports:	Here you can define which ports will be scanned. Following options are possible: Standard - search for available services and shares (recommended setting). No portscan - scans for devices, without portscan. 1-1023 - scans for standardized ports (well known ports). 1-49151 - scans for standardized and registered ports. 1-65535 - scan complete (standardized, registered and dynamic) port range. Shares - scans only for NFS and SMB shares. Keep in mind, Windows XP shares are not detected.
Scan own IP?:	Here you can indicate if your own Dreambox needs to be scanned, or not ;)
Don't display devices without services:	Devices without services can be displayed or hidden with this setting.

users with a Fritzbox from AVM, should not scan the port range 1-49151 or 1-65535.

Shares

Shares

To see the the shares, select a device from the list and push the OK button. It's also possible to filter the list over the green button, to see only the NFS and SMB shares. Keep in mind, the WinXP shares will not be displayed, only the pure NFS and Samba Server shares.

Mounting a NFS or SMB share is easy. Select the share and push the red button. The share will be transfered to the Automount Editor. Modify the settings and the device can be reached over /media/net/mountpoint.

Wake up

Wake up

Wake up of devices is performed in the list with the green button. Keep in mind, the devices should support WOL and the function needs to be activated. Please read the manual of your used devices. To wake up devices, the /usr/bin/ether-wake command of Busybox is used.

Shutdown / Reboot

Shutdown

For this function, a telnet server needs to be installed on the device (e.g. Dreambox, PC, NAS, ...). The gemininetscan Plugin performs a login with user name and password via Telnet on the remote device and executes the command for the shutdown / reboot. The following articles explain how to install a telnet server on Ubuntu (Linux), Mac OS, or Windows.

• Ubuntu
• Mac OS X
• Windows

The shutdown (or reboot) is initiated over the blue button, where the required informations e.g. port, user name, password, ... needs to be entered. Push the green button, to shutdown the device. The following table explains the required informations.

Entry	Description
IP:	IP adress of the remote device.
Port (default 23):	Port number which is used for the telnet server to connect (default port 23).
Telnet user:	User name, which is used to login onto the telnet server. the user needs the appropriate user rights (root / admin), to shutdown the device!
Telnet password:	Password of the user.
Command:	Selection of the command for the shutdown or reboot. Different commands for Linux devices, Mac OS and Windows. It's recommended to test the command, after a successful login onto the telnet server with the user name and password. This way you can check the user rights and the command for the shutdown. The following list gives an overview of the commands offered by gemininetscan to initiate a shutdown or reboot. Linux - shutdown: shutdown Linux - shutdown: poweroff Linux - shutdown: halt Linux - reboot: reboot Mac OS - shutdown: shutdown -h now Mac OS - reboot: shutdown -r now Windows - shutdown: shutdown -s -f Windows - reboot: shutdown -r -s -f Additionally the plugin offers the selection sudo for linux e.g. for Ubuntu. With this command it's possible to shutdown the computer without activating the root account. But it's required to modify the sudoers file with the command sudo visudo, and add the line your_user_name ALL = NOPASSWD:/sbin/shutdown at the end. This way you can execute the shutdown command (e.g. sudo shutdown -h now) without password.

Configuration file

The informations of the scanned network is stored in the JSON file netscan.json in the Gemini Cache.

Scan via Terminal

It's also possible to scan the network via Telnet (en) or SSH, e.g. for testing purposes. Use your IP range, the used interface (e.g. eth0, wlan0, br0, ...). The command is:

gnetscan -d eth0 -f 192.168.1.1 -l 192.168.1.254 -o '/home/root/.geminicache/netscan.json'