arp-scan

---

Über

arp-scan ist ein Netzwerk-Scanning-Tool, das das ARP-Protokoll verwendet, um IPv4-Hosts im lokalen Netzwerk zu entdecken und per Fingerprinting zu identifizieren. Es ist für Linux, BSD, macOS und Solaris unter der GPLv3-Lizenz verfügbar.

Dies ist README.md für arp-scan Version 1.10.1-git.

Installation

Erstellen und Installieren aus dem Quellcode

arp-scan verwendet die GNU-automake- und autoconf-Werkzeuge. Der Installationsprozess aus dem neuesten github-Quellcode ist:

• git clone https://github.com/royhills/arp-scan.git, um den neuesten Quellcode zu erhalten.
• cd arp-scan, um in das Quellcode-Verzeichnis zu wechseln.
• autoreconf --install, um eine configure-Datei zu erzeugen (falls du kein autoreconf hast, kannst du stattdessen ein Tarball herunterladen, wie unten beschrieben).
• ./configure, um ein Makefile für dein System zu erstellen (siehe Konfigurationsoptionen unten).
• make, um das Projekt zu bauen.
• Optional make check, um zu überprüfen, ob alles wie erwartet funktioniert.
• make install, um zu installieren (du musst dazu root sein oder sudo/doas verwenden).

Du benötigst diese Entwicklungswerkzeuge und -bibliotheken:

• GNU automake und autoconf (falls du diese nicht hast, kannst du stattdessen das neueste Tarball herunterladen, das configure enthält: arp-scan-1.10.0.tar.gz). Beachte, dass dieses möglicherweise nicht so aktuell ist wie die neueste github-Entwicklungsversion.
• Das make-Dienstprogramm (getestet mit BSD make und GNU make).
• Ein C-Compiler (getestet mit gcc und clang, sollte mit jedem C-Compiler funktionieren, der C99 unterstützt).
• Bibliotheken und Include-Dateien für libpcap Version 1.5 oder neuer. Alle modernen Distributionen haben ein Binärpaket; einige teilen das Paket in ein libpcap-Laufzeitpaket und libpcap-dev- oder libpcap-devel-Entwicklungspakete auf. In diesem Fall musst du die Entwicklungsversion installieren, um zu bauen.
• libcap, um auf Linux mit POSIX.1e-Capabilities-Unterstützung zu bauen. Die meisten Linux-Distributionen verfügen standardmäßig über Laufzeitunterstützung und haben ein Entwicklungspaket verfügbar. Linux unterstützt Capabilities seit Kernel-Version 2.6.24.

Um die Perl-Skripte arp-fingerprint und get-oui auszuführen, benötigst du außerdem den perl-Interpreter und die Perl-Module LWP::UserAgent und Text::CSV.

Du kannst configure Optionen übergeben, um den Build-Prozess zu steuern. Führe ./configure --help aus, um eine Liste der Optionen zu erhalten. arp-scan hat eine paketspezifische configure-Option:

• --with-libcap[=auto/yes/no] Mit Unterstützung für libcap-POSIX.1e-Capabilities bauen [Standard=auto]

  Bei auto aktiviert configure die Capability-Unterstützung, wenn die libcap-Bibliothek und die Header installiert sind. Die Angabe von --with-libcap aktiviert die Unterstützung und --without-libpcap deaktiviert sie.

arp-scan ist bekanntermaßen auf folgenden Systemen bau- und lauffähig:

• Linux (sollte auf jeder Distribution und allen Architekturen funktionieren).
• FreeBSD
• OpenBSD
• NetBSD
• DragonflyBSD
• macOS
• Solaris 10 (es gibt bekannte Probleme mit Solaris 11. Falls es jemanden interessiert, kommentiere bitte unter Issue #31).

Es sollte möglich sein, arp-scan auf jedem Betriebssystem zu bauen, das libpcap unterstützt. Falls dein Betriebssystem libpcap unterstützt, configure aber den Fehler configure: error: Host operating system your-os-name is not supported ausgibt, öffne bitte ein Issue, um eine Portierung auf dein Betriebssystem anzufordern.

Installation aus einem Binärpaket

Viele Distributionen bieten Binärpakete für arp-scan an. Diese sind nicht so aktuell wie der neueste Quellcode auf github und möglicherweise nicht so aktuell wie das neueste Release, aber sie sind bequemer und werden vom Paketmanager aktuell gehalten. Die Verwendung eines Binärpakets ist daher oft eine gute Wahl, wenn du die neuesten Funktionen nicht benötigst.

Wenn du ein Binärpaket installiert hast und dich fragst, ob es nützliche neue Funktionen auf github gibt, verwende arp-scan --version, um zu überprüfen, welche Version du hast, und sieh dann in den Dateien NEWS und ChangeLog auf github nach, um Details zu den Änderungen zu erfahren.

Die Details zur Installation eines arp-scan-Binärpakets hängen von deiner Distribution ab.

Installation aus einem BSD-Port

Wenn du ein BSD-Betriebssystem verwendest, hast du möglicherweise die Möglichkeit, sowohl aus einer Source-Ports-Collection als auch aus einem Binärpaket zu installieren.

Ports automatisieren das Erstellen und Installieren von Quellcode und verwalten Updates wie ein Binärpaket. Sie bieten außerdem die Flexibilität, aus dem Quellcode zu installieren. Ein Source-Port ist allerdings nicht so aktuell wie der neueste github-Quellcode, aber manchmal aktueller als das entsprechende Binärpaket.

Die Details zur Installation eines arp-scan-Source-Ports hängen von deiner Distribution ab.

Dokumentation

Für Nutzungsinformationen verwende:

arp-scan --help

Für detaillierte Informationen siehe die Handbuchseiten: arp-scan(1), arp-fingerprint(1), get-oui(1) und mac-vendor(5).

Siehe das arp-scan-Wiki unter https://github.com/royhills/arp-scan/wiki

Siehe CONTRIBUTING.md, wenn du daran interessiert bist, zu arp-scan beizutragen. Wenn du glaubst, eine Sicherheitslücke gefunden zu haben, siehe bitte SECURITY.md.

Hinweise für Paketbetreuer

• Bitte erstelle ein github-Issue oder einen Pull-Request, wenn du lokale Patches hast, die upstream übernommen werden könnten.
• Wenn du auf Linux baust, baue bitte nach Möglichkeit mit libcap-POSIX.1e-Capabilities-Unterstützung. Möglicherweise musst du die libcap-Entwicklungs-Header sowie die libpcap-Entwicklungs-Header installieren, bevor du configure ausführst.
• Beachte, dass Makefile.am einen install-exec-hook enthält, der arp-scan nach Möglichkeit mit CAP_NET_RAW-Capabilities installiert und es andernfalls suid root installiert.