summaryrefslogtreecommitdiff
path: root/libcli/nbt/man
diff options
context:
space:
mode:
Diffstat (limited to 'libcli/nbt/man')
-rw-r--r--libcli/nbt/man/nmblookup4.1.xml (renamed from libcli/nbt/man/nmblookup.1.xml)130
1 files changed, 65 insertions, 65 deletions
diff --git a/libcli/nbt/man/nmblookup.1.xml b/libcli/nbt/man/nmblookup4.1.xml
index cf3d4013ac..198afec47c 100644
--- a/libcli/nbt/man/nmblookup.1.xml
+++ b/libcli/nbt/man/nmblookup4.1.xml
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
-<refentry id="nmblookup">
+<refentry id="nmblookup4">
<refmeta>
- <refentrytitle>nmblookup</refentrytitle>
+ <refentrytitle>nmblookup4</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="source">Samba</refmiscinfo>
<refmiscinfo class="manual">User Commands</refmiscinfo>
@@ -12,14 +12,14 @@
<refnamediv>
- <refname>nmblookup</refname>
- <refpurpose>NetBIOS over TCP/IP client used to lookup NetBIOS
+ <refname>nmblookup4</refname>
+ <refpurpose>NetBIOS over TCP/IP client used to lookup NetBIOS
names</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
- <command>nmblookup</command>
+ <command>nmblookup4</command>
<arg choice="opt">-M</arg>
<arg choice="opt">-R</arg>
<arg choice="opt">-S</arg>
@@ -43,10 +43,10 @@
<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
+ <para><command>nmblookup4</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>
@@ -56,43 +56,43 @@
<variablelist>
<varlistentry>
<term>-M</term>
- <listitem><para>Searches for a master browser by looking
- up the NetBIOS name <replaceable>name</replaceable> with a
+ <listitem><para>Searches for a master browser by looking
+ up the NetBIOS name <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>
+ 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>nmblookup4 -M -- -</userinput>.</para></listitem>
</varlistentry>
-
+
<varlistentry>
<term>-R</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
+ <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</term>
- <listitem><para>Once the name query has returned an IP
- address then do a node status query as well. A node status
+ <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</term>
+ <term>-r</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
+ 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>
@@ -101,17 +101,17 @@
<varlistentry>
<term>-A</term>
- <listitem><para>Interpret <replaceable>name</replaceable> as
+ <listitem><para>Interpret <replaceable>name</replaceable> as
an IP Address and do a node status query on this address.</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>-B &lt;broadcast address&gt;</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
+ <term>-B &lt;broadcast address&gt;</term>
+ <listitem><para>Send the query to the given broadcast address. Without
+ this option the default behavior of nmblookup4 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.
@@ -120,28 +120,28 @@
<varlistentry>
<term>-U &lt;unicast address&gt;</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
+ <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>
<varlistentry>
- <term>-T</term>
- <listitem><para>This causes any IP addresses found in the
- lookup to be looked up via a reverse DNS lookup into a
+ <term>-T</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</term>
<listitem><para>
- Show which flags apply to the name that has been looked up. Possible
- answers are zero or more of: Response, Authoritative,
+ 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>
@@ -149,11 +149,11 @@
<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
+ <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 '#&lt;type&gt;' to the name. This name may also be
- '*', which will return all registered names within a broadcast
+ '*', which will return all registered names within a broadcast
area.</para></listitem>
</varlistentry>
</variablelist>
@@ -163,25 +163,25 @@
<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>
+ <para><command>nmblookup4</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>nmblookup4</command>
must be called like this:</para>
- <para><command>nmblookup -U server -R 'name'</command></para>
+ <para><command>nmblookup4 -U server -R 'name'</command></para>
<para>For example, running :</para>
- <para><command>nmblookup -U samba.org -R 'IRIX#1B'</command></para>
+ <para><command>nmblookup4 -U samba.org -R 'IRIX#1B'</command></para>
- <para>would query the WINS server samba.org for the domain
+ <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 correct for version 3 of
+ <para>This man page is correct for version 3 of
the Samba suite.</para>
</refsect1>
@@ -195,17 +195,17 @@
<refsect1>
<title>AUTHOR</title>
-
- <para>The original Samba software and related utilities
+
+ <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
+ by the Samba Team as an Open Source project similar
to the way the Linux kernel is developed.</para>
-
- <para>The original Samba man pages were written by Karl Auer.
- The man page sources were converted to YODL format (another
+
+ <para>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 <ulink url="ftp://ftp.icce.rug.nl/pub/unix/">
- ftp://ftp.icce.rug.nl/pub/unix/</ulink>) and updated for the Samba 2.0
- release by Jeremy Allison. The conversion to DocBook for
+ ftp://ftp.icce.rug.nl/pub/unix/</ulink>) and updated for the Samba 2.0
+ release by Jeremy Allison. The conversion to DocBook for
Samba 2.2 was done by Gerald Carter. The conversion to DocBook
XML 4.2 for Samba 3.0 was done by Alexander Bokovoy.</para>
</refsect1>