[[Vorlage(Getestet,  focal)]]

{{{#!vorlage Wissen
[:Pakete installieren: Installation von Programmen]
[:Terminal: Ein Terminal öffnen]f
[:sudo: Root-Rechte]
}}}
[[Inhaltsverzeichnis()]]

[[Bild(Wiki/Icons/terminal.png, 48, align=left)]] 
[github:raboof/nethogs:nethogs] {en} ist ein Kommandozeilenwerkzeug, das die Bandbreitennutzung nach Prozessen und Sub-Netzen gruppieren kann. Es listet die [wikipedia:Process_identifier:PID], den Prozessnamen und den ausführenden Benutzer auf.

Möchte man den Netzwerkverkehr nach Verbindungen aufgeschlüsselt bekommen, kann man die Anwendung [:iftop:] verwenden. Eine Übersicht zu weiteren Programmen findet sich im Artikel [:Netzwerk-Monitoring:].

= Installation =
Da das Programm nicht Teil der Standardinstallation ist, muss zunächst das gleichnamige Paket installiert werden[1]:

{{{#!vorlage Paketinstallation
nethogs, universe
}}}

= Verwendung =
nethogs wird im Terminal[2] über den gleichnamigen Befehl aufgerufen. Da das Programm auf eine Netzwerkschnittstelle und auf alle TCP-Verbindungen zugreift, muss die Anwendung mit Root-Rechten[3] ausführt werden. Übergibt man dem Befehl `nethogs` keine Parameter, dann lauscht das Programm auf der Ethernet-Schnittstelle `eth0`. Möchte man etwa den Netzwerkverkehr über WLAN angezeigt bekommen, muss man dem Programm die entsprechende Schnittstelle übergeben. 

== Beispiele ==
Mit dem folgenden Befehl lauscht das Programm auf der ersten WLAN-Schnittstelle des Computers:

{{{#!vorlage Befehl
sudo nethogs wlan0
}}}

Möchte man mehrere Netzwerkschnittstellen gleichzeitig überwachen, dann kann man dem Programm mehrere Schnittstellen übergeben. In dem Beispiel handelt es sich um die erste Ethernet-, WLAN- und USB-Schnittstelle. TCP über die USB-Schnittstelle kann etwa durch [wikipedia_en:USB Tethering:USB-Tethering] hervorgerufen werden. Da über die Schnittstelle viel verschickt wird, aktualisiert sich nethogs nur alle drei Sekunden.

{{{#!vorlage Befehl
sudo nethogs eth0 wlan0 usb0 -d 3
}}}

= Parameter und Tastenkombinationen =
Über die folgenden Parameter kann man nethogs steuern.

{{{#!vorlage Tabelle
<rowclass="titel"-2> Optionen von `nethogs`
+++
<rowclass="kopf"> Parameter
Bedeutung
+++
`-d ZAHL`
Aktualisierungsrate in Sekunden
+++
<rowclass="highlight"> `-t`
Tracemode
+++
`-V`
Zeigt die Versionsnummer an
}}}

Die folgende kurze Liste mit der Tastenbelegung innerhalb des Programms ist vollständig. Es gibt keine weiteren dokumentierten Aktionen, die durch einen Tastendruck ausgelöst werden können.

{{{#!vorlage Tabelle
<rowclass="titel"-2> Tastenbelegung
+++
<rowclass="kopf"> Taste 
Aktion 
+++
[[Vorlage(Tasten, m)]]
Zwischen Einheiten umschalten (KB/s, KB, B, MB)
+++
<rowclass="highlight"> [[Vorlage(Tasten, r)]]
Liste wird nach empfangenen Datenvolumen sortieren (''received'')
+++
[[Vorlage(Tasten, s)]]
Liste wird nach gesendeten Datenvolumen sortieren (''send'')
+++
<rowclass="highlight"> [[Vorlage(Tasten, q)]]
Programm wird beendet
}}}

= Problembehebung =
== nethogs zeigt keinen Datenverkehr (UDP) von BitTorent an ==
Da nethogs momentan (Stand: Dezember 2012) nur [wikipedia:TCP:] versteht und bei BitTorrent auch [wikipedia:User_Datagram_Protocol:UDP] verwendet wird, kann nethogs den UDP-Verkehr nicht auswerten.

== Fehlermeldung (Stand: 23.2.2016, Ubuntu 14.04, LTS) ==
Nach Update startet nethogs mit Fehlermeldung:
{{{#!vorlage Befehl
sudo nethogs 
}}}
{{{
[sudo] password for <$USER>: 
creating socket failed while establishing local IP - are you root?
}}}

Kann durch Aktualisierung behoben werden, dafür ist [:Git:] zu installieren:

Abhängige Entwicklungspakete installieren:
{{{#!vorlage Befehl
sudo apt-get build-dep nethogs
}}}

Aktuelle Version mit auschecken/klonen:
{{{#!vorlage Befehl
git clone https://github.com/raboof/nethogs.git
}}}

[[Vorlage(Fremd, Software)]]

und vorzugsweise mit [:checkinstall:] installieren:
{{{#!vorlage Befehl
cd nethogs && make && sudo -k checkinstall --pkgsource="https://github.com/raboof/nethogs/" --pkglicense="GPL2" --deldesc=no --nodoc --maintainer="$USER\\<$USER@$HOSTNAME\\>" --pkgarch=$(dpkg --print-architecture) --pkgversion="0.8.2" --pkgrelease="SNAPSHOT" --pkgname=nethogs make install
}}}
Die Nachfragen von Checkinstall mit [[Vorlage(Tasten, enter)]] bestätigen.

= Links =
 * [github:raboof/nethogs:Projektseite] {en}
 * [:Netzwerk-Monitoring:] {Übersicht}  Programmübersicht
 * Weitere Übersichtsseiten: [:Shell/Befehlsübersicht:] und [:Shell/Anwendungen:] 

#tag: Netzwerk, Internet, System