Initial import
[samba] / docs / htmldocs / manpages / findsmb.1.html
1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>findsmb</title><link rel="stylesheet" href="samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="findsmb.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>findsmb &#8212; list info about machines that respond to SMB 
2         name queries on a subnet</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">findsmb</code>  [subnet broadcast address]</p></div></div><div class="refsect1" lang="en"><a name="id2489036"></a><h2>DESCRIPTION</h2><p>This perl script is part of the <a href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>
3         suite.</p><p><span><strong class="command">findsmb</strong></span> is a perl script that
4         prints out several pieces of information about machines 
5         on a subnet that respond to SMB  name query requests.
6         It uses <a href="nmblookup.1.html"><span class="citerefentry"><span class="refentrytitle">nmblookup</span>(1)</span></a>
7         and <a href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>
8         to obtain this information.
9         </p></div><div class="refsect1" lang="en"><a name="id2489078"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-r</span></dt><dd><p>Controls whether <span><strong class="command">findsmb</strong></span> takes
10                 bugs in Windows95 into account when trying to find a Netbios name
11                 registered of the remote machine. This option is disabled by default
12                 because it is specific to Windows 95 and Windows 95 machines only. 
13                 If set, <a href="nmblookup.1.html"><span class="citerefentry"><span class="refentrytitle">nmblookup</span>(1)</span></a>
14                 will be called with <code class="constant">-B</code> option.</p></dd><dt><span class="term">subnet broadcast address</span></dt><dd><p>Without this option, <span><strong class="command">findsmb
15                 </strong></span> will probe the subnet of the machine where 
16                 <a href="findsmb.1.html"><span class="citerefentry"><span class="refentrytitle">findsmb</span>(1)</span></a>
17                 is run. This value is passed to 
18                 <a href="nmblookup.1.html"><span class="citerefentry"><span class="refentrytitle">nmblookup</span>(1)</span></a>
19                 as part of the <code class="constant">-B</code> option.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2450667"></a><h2>EXAMPLES</h2><p>The output of <span><strong class="command">findsmb</strong></span> lists the following 
20         information for all machines that respond to the initial 
21         <span><strong class="command">nmblookup</strong></span> for any name: IP address, NetBIOS name, 
22         Workgroup name, operating system, and SMB server version.</p><p>There will be a '+' in front of the workgroup name for 
23         machines that are local master browsers for that workgroup. There 
24         will be an '*' in front of the workgroup name for 
25         machines that are the domain master browser for that workgroup. 
26         Machines that are running Windows for Workgroups, Windows 95 or 
27         Windows 98 will 
28         not show any information about the operating system or server 
29         version.</p><p>The command with <code class="constant">-r</code> option
30         must be run on a system without <a href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>  running. 
31
32         If <span><strong class="command">nmbd</strong></span> is running on the system, you will 
33         only  get the IP address and the DNS name of the machine. To 
34         get proper responses  from Windows 95 and Windows 98 machines, 
35         the command must be run as root and with <code class="constant">-r</code>
36         option on a machine without <span><strong class="command">nmbd</strong></span> running.</p><p>For example, running <span><strong class="command">findsmb</strong></span> 
37         without <code class="constant">-r</code> option set would yield output similar
38         to the following</p><pre class="programlisting">
39 IP ADDR         NETBIOS NAME   WORKGROUP/OS/VERSION 
40 --------------------------------------------------------------------- 
41 192.168.35.10   MINESET-TEST1  [DMVENGR]
42 192.168.35.55   LINUXBOX      *[MYGROUP] [Unix] [Samba 2.0.6]
43 192.168.35.56   HERBNT2        [HERB-NT]
44 192.168.35.63   GANDALF        [MVENGR] [Unix] [Samba 2.0.5a for IRIX]
45 192.168.35.65   SAUNA          [WORKGROUP] [Unix] [Samba 1.9.18p10]
46 192.168.35.71   FROGSTAR       [ENGR] [Unix] [Samba 2.0.0 for IRIX]
47 192.168.35.78   HERBDHCP1     +[HERB]
48 192.168.35.88   SCNT2         +[MVENGR] [Windows NT 4.0] [NT LAN Manager 4.0]
49 192.168.35.93   FROGSTAR-PC    [MVENGR] [Windows 5.0] [Windows 2000 LAN Manager]
50 192.168.35.97   HERBNT1       *[HERB-NT] [Windows NT 4.0] [NT LAN Manager 4.0]
51 </pre></div><div class="refsect1" lang="en"><a name="id2450770"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of 
52         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2450850"></a><h2>SEE ALSO</h2><p><a href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>,
53         <a href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>, and <a href="nmblookup.1.html"><span class="citerefentry"><span class="refentrytitle">nmblookup</span>(1)</span></a>
54         </p></div><div class="refsect1" lang="en"><a name="id2450883"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities 
55         were created by Andrew Tridgell. Samba is now developed
56         by the Samba Team as an Open Source project similar 
57         to the way the Linux kernel is developed.</p><p>The original Samba man pages were written by Karl Auer. 
58         The man page sources were converted to YODL format (another 
59         excellent piece of Open Source software, available at <a href="ftp://ftp.icce.rug.nl/pub/unix/" target="_top">ftp://ftp.icce.rug.nl/pub/unix/</a>) 
60         and updated for the Samba 2.0 release by Jeremy Allison.  The conversion to DocBook for 
61         Samba 2.2 was done by Gerald Carter. The conversion to DocBook
62         XML 4.2 for Samba 3.0 was done by Alexander Bokovoy.</p></div></div></body></html>