docs: Rename manpages-3 -> manpages.
[kai/samba.git] / docs-xml / manpages-3 / findsmb.1.xml
diff --git a/docs-xml/manpages-3/findsmb.1.xml b/docs-xml/manpages-3/findsmb.1.xml
deleted file mode 100644 (file)
index 92bcbbe..0000000
+++ /dev/null
@@ -1,153 +0,0 @@
-<?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="findsmb.1">
-
-<refmeta>
-       <refentrytitle>findsmb</refentrytitle>
-       <manvolnum>1</manvolnum>
-       <refmiscinfo class="source">Samba</refmiscinfo>
-       <refmiscinfo class="manual">User Commands</refmiscinfo>
-       <refmiscinfo class="version">3.6</refmiscinfo>
-</refmeta>
-
-
-<refnamediv>
-       <refname>findsmb</refname>
-       <refpurpose>list info about machines that respond to SMB 
-       name queries on a subnet</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-       <cmdsynopsis>
-               <command>findsmb</command>
-               <arg choice="opt">subnet broadcast address</arg>
-       </cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1>
-       <title>DESCRIPTION</title>
-       
-       <para>This perl script is part of the <citerefentry>
-       <refentrytitle>samba</refentrytitle><manvolnum>7</manvolnum></citerefentry>
-       suite.</para>
-
-       <para><command>findsmb</command> is a perl script that
-       prints out several pieces of information about machines 
-       on a subnet that respond to SMB  name query requests.
-       It uses <citerefentry><refentrytitle>nmblookup</refentrytitle><manvolnum>1</manvolnum></citerefentry>
-       and <citerefentry><refentrytitle>smbclient</refentrytitle><manvolnum>1</manvolnum></citerefentry>
-       to obtain this information.
-       </para>
-</refsect1>            
-
-<refsect1>
-       <title>OPTIONS</title>
-
-       <variablelist>
-               <varlistentry>
-               <term>-r</term>
-               <listitem><para>Controls whether <command>findsmb</command> takes
-               bugs in Windows95 into account when trying to find a Netbios name
-               registered of the remote machine. This option is disabled by default
-               because it is specific to Windows 95 and Windows 95 machines only. 
-               If set, <citerefentry><refentrytitle>nmblookup</refentrytitle><manvolnum>1</manvolnum></citerefentry>
-               will be called with <constant>-B</constant> option.</para></listitem>
-               </varlistentry>
-               <varlistentry>
-               <term>subnet broadcast address</term>
-               <listitem><para>Without this option, <command>findsmb
-               </command> will probe the subnet of the machine where 
-               <citerefentry><refentrytitle>findsmb</refentrytitle><manvolnum>1</manvolnum></citerefentry>
-               is run. This value is passed to 
-               <citerefentry><refentrytitle>nmblookup</refentrytitle><manvolnum>1</manvolnum></citerefentry>
-               as part of the <constant>-B</constant> option.</para></listitem>
-               </varlistentry>
-       </variablelist>
-</refsect1>
-
-<refsect1>
-       <title>EXAMPLES</title>
-
-       <para>The output of <command>findsmb</command> lists the following 
-       information for all machines that respond to the initial 
-       <command>nmblookup</command> for any name: IP address, NetBIOS name, 
-       Workgroup name, operating system, and SMB server version.</para>
-
-       <para>There will be a '+' in front of the workgroup name for 
-       machines that are local master browsers for that workgroup. There 
-       will be an '*' in front of the workgroup name for 
-       machines that are the domain master browser for that workgroup. 
-       Machines that are running Windows for Workgroups, Windows 95 or 
-       Windows 98 will 
-       not show any information about the operating system or server 
-       version.</para>
-
-       <para>The command with <constant>-r</constant> option
-       must be run on a system without <citerefentry>
-       <refentrytitle>nmbd</refentrytitle><manvolnum>8</manvolnum>
-       </citerefentry> running. 
-
-       If <command>nmbd</command> is running on the system, you will 
-       only  get the IP address and the DNS name of the machine. To 
-       get proper responses  from Windows 95 and Windows 98 machines, 
-       the command must be run as root and with <constant>-r</constant>
-       option on a machine without <command>nmbd</command> running.</para>
-
-       <para>For example, running <command>findsmb</command> 
-       without <constant>-r</constant> option set would yield output similar
-       to the following</para>
-
-<programlisting>
-IP ADDR         NETBIOS NAME   WORKGROUP/OS/VERSION 
---------------------------------------------------------------------- 
-192.168.35.10   MINESET-TEST1  [DMVENGR]
-192.168.35.55   LINUXBOX      *[MYGROUP] [Unix] [Samba 2.0.6]
-192.168.35.56   HERBNT2        [HERB-NT]
-192.168.35.63   GANDALF        [MVENGR] [Unix] [Samba 2.0.5a for IRIX]
-192.168.35.65   SAUNA          [WORKGROUP] [Unix] [Samba 1.9.18p10]
-192.168.35.71   FROGSTAR       [ENGR] [Unix] [Samba 2.0.0 for IRIX]
-192.168.35.78   HERBDHCP1     +[HERB]
-192.168.35.88   SCNT2         +[MVENGR] [Windows NT 4.0] [NT LAN Manager 4.0]
-192.168.35.93   FROGSTAR-PC    [MVENGR] [Windows 5.0] [Windows 2000 LAN Manager]
-192.168.35.97   HERBNT1       *[HERB-NT] [Windows NT 4.0] [NT LAN Manager 4.0]
-</programlisting>
-
-</refsect1>
-
-
-<refsect1>
-       <title>VERSION</title>
-
-       <para>This man page is correct for version 3 of 
-       the Samba suite.</para>
-</refsect1>
-
-<refsect1>
-       <title>SEE ALSO</title>
-       <para><citerefentry>
-       <refentrytitle>nmbd</refentrytitle><manvolnum>8</manvolnum>
-       </citerefentry>,
-       <citerefentry><refentrytitle>smbclient</refentrytitle><manvolnum>1</manvolnum>
-       </citerefentry>, and <citerefentry><refentrytitle>nmblookup</refentrytitle>
-       <manvolnum>1</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>
-       
-       <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 
-       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>
-
-</refentry>