waf: Rename nmblookup manpage to nmblookup4.
authorAndreas Schneider <asn@samba.org>
Thu, 6 Sep 2012 13:26:37 +0000 (15:26 +0200)
committerAndreas Schneider <asn@cryptomilk.org>
Fri, 7 Sep 2012 08:48:57 +0000 (10:48 +0200)
libcli/nbt/man/nmblookup4.1.xml [moved from libcli/nbt/man/nmblookup.1.xml with 66% similarity]
libcli/nbt/wscript_build

similarity index 66%
rename from libcli/nbt/man/nmblookup.1.xml
rename to libcli/nbt/man/nmblookup4.1.xml
index cf3d4013ac6fdfd3e3e016596341d08c1d4053c8..198afec47cd1ef8173f55bce41c8696b3d31c477 100644 (file)
@@ -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>
 
 
 <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>
        <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>
 
        <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>
 
                <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.
 
                <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>
 
                <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>
 <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>
 
 
 <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>
index f67ba91598267074ea7d973bbbe002d822c307bd..c4a9428142f8a0482884df86fb124977e1a4e995 100755 (executable)
@@ -19,7 +19,7 @@ bld.SAMBA_LIBRARY('cli-nbt',
 
 bld.SAMBA_BINARY('nmblookup' + bld.env.suffix4,
                  source='tools/nmblookup.c',
-                 manpages='man/nmblookup.1',
+                 manpages='man/nmblookup4.1',
                  deps='samba-hostconfig samba-util cli-nbt popt POPT_SAMBA netif LIBCLI_RESOLVE'
                  )