mirror of
https://github.com/samba-team/samba.git
synced 2024-12-24 21:34:56 +03:00
eae6d76a36
writing that they are correct for version x is not always precise. But we're working on that also :-) Signed-off-by: Bjoern Jacke <bjacke@samba.org> Reviewed-by: Andrew Bartlett <abartlet@samba.org> Reviewed-by: Garming Sam <garming@catalyst.net.nz>
215 lines
7.2 KiB
XML
215 lines
7.2 KiB
XML
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
<!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
|
|
<refentry id="nmblookup">
|
|
|
|
<refmeta>
|
|
<refentrytitle>nmblookup</refentrytitle>
|
|
<manvolnum>1</manvolnum>
|
|
<refmiscinfo class="source">Samba</refmiscinfo>
|
|
<refmiscinfo class="manual">User Commands</refmiscinfo>
|
|
<refmiscinfo class="version">&doc.version;</refmiscinfo>
|
|
</refmeta>
|
|
|
|
|
|
<refnamediv>
|
|
<refname>nmblookup</refname>
|
|
<refpurpose>NetBIOS over TCP/IP client used to lookup NetBIOS
|
|
names</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<cmdsynopsis>
|
|
<command>nmblookup</command>
|
|
<arg choice="opt">-M|--master-browser</arg>
|
|
<arg choice="opt">-R|--recursion</arg>
|
|
<arg choice="opt">-S|--status</arg>
|
|
<arg choice="opt">-r|--root-port</arg>
|
|
<arg choice="opt">-A|--lookup-by-ip</arg>
|
|
<arg choice="opt">-B|--broadcast <broadcast address></arg>
|
|
<arg choice="opt">-U|--unicast <unicast address></arg>
|
|
<arg choice="opt">-d <debug level></arg>
|
|
<arg choice="opt">-s <smb config file></arg>
|
|
<arg choice="opt">-i <NetBIOS scope></arg>
|
|
<arg choice="opt">-T|--translate</arg>
|
|
<arg choice="opt">-f|--flags</arg>
|
|
<arg choice="req">name</arg>
|
|
</cmdsynopsis>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1>
|
|
<title>DESCRIPTION</title>
|
|
|
|
<para>This tool is part of the <citerefentry><refentrytitle>samba</refentrytitle>
|
|
<manvolnum>7</manvolnum></citerefentry> suite.</para>
|
|
|
|
<para><command>nmblookup</command> 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
|
|
particular IP broadcast area or to a particular machine. All queries
|
|
are done over UDP.</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>OPTIONS</title>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>-M|--master-browser</term>
|
|
<listitem><para>Searches for a master browser by looking
|
|
up the NetBIOS <replaceable>name</replaceable> with a
|
|
type of <constant>0x1d</constant>. If <replaceable>
|
|
name</replaceable> is "-" then it does a lookup on the special name
|
|
<constant>__MSBROWSE__</constant>. Please note that in order to
|
|
use the name "-", you need to make sure "-" isn't parsed as an
|
|
argument, e.g. use :
|
|
<userinput>nmblookup -M -- -</userinput>.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>-R|--recursion</term>
|
|
<listitem><para>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.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>-S|--status</term>
|
|
<listitem><para>Once the name query has returned an IP
|
|
address then do a node status query as well. A node status
|
|
query returns the NetBIOS names registered by a host.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
|
|
<varlistentry>
|
|
<term>-r|--root-port</term>
|
|
<listitem><para>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 privilege is needed to bind to this port, and
|
|
in addition, if the <citerefentry><refentrytitle>nmbd</refentrytitle>
|
|
<manvolnum>8</manvolnum></citerefentry> daemon is running on this machine it also binds to this port.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
|
|
<varlistentry>
|
|
<term>-A|--lookup-by-ip</term>
|
|
<listitem><para>Interpret <replaceable>name</replaceable> as
|
|
an IP Address and do a node status query on this address.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
|
|
|
|
&popt.common.connection;
|
|
&popt.autohelp;
|
|
|
|
<varlistentry>
|
|
<term>-B|--broadcast <broadcast address></term>
|
|
<listitem><para>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 network interfaces as
|
|
either auto-detected or defined in the <ulink
|
|
url="smb.conf.5.html#INTERFACES"><parameter>interfaces</parameter>
|
|
</ulink> parameter of the <citerefentry><refentrytitle>smb.conf</refentrytitle>
|
|
<manvolnum>5</manvolnum></citerefentry> file.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
<term>-U|--unicast <unicast address></term>
|
|
<listitem><para>Do a unicast query to the specified address or
|
|
host <replaceable>unicast address</replaceable>. This option
|
|
(along with the <parameter>-R</parameter> option) is needed to
|
|
query a WINS server.</para></listitem>
|
|
</varlistentry>
|
|
|
|
&stdarg.server.debug;
|
|
&popt.common.samba;
|
|
|
|
<varlistentry>
|
|
<term>-T|--translate</term>
|
|
<listitem><para>This causes any IP addresses found in the
|
|
lookup to be looked up via a reverse DNS lookup into a
|
|
DNS name, and printed out before each</para>
|
|
|
|
<para><emphasis>IP address .... NetBIOS name</emphasis></para>
|
|
|
|
<para> pair that is the normal output.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>-f|--flags</term>
|
|
<listitem><para>
|
|
Show which flags apply to the name that has been looked up. Possible
|
|
answers are zero or more of: Response, Authoritative,
|
|
Truncated, Recursion_Desired, Recursion_Available, Broadcast.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
|
|
<varlistentry>
|
|
<term>name</term>
|
|
<listitem><para>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 '#<type>' to the name. This name may also be
|
|
'*', which will return all registered names within a broadcast
|
|
area.</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1>
|
|
|
|
|
|
<refsect1>
|
|
<title>EXAMPLES</title>
|
|
|
|
<para><command>nmblookup</command> can be used to query
|
|
a WINS server (in the same way <command>nslookup</command> is
|
|
used to query DNS servers). To query a WINS server, <command>nmblookup</command>
|
|
must be called like this:</para>
|
|
|
|
<para><command>nmblookup -U server -R 'name'</command></para>
|
|
|
|
<para>For example, running :</para>
|
|
|
|
<para><command>nmblookup -U samba.org -R 'IRIX#1B'</command></para>
|
|
|
|
<para>would query the WINS server samba.org for the domain
|
|
master browser (1B name type) for the IRIX workgroup.</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>VERSION</title>
|
|
|
|
<para>This man page is part of version &doc.version; of
|
|
the Samba suite.</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>SEE ALSO</title>
|
|
<para><citerefentry><refentrytitle>nmbd</refentrytitle>
|
|
<manvolnum>8</manvolnum></citerefentry>, <citerefentry><refentrytitle>samba</refentrytitle>
|
|
<manvolnum>7</manvolnum></citerefentry>, and <citerefentry><refentrytitle>smb.conf</refentrytitle>
|
|
<manvolnum>5</manvolnum></citerefentry>.</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>AUTHOR</title>
|
|
|
|
<para>The original Samba software and related utilities
|
|
were created by Andrew Tridgell. Samba is now developed
|
|
by the Samba Team as an Open Source project similar
|
|
to the way the Linux kernel is developed.</para>
|
|
</refsect1>
|
|
|
|
</refentry>
|