Name

nmblookup — NetBIOS 名を検索する NetBIOS over TCP/IP クライアント

Synopsis

nmblookup [-M|--master-browser] [-R|--recursion] [-S|--status] [-r|--root-port] [-A|--lookup-by-ip] [-B|--broadcast <broadcast address>] [-U|--unicast <unicast address>] [-d <debug level>] [-s <smb config file>] [-i <NetBIOS scope>] [-T|--translate] [-f|--flags] {name}

解説

このツールは samba(7) の一部である。

nmblookup は、NetBIOS over TCP/IP が使われているネットワークにおいて、NetBIOS 名の問い合わせや、IP アドレスへの変換に使われる。オプションを設定することで、 特定のブロードキャストアドレスや特定のマシンに対して名前の問い合わせを 行なう事ができる。全ての問い合わせは、UDP を使って行なわれる。

オプション

-M|--master-browser

タイプ 0x1d の NetBIOS name に問い合わせることで、 マスターブラウザーの検索をおこなう。name が "-" の場合、特殊な名前である __MSBROWSE__ の検索を行う。 もし name に "-" を使用したいのなら、"-" が引数として扱われない ように注意しなければならない。使用例: nmblookup -M -- -

-R|--recursion

再帰検索を行なう為に、パケット中の 再帰要求ビットを設定する。これは、WINS サーバーが動作している マシンに対して問い合わせを行ない、WINS サーバーに名前を 問い合わせたいときに使用する。このビットが設定されていない場合、 通常の(ブロードキャスト応答による) NetBIOS 名の応答処理が 行われる。詳細は RFC1001 および RFC1002 を参照の事。

-S|--status

名前問い合わせで IP アドレスが返却された場合、 ノードステータスの問い合わせも行なう。 ノードステータスの問い合わせは、そのホストが登録している NetBIOS 名の一覧を返却する。

-r|--root-port

UDP のポート 137 を使って、UDP データグラムを送受信する。このオプションは、 Windows 95 がパケットの送信元のポートを無視して UDPのポート 137 にしか応答を返却しないというバグに対応する為のものである。 しかし、ほとんどの UNIX システムで、このポートを使用するには root 権限が必要であり、更に、nmbd(8) デーモンが動作している場合、 このポートを使用している。

-A|--lookup-by-ip

name を IP アドレスとして解釈して、ノードステータスの問い合わせを このアドレスに行なう。

-n|--netbiosname <primary NetBIOS name>

This option allows you to override the NetBIOS name that Samba uses for itself. This is identical to setting the netbios name parameter in the smb.conf file. However, a command line setting will take precedence over settings in smb.conf.

-i|--scope <scope>

nmblookupが、通信用のNetBIOS名 を生成する時に使うNetBIOS スコープを指定する。NetBIOS スコープの詳細な 利用方法については、 RFC 1001 と RFC 1002 を参照のこと。NetBIOSスコープ はごく稀にしか利用されない。NetBIOS システム 全体を運営している管理者が、そのシステム内の相手と通信する場合にのみ、 このパラメーターを設定する。

-W|--workgroup=domain

ユーザー名の SMB ドメインを指定する。このオプションは、 smb.conf 内のデフォルトのドメイン設定よりも優先される。ドメイン名として サーバーの NetBIOS 名を指定すると、クライアントは (ドメインの SAM では なく) サーバーのローカル SAM を使用してログオンを試みる。

-O|--socket-options socket options

クライアントのソケットに設定する TCP のソケットオプ ション。有効なオプションの一覧については、smb.conf マニュアルページ 中の socket options パラメーターを参照のこと。

-?|--help

コマンドラインオプションの要約を表示する。

--usage

簡単な使用法を表示する。

-B|--broadcast <broadcast address>

指定されたブロードキャストアドレスに対し 問い合わせを送信する。このオプションを指定しない場合の nmblookup のデフォルト動作は、問い合わせを ネットワークインタフェースのブロードキャストアドレスに送信する。 ネットワークインタフェースのブロードキャストアドレスは、 自動検出に任せるか smb.conf(5) の interfaces パラメーターで指定する。

-U|--unicast <unicast address>

指定されたアドレスもしくは unicast address で指定したホストに 対して、ユニキャストの問い合わせを行なう。このオプションは、 (-R オプションと共に) WINS サーバーに問い合わせを行なう時には必須である。

-d|--debuglevel=level

level は0から10までの整数値である。 既定値の値は、パラメーターが設定されていなければ0である。

この値を大きくするほど、サーバーの動作に関するより詳細な情報が ログファイルに記録される。レベル 0 では、致命的なエラーと重大な警告 のみが記録される。レベル 1 は日々の運用に適しており、少量の稼働状況 に関する情報を生成する。

1 より上のレベルは大量のログが生成されるので、問題解決の時にのみ 使用すべきである。 3 より上のレベルは開発者だけが利用するように設計されて おり、莫大な量のログデータが生成される。そのほとんどは非常に謎めいた内容 となっている

このパラメーターの指定は、smb.conf ファイル中の、 log level パラメーターの 指定よりも優先する事に注意。

-V|--version

プログラムのバージョン番号を表示する。

-s|--configfile=<configuration file>

サーバーが必要とする詳細な設定を含む設定ファイルを 指定する。このファイルには、サーバーが提供するサービスに関する記述や、 どの printcap ファイルを利用するかといった情報が含まれている。詳細は smb.conf を参照のこと。設定ファイルの名前の既定値は、コンパイル時 に決定される。

-l|--log-basename=logdirectory

ログ/デバッグファイルのファイル名。拡張子として ".progname" が追加される(例えば log.smbclient, log.smbd,など)。ログファイルはクライアントによって削除されることはない。

-T|--translate

このパラメーターは、問い合わせ中に発見した あらゆる IP アドレスについて DNS の逆引きを行うことで、 DNS 名を取得し、標準的な表示である

IPアドレス .... NetBIOS名

の組の前に表示する。

-f|--flags

検索した名前に適用されているフラグを表示させる。 フラグには Response(レスポンス)、 Authoritative(権威がある)、Recursion_Desired、 Recursive_available、Broadcast(ブロードキャスト)などがある。

name

これは問合せ対象の NetBIOS 名である。 オプションの指定によっては、NetBIOS 名の場合もあれば、IP アドレスの場合もある。NetBIOS 名の場合は、名前の最後に '#<type>' を追加する事で名前のタイプを指定する事ができる。 名前として「*」を指定することもでき、その場合はブロードキャストの 範囲内に登録されている全ての名前が返却される。

使用例

nmblookup は、 (nslookup が DNS サーバーに対して 問い合わせるのと同様に) WINSサーバーに対して問い合わせを 行うことができる。WINS サーバーに問い合わせを行なう際は、 nmblookup を以下のようにして実行する 必要がある:

nmblookup -U server -R 'name'

たとえば、以下のように実行する:

nmblookup -U samba.org -R 'IRIX#1B'

これは、samba.org の WINSサーバーに対して、IRIX ワークグループのドメインマスターブラウザー (タイプ1B) を問い合わせる。

バージョン

このマニュアルページは Samba 3 に対応する。

関連項目

nmbd(8)samba(7)smb.conf(5)

著者

オリジナルの Samba ソフトウェアと関連ユーティリティは、 Andrew Tridgellによって作成された。 現在 Samba は、Samba Team によって Linux カーネルの 開発と同様に、オープンソースプロジェクトとして 開発されている。

オリジナルのSambaマニュアルは、Karl Auer によって執筆された。 マニュアルのソースは Jeremy Allison によって YODL 形式に変換され、 Samba 2.0 リリース用に更新された。 (YODL はオープンソース・ソフトウエアの優れた作品である ftp://ftp.icce.rug.nl/pub/unix/ より入手可能。) Samba 2.2 における DocBook形式への変換は Gerald Carter によって行なわれた。Samba 3.0 における DocBook XML 4.2 形式への変換は Alexander Bokovoy によって行われた。

日本語訳

このマニュアルページは Samba 4.1.4 - 4.1.22 に対応する。

このドキュメントの Samba 3.0.0 対応の翻訳は

  • たかはしもとのぶ (monyo@samba.gr.jp)

  • はせがわ ようすけ

  • 山田 史朗 (shiro@miraclelinux.com)

Samba 3.0.3 - Samba 3.0.24 対応の翻訳は、たかはしもとのぶ (monyo@samba.gr.jp) によって行なわれた。

Samba 3.2.4 - 4.1.22 対応の翻訳は、太田俊哉 (ribbon@samba.gr.jp) によって行なわれた。