man pages section 1: User Commands

Exit Print View

Updated: July 2014

findsmb (1)


findsmb - list info about machines that respond to SMB name queries on a subnet


findsmb [subnet broadcast address]


User Commands                                          FINDSMB(1)

     findsmb - list info about machines that respond to SMB name
     queries on a subnet

     findsmb [subnet broadcast address]

     This perl script is part of the samba(7) suite.

     findsmb 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 nmblookup(1) and smbclient(1)
     to obtain this information.

         Controls whether findsmb 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, nmblookup(1) will be called with
         -B option.

     subnet broadcast address
         Without this option, findsmb will probe the subnet of
         the machine where findsmb(1) is run. This value is
         passed to nmblookup(1) as part of the -B option.

     The output of findsmb lists the following information for
     all machines that respond to the initial nmblookup for any
     name: IP address, NetBIOS name, Workgroup name, operating
     system, and SMB server version.

     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.

     The command with -r option must be run on a system without
     nmbd(8) running. If nmbd 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 -r option
     on a machine without nmbd running.

     For example, running findsmb without -r option set would
     yield output similar to the following

Samba 3.6            Last change: 09/18/2013                    1

User Commands                                          FINDSMB(1)

         ---------------------------------------------------------------------   MINESET-TEST1  [DMVENGR]   LINUXBOX      *[MYGROUP] [Unix] [Samba 2.0.6]   HERBNT2        [HERB-NT]   GANDALF        [MVENGR] [Unix] [Samba 2.0.5a for IRIX]   SAUNA          [WORKGROUP] [Unix] [Samba 1.9.18p10]   FROGSTAR       [ENGR] [Unix] [Samba 2.0.0 for IRIX]   HERBDHCP1     +[HERB]   SCNT2         +[MVENGR] [Windows NT 4.0] [NT LAN Manager 4.0]   FROGSTAR-PC    [MVENGR] [Windows 5.0] [Windows 2000 LAN Manager]   HERBNT1       *[HERB-NT] [Windows NT 4.0] [NT LAN Manager 4.0]

     This man page is correct for version 3 of the Samba suite.

     See attributes(5) for descriptions of the following

     |Availability   | service/network/samba |
     |Stability      | Volatile              |
     nmbd(8), smbclient(1), and nmblookup(1)

     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.

     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 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.

     This software was built from source available at  The original
     community source was downloaded from

Samba 3.6            Last change: 09/18/2013                    2

User Commands                                          FINDSMB(1)

     Further information about this software can be found on the
     open source community website at

Samba 3.6            Last change: 09/18/2013                    3