mirror of
https://github.com/samba-team/samba.git
synced 2025-01-17 02:05:21 +03:00
-
146 lines
7.2 KiB
HTML
146 lines
7.2 KiB
HTML
|
|
|
|
|
|
|
|
|
|
<html><head><title>nmblookup</title>
|
|
|
|
<link rev="made" href="mailto:samba-bugs@samba.anu.edu.au">
|
|
</head>
|
|
<body>
|
|
|
|
<hr>
|
|
|
|
<h1>nmblookup</h1>
|
|
<h2>Samba</h2>
|
|
<h2>23 Oct 1998</h2>
|
|
|
|
|
|
|
|
|
|
<p><br><a name="NAME"></a>
|
|
<h2>NAME</h2>
|
|
nmblookup - NetBIOS over TCP/IP client used to lookup NetBIOS names
|
|
<p><br><a name="SYNOPSIS"></a>
|
|
<h2>SYNOPSIS</h2>
|
|
|
|
<p><br><strong>nmblookup</strong> [<a href="nmblookup.1.html#minusM">-M</a>] [<a href="nmblookup.1.html#minusR">-R</a>] [<a href="nmblookup.1.html#minusS">-S</a>] [<a href="nmblookup.1.html#minusr">-r</a>] [<a href="nmblookup.1.html#minusA">-A</a>] [<a href="nmblookup.1.html#minush">-h</a>] [<a href="nmblookup.1.html#minusB">-B broadcast address</a>] [<a href="nmblookup.1.html#minusU">-U unicast address</a>] [<a href="nmblookup.1.html#minusd">-d debuglevel</a>] [<a href="nmblookup.1.html#minuss">-s smb config file</a>] [<a href="nmblookup.1.html#minusi">-i NetBIOS scope</a>] <a href="nmblookup.1.html#name">name</a>
|
|
<p><br><a name="DESCRIPTION"></a>
|
|
<h2>DESCRIPTION</h2>
|
|
|
|
<p><br>This program is part of the <strong>Samba</strong> suite.
|
|
<p><br><strong>nmblookup</strong> is used to query NetBIOS names and map them to IP
|
|
addresses in a network using NetBIOS over TCP/IP queries. The options
|
|
allow the name queries to be directed at a particlar IP broadcast area
|
|
or to a particular machine. All queries are done over UDP.
|
|
<p><br><a name="OPTIONS"></a>
|
|
<h2>OPTIONS</h2>
|
|
|
|
<p><br><ul>
|
|
<p><br><a name="minusM"></a>
|
|
<li><strong><strong>-M</strong></strong> Searches for a master browser. This is done by doing a
|
|
broadcast lookup on the special name <code>__MSBROWSE__</code>.
|
|
<p><br><a name="minusR"></a>
|
|
<li><strong><strong>-R</strong></strong> Set the recursion desired bit in the packet to do a
|
|
recursive lookup. This is used when sending a name query to a machine
|
|
running a WINS server and the user wishes to query the names in the
|
|
WINS server. If this bit is unset the normal (broadcast responding)
|
|
NetBIOS processing code on a machine is used instead. See rfc1001,
|
|
rfc1002 for details.
|
|
<p><br><a name="minusS"></a>
|
|
<li><strong><strong>-S</strong></strong> Once the name query has returned an IP address then do a
|
|
node status query as well.
|
|
<p><br><a name="minusr"></a>
|
|
<li><strong><strong>-r</strong></strong> Try and bind to UDP port 137 to send and receive UDP
|
|
datagrams. The reason for this option is a bug in Windows 95 where it
|
|
ignores the source port of the requesting packet and only replies to
|
|
UDP port 137. Unfortunately, on most UNIX systems root privillage is
|
|
needed to bind to this port, and in addition, if the
|
|
<a href="nmbd.8.html"><strong>nmbd</strong></a> daemon is running on this machine it also
|
|
binds to this port.
|
|
<p><br><a name="minusA"></a>
|
|
<li><strong><strong>-A</strong></strong> Interpret <name> as an IP Address and do a node status
|
|
query on this address.
|
|
<p><br><a name="minush"></a>
|
|
<li><strong><strong>-h</strong></strong> Print a help (usage) message.
|
|
<p><br><a name="minusB"></a>
|
|
<li><strong><strong>-B broadcast address</strong></strong> Send the query to the given broadcast
|
|
address. Without this option the default behavior of nmblookup is to
|
|
send the query to the broadcast address of the primary network
|
|
interface as either auto-detected or defined in the
|
|
<a href="smb.conf.5.html#interfaces"><strong>interfaces</strong></a> parameter of the
|
|
<a href="smb.conf.5.html"><strong>smb.conf (5)</strong></a> file.
|
|
<p><br><a name="minusU"></a>
|
|
<li><strong><strong>-U unicast address</strong></strong> Do a unicast query to the specified
|
|
address or host <code>"unicast address"</code>. This option (along with the
|
|
<a href="nmblookup.1.html#minusR"><strong>-R</strong></a> option) is needed to query a WINS server.
|
|
<p><br><a name="minusd"></a>
|
|
<li><strong><strong>-d debuglevel</strong></strong> debuglevel is an integer from 0 to 10.
|
|
<p><br>The default value if this parameter is not specified is zero.
|
|
<p><br>The higher this value, the more detail will be logged about the
|
|
activities of <strong>nmblookup</strong>. At level 0, only critical errors and
|
|
serious warnings will be logged.
|
|
<p><br>Levels above 1 will generate considerable amounts of log data, and
|
|
should only be used when investigating a problem. Levels above 3 are
|
|
designed for use only by developers and generate HUGE amounts of
|
|
data, most of which is extremely cryptic.
|
|
<p><br>Note that specifying this parameter here will override the <a href="smb.conf.5.html#loglevel"><strong>log
|
|
level</strong></a> parameter in the <a href="smb.conf.5.html"><strong>smb.conf
|
|
(5)</strong></a> file.
|
|
<p><br><a name="minuss"></a>
|
|
<li><strong><strong>-s smb.conf</strong></strong> This parameter specifies the pathname to the
|
|
Samba configuration file, smb.conf. This file controls all aspects of
|
|
the Samba setup on the machine and smbclient also needs to read this
|
|
file.
|
|
<p><br><a name="minusi"></a>
|
|
<li><strong><strong>-i scope</strong></strong> This specifies a NetBIOS scope that smbclient will use
|
|
to communicate with when generating NetBIOS names. For details on the
|
|
use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS scopes
|
|
are <em>very</em> rarely used, only set this parameter if you are the
|
|
system administrator in charge of all the NetBIOS systems you
|
|
communicate with.
|
|
<p><br><a name="name"></a>
|
|
<li><strong><strong>name</strong></strong> This is the NetBIOS name being queried. Depending upon
|
|
the previous options this may be a NetBIOS name or IP address. If a
|
|
NetBIOS name then the different name types may be specified by
|
|
appending <code>#<type></code> to the name.
|
|
<p><br></ul>
|
|
<p><br><a name="EXAMPLES"></a>
|
|
<h2>EXAMPLES</h2>
|
|
|
|
<p><br><strong>nmblookup</strong> can be used to query a WINS server (in the same way .B
|
|
nslookup is used to query DNS servers). To query a WINS server,
|
|
nmblookup must be called like this:
|
|
<p><br><code>nmblookup -U server -R 'name'</code>
|
|
<p><br>For example, running :
|
|
<p><br><code>nmblookup -U samba.anu.edu.au -R IRIX#1B'</code>
|
|
<p><br>would query the WINS server samba.anu.edu.au for the domain master
|
|
browser (1B name type) for the IRIX workgroup.
|
|
<p><br><a name="VERSION"></a>
|
|
<h2>VERSION</h2>
|
|
|
|
<p><br>This man page is correct for version 2.0 of the Samba suite.
|
|
<p><br><a name="SEEALSO"></a>
|
|
<h2>SEE ALSO</h2>
|
|
|
|
<p><br><a href="samba.7.html"><strong>samba (7)</strong></a>, <a href="nmbd.8.html"><strong>nmbd (8)</strong></a>,
|
|
<a href="smb.conf.5.html"><strong>smb.conf (5)</strong></a>
|
|
<p><br><a name="AUTHOR"></a>
|
|
<h2>AUTHOR</h2>
|
|
|
|
<p><br>The original Samba software and related utilities were created by
|
|
Andrew Tridgell (samba-bugs@samba.anu.edu.au). Samba is now developed
|
|
by the Samba Team as an Open Source project similar to the way the
|
|
Linux kernel is developed.
|
|
<p><br>The original Samba man pages were written by Karl Auer. The man page
|
|
sources were converted to YODL format (another excellent piece of Open
|
|
Source software, available at
|
|
<a href="ftp://ftp.icce.rug.nl/pub/unix/"><strong>ftp://ftp.icce.rug.nl/pub/unix/</strong></a>)
|
|
and updated for the Samba2.0 release by Jeremy Allison.
|
|
<a href="mailto:samba-bugs@samba.anu.edu.au"><em>samba-bugs@samba.anu.edu.au</em></a>.
|
|
<p><br>See <a href="samba.7.html"><strong>samba (7)</strong></a> to find out how to get a full
|
|
list of contributors and details on how to submit bug reports,
|
|
comments etc.
|
|
<p><br></body>
|
|
</html>
|