GP3 Netscan (en): Unterschied zwischen den Versionen

Aktuelle Version vom 4. September 2016, 18:36 Uhr

Overview of the found devices

The gemininetscan Plugin scans the local network for available devices with fping. Subsequently a port scan can be performed to discover shares (with amap) or 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).
Executes a port scan for the discovered devices.
Display the MAC addresses of the devices, including the manufacturer info.
Scans for available Samba, NFS and FTPshares.
Can transfer the found shares directly to the Automount Editor.
Supports WOL, to wake up devices.
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: APT - Package name: gemininetscan

see article: OPKG - Package name: gemininetscan

Restart Enigma2 after the installation, or reboot the Dreambox.

Operation

Search

Completed search

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 manufacturer, MAC addresses, .... An additional scan can be started at any moment over the red button.

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 IP: / End IP:	Range or IP addresses for the scan.
Use Upnp and Zerokonf/Bonjour:	If the setting is `on`, the devices are searched via Upnp/Avahi. Use `off` if the search initiates a router crash (e.g. Fritzbox). In this case the search is performed via DNS functions (nslookup) and Samba.

Start portscan

Settings Portscan

A portscan for the found devices can be executed. Select the wanted device with the OK button. In the following window, it is possible to perform a scan for the device with the following settings (see below). Use the navigation buttons ◀ ▶, to change the settings.

Setting	Description
Shares (NFS, SMB, FTP):	Search only for NFS, SMB and FTP shares. Keep in mind, SMB shares from Windows XP upwards are not displayed.
Standard:	Search for available services and shares
1-1023:	Search for standard ports (well known ports).
1-49151:	Search for standard ports and registered ports.
1-65535:	Scan complete port range (standard, registered and dynamic).

After the selection is made, the portscan can be started with Save, or the OK button. After the search is finished, the found info (services, shares) are displayed on the screen.

Shares

After the portscan is completed, the found SMB or NFS shares are identified with the text Share:. It's possible to use a filter with the green button (only shares). This will only display the found NFS and SMB shares. Use the green button (show all) again, to see all informations.

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 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.

Configuration file

The informations of the scanned network is stored in the JSON file gnetscan.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/gnetscan.json'

@@ Zeile 4: / Zeile 4: @@
   |}
 [[Datei:GP3-Netscan2.png|thumb|right|400px|Overview of the found devices]]
-The <code>gemininetscan</code> Plugin scans the local network for available devices. subsequently (depending on the settings) a port scan is performed do discover open [http://en.wikipedia.org/wiki/Port_%28computer_networking%29 Ports].  The result is displayed on the TV screen. Following functions are covered by the plugin:
+The <code>'''gemininetscan'''</code> Plugin scans the local network for available devices with <code>[http://fping.sourceforge.net/ fping]</code>. Subsequently a port scan can be performed to discover shares (with [https://www.thc.org/thc-amap/ amap]) or open [http://en.wikipedia.org/wiki/Port_%28computer_networking%29 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 discoverd devices.
+* Executes a port scan for the discovered devices.
-* Display the [http://en.wikipedia.org/wiki/MAC_address MAC adresses] of the devices, including the [http://en.wikipedia.org/wiki/Organizationally_Unique_Identifier manufacturer info].
+* Display the [http://en.wikipedia.org/wiki/MAC_address MAC addresses] of the devices, including the [http://en.wikipedia.org/wiki/Organizationally_Unique_Identifier manufacturer info].
-* Scans for available [[Samba Server (en)|Samba]] and NFS shares.
+* Scans for available [[Samba Server (en)|Samba]], NFS and [[FTP (en)|FTP]]shares.
 * Can transfer the found shares directly to the [[GP3 Settings Automount (en)|Automount Editor]].
 * Supports [http://en.wikipedia.org/wiki/Wake-on-LAN WOL], to wake up devices.
-* Can initiate a shutdown or reboot, if a Telnet server is installed on the device.
+* Displays active / inactive devices ([[Datei:state_green.png|text-center]] = online / [[Datei:state_red.png|text-center]] = offline).
-* Displays active / inactive devices ([[Datei:Dot_green.png|13px|text-top]] = online / [[Datei:Dot_red.png|13px|text-top]] = offline).
-== Installation ==
+== Installation / Deinstallation ==
-Install the <code>gemininetscan</code> Plugin via [[GP3 Addons|Addons]] in the Blue Panel. The package is in the category '''Gemini Plugins'''. After installing the plugin an [[Enigma2]] restart or reboot of the Dreambox is required. It's also possible to install the plugin via [[Telnet (en)]] or SSH with the following command.
+The <code>gemininetscan</code> plugin can be installed / removed in different ways:
-<syntaxhighlight>
+{{Hauptbeitrag (en)|GP3 Addons (en){{!}}GP3 Addons| - Category: Gemini Plugins}}
-opkg update && opkg install gemininetscan
+{{Hauptbeitrag (en)|WebAdmin (en){{!}}WebAdmin| - Package name: <code>gemininetscan</code>}}
-</syntaxhighlight>
+{{Hauptbeitrag (en)|APT (en){{!}}APT| - Package name: <code>gemininetscan</code>}}
+{{Hauptbeitrag (en)|OPKG (en){{!}}OPKG| - Package name: <code>gemininetscan</code>}}
+Restart [[Enigma2 (en)|Enigma2]] after the installation, or reboot the Dreambox.
 == Operation ==
-[[Datei:GP3-Netscan1.png|thumb|right|250px|Scan settings]]
+[[Datei:GP3-Netscan1.png|thumb|right|250px|Search]]
-[[Datei:GP3-Netscan2.png|thumb|right|250px|Completed scan]]
+[[Datei:GP3-Netscan2.png|thumb|right|250px|Completed search]]
-After starting the plugin, you can open the settings with the {{Red|red}} button. The following table lists the different options. The scan can be startet with the {{Green|Start}} button. Once the scan of the network is completed, a list of availiable devices is displayed. Including the informations concerning the services, MAC adresses, .... An additional scan can be started at any moment over the {{Red|red}} button.
+After starting the plugin, you can open the settings with the {{Red|red}} button. The following table lists the different options. The scan can be started with the {{Green|Start}} button. Once the scan of the network is completed, a list of available devices is displayed. Including the informations concerning the manufacturer, MAC addresses, .... An additional scan can be started at any moment over the {{Red|red}} button.
-==== Settings ====
 {| class="wikitable" border="1"
-! width="180"|Entry
+! width="250"|Entry
 ! width="700"|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).
+| Selection of the network interface e.g. eth0 or wlan0, which will be used for the scan (if multiple interfaces are available).
 |-
-| '''Start: / End:'''
+| '''Start IP: / End IP:'''
-| range od IP addresses for the scan.
+| Range or IP addresses for the scan.
 |-
-| '''Search the Ports:'''
+| '''Use Upnp and Zerokonf/Bonjour:'''
-| here you can define which ports will be scanned. Following options are possible:
+| If the setting is {{Taste|on}}, the devices are searched via Upnp/Avahi. Use {{Taste|off}} if the search initiates a router crash (e.g. Fritzbox). In this case the search is performed via DNS functions ([http://de.wikipedia.org/wiki/Nslookup nslookup]) and Samba.
-* standard - search for available services and shares (recommended setting).
-* no portscan - scans for devices, without portscan.
-* 1-1023 - scans for standardized ports ([http://de.wikipedia.org/wiki/Liste_der_standardisierten_Ports#Standardisierte_Ports_.280.E2.80.931023.29 well known ports]).
-* 1-49151 - scans for standardized and [http://de.wikipedia.org/wiki/Liste_der_standardisierten_Ports#Registrierte_Ports:_1024.E2.80.9349151 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.
-|-
-| '''Eigene IP scannen?:'''
-| Hier könnt ihr die eigene Dreambox scannen, oder eben nicht ;)
-|-
-| '''Geräte ohne Service nicht anzeigen:'''
-| Geräte ohne Dienste können mit dieser Einstellung ein- oder ausgeblendet werden.
 |}
-{{Achtung|Benutzer mit einer Fritzbox von AVM, sollten keinen Scann mit der Portauswahl 1-49151 und 1-65535 durchführen.}}
+==== Start portscan ====
+[[Datei:Netscan Portscan.png|thumb|right|250px|Settings Portscan]]
-==== Freigaben ====
+A portscan for the found devices can be executed. Select the wanted device with the {{Taste|OK}} button. In the following window, it is possible to perform a scan for the device with the following settings (see below). Use the navigation buttons {{Taste|◀}} {{Taste|▶}}, to change the settings.
-[[Datei:GP3-Netscan3.png|thumb|right|250px|Freigaben]]
-Um Freigaben zu sehen, müsst ihr in der Liste, das gewünschte Gerät mit der {{Taste|OK}} auswählen. Ihr könnt anschliessend auch den Filter mit der {{Green|grünen}} Taste aktivieren, somit werden nur gefundene NFS und SMB Freigaben angezeigt. Beachtet bitte, dass Freigaben ab WinXP nicht angezeigt werden, sondern nur reine NFS- und [[Samba Server]] Freigaben.
-Einbinden von NFS oder SMB Freigaben ist auch einfach möglich. Wählt eine Freigabe und drückt die {{Red|rote}} Taste. Die Freigabe wird so automatisch an den [[GP3 Einstellungen Automount|Automount Editor]] übergeben. Ändert im Editor noch die gewünschten Einstellungen und schon könnt ihr das Gerät via <code>/media/net/mountpunkt</code> erreichen.
-==== Aufwecken ====
-[[Datei:GP3-Netscan5.png|thumb|right|250px|Aufwecken]]
-Aufwecken von Geräten erfolgt in der Liste über die {{Green|grüne}} Taste. Beachtet aber, dass die Geräte [http://de.wikipedia.org/wiki/Wake_On_LAN WOL] unterstützen müssen und die Funktion muss natürlich aktiviert sein. Lest dazu bitte die [http://de.wikipedia.org/wiki/Betriebsanleitung Betriebsanleitungen] eurer verwendeten Geräte. Um Geräte aufzuwecken, wird der <code>/usr/bin/ether-wake</code> Befehl der [[Busybox]] verwendet.
-==== Herunterfahren / Neustart ====
-[[Datei:GP3-Netscan4.png|thumb|right|250px|Herunterfahren]]
-Für die Funktion, muss ein Telnet Server auf dem Gerät (z.B. Dreambox, PC, NAS, usw.) installiert sein. Das <code>gemininetscan</code> Plugin loggt sich mit Benutzername und Passwort via [[Telnet]] auf das Zielgerät ein und führt anschliessend den Befehl für das Herunterfahren / Neustart aus. Die folgenden Beschreibungen zeigen euch, wie ein Telnet Server unter [http://de.wikipedia.org/wiki/Ubuntu Ubuntu] (Linux), [http://de.wikipedia.org/wiki/Mac_OS_X Mac OS], oder [http://de.wikipedia.org/wiki/Windows Windows] eingerichtet wird.
-* [http://www.cyberciti.biz/faq/ubuntu-linux-enable-telnet-service/ Ubuntu]
-* [http://support.apple.com/kb/TA20443 Mac OS X]
-* [http://technet.microsoft.com/de-de/library/cc770501%28WS.10%29.aspx Windows]
-Das Herunterfahren (oder Neustart) erfolgt über die {{Blue|blaue}} Taste, wo anschliessend die benötigten Informationen z.B. Port, Benutzername, Passwort, usw. eingegeben werden müssen. Drückt nachher die {{Green|grüne}} Taste, um das Gerät auszuschalten. Die folgende Tabelle beschreibt die benötigten Informationen.
 {| class="wikitable" border="1"
-! width="180"|Eingabe
+! width="250"|Setting
-! width="700"|Beschreibung
+! width="700"|Description
 |-
-| '''IP:'''
+| '''Shares (NFS, SMB, FTP):'''
-| IP Adresse des auszuschaltenden Gerätes eingeben.
+| Search only for NFS, SMB and FTP shares. Keep in mind, SMB shares from Windows XP upwards are not displayed.
 |-
-| '''Port (Standard 23):'''
+| '''Standard:'''
-| Portnummer eingeben, auf welchen der Telnet Server lauscht (Standard Port 23).
+| Search for available services and shares
 |-
-| '''Telnet Nutzer:'''
+| '''1-1023:'''
-| Benutzername eingeben, welcher auf den Telnet Server einloggen soll. Der Benutzer benötigt entsprechende Rechte (root / admin), um das Gerät auszuschalten!
+| Search for standard ports ([http://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers#Well-known_ports well known ports]).
 |-
-| '''Telnet Passwort:'''
+| '''1-49151:'''
-| Passwort des Benutzer eingeben.
+| Search for standard ports and [http://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers#Registered_ports registered] ports.
 |-
-| '''Befehl:'''
+| '''1-65535:'''
-| Auswahl des Befehls für den Neustart oder das Herunterfahren. Unterschieden werden die Befehle für Linux basierende Geräte, Mac OS und Windows. Am besten testet ihr die Befehle, nachdem ihr euch mit dem Benutzer / Passwort am Telnet Server angemeldet habt. So könnt ihr die Rechte und den Befehl für das Herunterfahren überprüfen. Die folgende Liste, zeigt die vom <code>gemininetscan</code> bereitgestellten Befehle für den Neustart und das Herunterfahren.
+| Scan complete port range (standard, registered and dynamic).
-* Linux - ausschalten: <code>shutdown</code>
-* Linux - ausschalten: <code>poweroff</code>
-* Linux - ausschalten: <code>halt</code>
-* Linux - Neustart: <code>reboot</code>
-* Mac OS - ausschalten: <code>shutdown -h now</code>
-* Mac OS - Neustart: <code>shutdown -r now</code>
-* Windows - ausschalten: <code>shutdown -s -f</code>
-* Windows - Neustart: <code>shutdown -r -s -f</code>
-Zusätzlich gibt es für Linux die Auswahl mit <code>[http://wiki.ubuntuusers.de/sudo sudo]</code> z.B für Ubuntu. Damit könnt ihr den Rechner herunterfahren, ohne den <code>root</code> Account aktivieren zu müssen. Man muss aber mit dem Befehl <code>sudo visudo</code> die <code>sudoers</code> Datei anpassen und am Ende eine Zeile mit <code>'''euerusername ALL = NOPASSWD:/sbin/shutdown'''</code> einfügen. So könnt ihr den shutdown Befehl (z.B. sudo shutdown -h now) ohne Passwort ausführen.
 |}
-== Konfigurationsdatei ==
+After the selection is made, the portscan can be started with {{Green|Save}}, or the {{Taste|OK}} button. After the search is finished, the found info (services, shares) are displayed on the screen.
-Die Informationen des gescannten Netzwerks, werden in die [http://de.wikipedia.org/wiki/JavaScript_Object_Notation JSON]-Datei <code>netscan.json</code> im [[GP3 Einstellungen Allgemein #Speicherort für Gemini-Cache|Gemini Cache]] geschrieben.
+==== Shares ====
+[[Datei:GP3-Netscan3.png|thumb|right|250px|Shares]]
+After the portscan is completed, the found SMB or NFS shares are identified with the text '''Share:'''. It's possible to use a filter with the {{Green|green}} button (only shares). This will only display the found NFS and SMB shares. Use the {{Green|green}} button (show all) again, to see all informations.
+Keep in mind, the WinXP shares will not be displayed, only the pure NFS and [[Samba Server (en)|Samba Server]] shares.
+Mounting a NFS or SMB share is easy. Select the share and push the {{Red|red}} button. The share will be transfered to the [[GP3 Settings Automount (en)|Automount Editor]]. Modify the settings and the device can be reached over <code>/media/net/mountpoint</code>.
+==== Wake up ====
+[[Datei:GP3-Netscan5.png|thumb|right|250px|Wake up]]
+Wake up of devices is performed in the list with the {{Green|green}} button. Keep in mind, the devices should support [http://en.wikipedia.org/wiki/Wake-on-LAN WOL] and the function needs to be activated. Please read the [http://en.wikipedia.org/wiki/User_guide manual] of your used devices. To wake up devices, the <code>/usr/bin/ether-wake</code> command of [[BusyBox (en)|BusyBox]] is used.
-== Scannen via Terminal ==
+== Configuration file ==
-Via [[Telnet]] oder [[SSH]] könnt ihr auch das Netzwerk durchforsten, z.B. für Testzwecke. Passt dazu euren IP Bereich an, wie auch die benutze Netzwerkschnittstelle (z.B. eth0, wlan0, br0, usw.). Befehl ist wie folgt:
+The informations of the scanned network is stored in the [http://en.wikipedia.org/wiki/JSON JSON] file <code>gnetscan.json</code> in the [[GP3 general settings (en)#Path for Gemini-Cache|Gemini Cache]].
-<syntaxhighlight>
-gnetscan -d eth0 -f 192.168.1.1 -l 192.168.1.254 -o '/home/root/.geminicache/netscan.json'
-</syntaxhighlight>
-== Deinstallation ==
+== Scan via Terminal ==
-Deinstallation erfolgt über die Kategorie '''Gemini Plugins''' in den [[GP3 Addons|Addons]]. Wählt das <code>gemininetscan</code> Plugin mit der {{Taste|OK}} Taste und startet die Deinstallation mit der {{Green|grünen}} Taste. Führt nach der Deinstallationen einen [[Enigma2]] Neustart aus, oder startet die Dreambox neu. Oder deinstalliert das Plugin via [[Telnet]] oder [[SSH]]:
+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:
 <syntaxhighlight>
-opkg remove --autoremove gemininetscan
+gnetscan -d eth0 -f 192.168.1.1 -l 192.168.1.254 -o '/home/root/.geminicache/gnetscan.json'
 </syntaxhighlight>
-[[Kategorie:GP3]]
+[[Kategorie:GP3 (en)]]

GP3 Netscan (en): Unterschied zwischen den Versionen

Aktuelle Version vom 4. September 2016, 18:36 Uhr

Inhaltsverzeichnis

Installation / Deinstallation

Operation

Start portscan

Shares

Wake up

Configuration file

Scan via Terminal

Navigationsmenü

Meine Werkzeuge

Namensräume

Varianten

Ansichten

Mehr

Suche

Navigation

Forum

Werkzeuge