1 <?xml version="1.0" encoding="iso-8859-1"?>
2 <!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
3 <refentry id="findsmb.1">
6 <refentrytitle>findsmb</refentrytitle>
7 <manvolnum>1</manvolnum>
8 <refmiscinfo class="source">Samba</refmiscinfo>
9 <refmiscinfo class="manual">User Commands</refmiscinfo>
10 <refmiscinfo class="version">3.4</refmiscinfo>
15 <refname>findsmb</refname>
16 <refpurpose>list info about machines that respond to SMB
17 name queries on a subnet</refpurpose>
22 <command>findsmb</command>
23 <arg choice="opt">subnet broadcast address</arg>
28 <title>DESCRIPTION</title>
30 <para>This perl script is part of the <citerefentry>
31 <refentrytitle>samba</refentrytitle><manvolnum>7</manvolnum></citerefentry>
34 <para><command>findsmb</command> is a perl script that
35 prints out several pieces of information about machines
36 on a subnet that respond to SMB name query requests.
37 It uses <citerefentry><refentrytitle>nmblookup</refentrytitle><manvolnum>1</manvolnum></citerefentry>
38 and <citerefentry><refentrytitle>smbclient</refentrytitle><manvolnum>1</manvolnum></citerefentry>
39 to obtain this information.
44 <title>OPTIONS</title>
49 <listitem><para>Controls whether <command>findsmb</command> takes
50 bugs in Windows95 into account when trying to find a Netbios name
51 registered of the remote machine. This option is disabled by default
52 because it is specific to Windows 95 and Windows 95 machines only.
53 If set, <citerefentry><refentrytitle>nmblookup</refentrytitle><manvolnum>1</manvolnum></citerefentry>
54 will be called with <constant>-B</constant> option.</para></listitem>
57 <term>subnet broadcast address</term>
58 <listitem><para>Without this option, <command>findsmb
59 </command> will probe the subnet of the machine where
60 <citerefentry><refentrytitle>findsmb</refentrytitle><manvolnum>1</manvolnum></citerefentry>
61 is run. This value is passed to
62 <citerefentry><refentrytitle>nmblookup</refentrytitle><manvolnum>1</manvolnum></citerefentry>
63 as part of the <constant>-B</constant> option.</para></listitem>
69 <title>EXAMPLES</title>
71 <para>The output of <command>findsmb</command> lists the following
72 information for all machines that respond to the initial
73 <command>nmblookup</command> for any name: IP address, NetBIOS name,
74 Workgroup name, operating system, and SMB server version.</para>
76 <para>There will be a '+' in front of the workgroup name for
77 machines that are local master browsers for that workgroup. There
78 will be an '*' in front of the workgroup name for
79 machines that are the domain master browser for that workgroup.
80 Machines that are running Windows for Workgroups, Windows 95 or
82 not show any information about the operating system or server
85 <para>The command with <constant>-r</constant> option
86 must be run on a system without <citerefentry>
87 <refentrytitle>nmbd</refentrytitle><manvolnum>8</manvolnum>
88 </citerefentry> running.
90 If <command>nmbd</command> is running on the system, you will
91 only get the IP address and the DNS name of the machine. To
92 get proper responses from Windows 95 and Windows 98 machines,
93 the command must be run as root and with <constant>-r</constant>
94 option on a machine without <command>nmbd</command> running.</para>
96 <para>For example, running <command>findsmb</command>
97 without <constant>-r</constant> option set would yield output similar
98 to the following</para>
101 IP ADDR NETBIOS NAME WORKGROUP/OS/VERSION
102 ---------------------------------------------------------------------
103 192.168.35.10 MINESET-TEST1 [DMVENGR]
104 192.168.35.55 LINUXBOX *[MYGROUP] [Unix] [Samba 2.0.6]
105 192.168.35.56 HERBNT2 [HERB-NT]
106 192.168.35.63 GANDALF [MVENGR] [Unix] [Samba 2.0.5a for IRIX]
107 192.168.35.65 SAUNA [WORKGROUP] [Unix] [Samba 1.9.18p10]
108 192.168.35.71 FROGSTAR [ENGR] [Unix] [Samba 2.0.0 for IRIX]
109 192.168.35.78 HERBDHCP1 +[HERB]
110 192.168.35.88 SCNT2 +[MVENGR] [Windows NT 4.0] [NT LAN Manager 4.0]
111 192.168.35.93 FROGSTAR-PC [MVENGR] [Windows 5.0] [Windows 2000 LAN Manager]
112 192.168.35.97 HERBNT1 *[HERB-NT] [Windows NT 4.0] [NT LAN Manager 4.0]
119 <title>VERSION</title>
121 <para>This man page is correct for version 3 of
122 the Samba suite.</para>
126 <title>SEE ALSO</title>
128 <refentrytitle>nmbd</refentrytitle><manvolnum>8</manvolnum>
130 <citerefentry><refentrytitle>smbclient</refentrytitle><manvolnum>1</manvolnum>
131 </citerefentry>, and <citerefentry><refentrytitle>nmblookup</refentrytitle>
132 <manvolnum>1</manvolnum></citerefentry>
137 <title>AUTHOR</title>
139 <para>The original Samba software and related utilities
140 were created by Andrew Tridgell. Samba is now developed
141 by the Samba Team as an Open Source project similar
142 to the way the Linux kernel is developed.</para>
144 <para>The original Samba man pages were written by Karl Auer.
145 The man page sources were converted to YODL format (another
146 excellent piece of Open Source software, available at <ulink
147 url="ftp://ftp.icce.rug.nl/pub/unix/">ftp://ftp.icce.rug.nl/pub/unix/</ulink>)
148 and updated for the Samba 2.0 release by Jeremy Allison. The conversion to DocBook for
149 Samba 2.2 was done by Gerald Carter. The conversion to DocBook
150 XML 4.2 for Samba 3.0 was done by Alexander Bokovoy.</para>