arp-scan

---

概要

arp-scan は、ARPプロトコルを使用してローカルネットワーク上のIPv4ホストを発見して識別するネットワークスキャンツールです。Linux、BSD、macOS、Solarisで利用可能で、GPLv3ライセンスの下で提供されています。

これは、arp-scan バージョン 1.10.1-git の README.md です。

インストール

ソースからのビルドとインストール

arp-scan はGNU automake および autoconf ツールを使用します。最新の github ソースからのインストール手順は次のとおりです：

• 最新のソースコードを取得するには git clone https://github.com/royhills/arp-scan.git を実行します。
• ソースコードディレクトリに入るには cd arp-scan を実行します。
• configure ファイルを生成するには autoreconf --install を実行します（autoreconf がない場合は、後述のとおり代わりにtarballをダウンロードできます）。
• システム用のmakefileを作成するには ./configure を実行します（設定オプションは後述）。
• プロジェクトをビルドするには make を実行します。
• オプションで、すべてが期待どおりに動作することを確認するには make check を実行します。
• インストールするには make install を実行します（この部分ではrootになるか、sudo/doasを使用する必要があります）。

以下の開発ツールとライブラリが必要です：

• GNU automake および autoconf（これらがない場合は、代わりに configure を含む最新のtarballをダウンロードできます：arp-scan-1.10.0.tar.gz）。これは最新の github 開発版ほど最新ではない可能性があることに注意してください。
• make ユーティリティ（BSD makeおよびGNU makeでテスト済み）。
• Cコンパイラ（gcc および clang でテスト済み。C99をサポートするCコンパイラであれば動作するはずです）。
• libpcap バージョン1.5以降用のライブラリとインクルードファイル。最近のディストリビューションのほとんどにはバイナリパッケージがあり、一部は libpcap ランタイムと libpcap-dev または libpcap-devel 開発パッケージに分割されています。その場合、ビルドするには開発版をインストールする必要があります。
• LinuxでPOSIX.1e capabilitiesサポート付きでビルドするための libcap。ほとんどのLinuxディストリビューションにはデフォルトでランタイムサポートが含まれており、開発パッケージも利用可能です。Linuxはカーネルバージョン 2.6.24 以降でケーパビリティをサポートしています。

Perlスクリプト arp-fingerprint と get-oui を実行するには、perl インタプリタとperlモジュール LWP::UserAgent および Text::CSV も必要です。

configure にオプションを渡してビルドプロセスを制御できます。オプションの一覧は ./configure --help を実行してください。arp-scan にはパッケージ固有の設定オプションが1つあります：

• --with-libcap[=auto/yes/no] libcap POSIX.1eケーパビリティサポート付きでビルドする [デフォルト=auto]

  auto の場合、configureは libcap ライブラリとヘッダーがインストールされていればケーパビリティサポートを有効にします。--with-libcap を指定するとサポートが有効になり、--without-libpcap を指定すると無効になります。

arp-scan は以下の環境でビルドおよび実行できることが確認されています：

• Linux（すべてのディストリビューションとアーキテクチャで動作するはずです）。
• FreeBSD
• OpenBSD
• NetBSD
• DragonflyBSD
• macOS
• Solaris 10（Solaris 11には既知の問題があります。気になる方はissue #31にコメントしてください）。

libpcap がサポートする任意のOSで arp-scan をビルドできるはずです。お使いのOSが libpcap をサポートしているにもかかわらず、configureで configure: error: Host operating system your-os-name is not supported というエラーが発生する場合は、issue を開いてお使いのOSへの移植をリクエストしてください。

バイナリパッケージからのインストール

多くのディストリビューションが arp-scan のバイナリパッケージを提供しています。これらはgithub上の最新ソースほど最新ではない可能性があり、最新リリースほど最新でないこともありますが、より便利で、パッケージマネージャによって最新の状態に保たれます。したがって、最新機能が必要ない場合は、バイナリパッケージを使用するのが良い選択となることがよくあります。

バイナリパッケージをインストールし、githubに有用な新機能がないか気になる場合は、arp-scan --version を使用してインストールされているバージョンを確認し、github上のNEWSおよびChangeLogファイルで変更内容の詳細を確認してください。

arp-scan バイナリパッケージのインストール方法の詳細は、お使いのディストリビューションによって異なります。

BSDポートからのインストール

BSDオペレーティングシステムを使用している場合、バイナリパッケージに加えて、ソースポートコレクションからインストールするオプションもあるかもしれません。

ポートはソースコードのビルドとインストールを自動化し、バイナリパッケージのように更新を管理します。また、ソースからインストールする柔軟性も提供します。ただし、ソースポートは最新のgithubほど最新ではないかもしれませんが、対応するバイナリパッケージよりも最新である場合もあります。

arp-scan ソースポートのインストール方法の詳細は、お使いのディストリビューションによって異なります。

ドキュメント

使用法の情報は次を使用します：

arp-scan --help

詳細については、マニュアルページ arp-scan(1)、arp-fingerprint(1)、get-oui(1)、mac-vendor(5) を参照してください。

arp-scan ウィキは https://github.com/royhills/arp-scan/wiki を参照してください。

arp-scan への貢献に興味がある場合は、CONTRIBUTING.md を参照してください。セキュリティの脆弱性を発見したと思われる場合は、SECURITY.md を参照してください。

パッケージメンテナ向けの注意事項

• アップストリームに適用できるローカルパッチがある場合は、github issueを立てるか、プルリクエストを作成してください。
• Linuxでビルドする場合は、可能であれば libcap POSIX.1eケーパビリティサポート付きでビルドしてください。configure を実行する前に、libpcap 開発ヘッダーに加えて libcap 開発ヘッダーをインストールする必要があるかもしれません。
• Makefile.am には install-exec-hook が含まれており、可能であれば CAP_NET_RAW ケーパビリティ付きで arp-scan をインストールし、それができない場合はsuid rootとしてインストールすることに注意してください。