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.2.11 に対応する。

このドキュメントの 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.2.11 対応の翻訳は、太田俊哉 (ribbon@samba.gr.jp) によって行なわれた。