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"> 4 5<refmeta> 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.5</refmiscinfo> 11</refmeta> 12 13 14<refnamediv> 15 <refname>findsmb</refname> 16 <refpurpose>list info about machines that respond to SMB 17 name queries on a subnet</refpurpose> 18</refnamediv> 19 20<refsynopsisdiv> 21 <cmdsynopsis> 22 <command>findsmb</command> 23 <arg choice="opt">subnet broadcast address</arg> 24 </cmdsynopsis> 25</refsynopsisdiv> 26 27<refsect1> 28 <title>DESCRIPTION</title> 29 30 <para>This perl script is part of the <citerefentry> 31 <refentrytitle>samba</refentrytitle><manvolnum>7</manvolnum></citerefentry> 32 suite.</para> 33 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. 40 </para> 41</refsect1> 42 43<refsect1> 44 <title>OPTIONS</title> 45 46 <variablelist> 47 <varlistentry> 48 <term>-r</term> 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> 55 </varlistentry> 56 <varlistentry> 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> 64 </varlistentry> 65 </variablelist> 66</refsect1> 67 68<refsect1> 69 <title>EXAMPLES</title> 70 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> 75 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 81 Windows 98 will 82 not show any information about the operating system or server 83 version.</para> 84 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. 89 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> 95 96 <para>For example, running <command>findsmb</command> 97 without <constant>-r</constant> option set would yield output similar 98 to the following</para> 99 100<programlisting> 101IP ADDR NETBIOS NAME WORKGROUP/OS/VERSION 102--------------------------------------------------------------------- 103192.168.35.10 MINESET-TEST1 [DMVENGR] 104192.168.35.55 LINUXBOX *[MYGROUP] [Unix] [Samba 2.0.6] 105192.168.35.56 HERBNT2 [HERB-NT] 106192.168.35.63 GANDALF [MVENGR] [Unix] [Samba 2.0.5a for IRIX] 107192.168.35.65 SAUNA [WORKGROUP] [Unix] [Samba 1.9.18p10] 108192.168.35.71 FROGSTAR [ENGR] [Unix] [Samba 2.0.0 for IRIX] 109192.168.35.78 HERBDHCP1 +[HERB] 110192.168.35.88 SCNT2 +[MVENGR] [Windows NT 4.0] [NT LAN Manager 4.0] 111192.168.35.93 FROGSTAR-PC [MVENGR] [Windows 5.0] [Windows 2000 LAN Manager] 112192.168.35.97 HERBNT1 *[HERB-NT] [Windows NT 4.0] [NT LAN Manager 4.0] 113</programlisting> 114 115</refsect1> 116 117 118<refsect1> 119 <title>VERSION</title> 120 121 <para>This man page is correct for version 3 of 122 the Samba suite.</para> 123</refsect1> 124 125<refsect1> 126 <title>SEE ALSO</title> 127 <para><citerefentry> 128 <refentrytitle>nmbd</refentrytitle><manvolnum>8</manvolnum> 129 </citerefentry>, 130 <citerefentry><refentrytitle>smbclient</refentrytitle><manvolnum>1</manvolnum> 131 </citerefentry>, and <citerefentry><refentrytitle>nmblookup</refentrytitle> 132 <manvolnum>1</manvolnum></citerefentry> 133 </para> 134</refsect1> 135 136<refsect1> 137 <title>AUTHOR</title> 138 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> 143 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> 151</refsect1> 152 153</refentry> 154