| 1 | '\" t | 
|---|
| 2 | .\"     Title: findsmb | 
|---|
| 3 | .\"    Author: [see the "AUTHOR" section] | 
|---|
| 4 | .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> | 
|---|
| 5 | .\"      Date: 08/02/2011 | 
|---|
| 6 | .\"    Manual: User Commands | 
|---|
| 7 | .\"    Source: Samba 3.5 | 
|---|
| 8 | .\"  Language: English | 
|---|
| 9 | .\" | 
|---|
| 10 | .TH "FINDSMB" "1" "08/02/2011" "Samba 3\&.5" "User Commands" | 
|---|
| 11 | .\" ----------------------------------------------------------------- | 
|---|
| 12 | .\" * set default formatting | 
|---|
| 13 | .\" ----------------------------------------------------------------- | 
|---|
| 14 | .\" disable hyphenation | 
|---|
| 15 | .nh | 
|---|
| 16 | .\" disable justification (adjust text to left margin only) | 
|---|
| 17 | .ad l | 
|---|
| 18 | .\" ----------------------------------------------------------------- | 
|---|
| 19 | .\" * MAIN CONTENT STARTS HERE * | 
|---|
| 20 | .\" ----------------------------------------------------------------- | 
|---|
| 21 | .SH "NAME" | 
|---|
| 22 | findsmb \- list info about machines that respond to SMB name queries on a subnet | 
|---|
| 23 | .SH "SYNOPSIS" | 
|---|
| 24 | .HP \w'\ 'u | 
|---|
| 25 | findsmb [subnet\ broadcast\ address] | 
|---|
| 26 | .SH "DESCRIPTION" | 
|---|
| 27 | .PP | 
|---|
| 28 | This perl script is part of the | 
|---|
| 29 | \fBsamba\fR(7) | 
|---|
| 30 | suite\&. | 
|---|
| 31 | .PP | 
|---|
| 32 | findsmb | 
|---|
| 33 | 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 | 
|---|
| 34 | \fBnmblookup\fR(1) | 
|---|
| 35 | and | 
|---|
| 36 | \fBsmbclient\fR(1) | 
|---|
| 37 | to obtain this information\&. | 
|---|
| 38 | .SH "OPTIONS" | 
|---|
| 39 | .PP | 
|---|
| 40 | \-r | 
|---|
| 41 | .RS 4 | 
|---|
| 42 | Controls whether | 
|---|
| 43 | findsmb | 
|---|
| 44 | 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, | 
|---|
| 45 | \fBnmblookup\fR(1) | 
|---|
| 46 | will be called with | 
|---|
| 47 | \fB\-B\fR | 
|---|
| 48 | option\&. | 
|---|
| 49 | .RE | 
|---|
| 50 | .PP | 
|---|
| 51 | subnet broadcast address | 
|---|
| 52 | .RS 4 | 
|---|
| 53 | Without this option, | 
|---|
| 54 | findsmb | 
|---|
| 55 | will probe the subnet of the machine where | 
|---|
| 56 | \fBfindsmb\fR(1) | 
|---|
| 57 | is run\&. This value is passed to | 
|---|
| 58 | \fBnmblookup\fR(1) | 
|---|
| 59 | as part of the | 
|---|
| 60 | \fB\-B\fR | 
|---|
| 61 | option\&. | 
|---|
| 62 | .RE | 
|---|
| 63 | .SH "EXAMPLES" | 
|---|
| 64 | .PP | 
|---|
| 65 | The output of | 
|---|
| 66 | findsmb | 
|---|
| 67 | lists the following information for all machines that respond to the initial | 
|---|
| 68 | nmblookup | 
|---|
| 69 | for any name: IP address, NetBIOS name, Workgroup name, operating system, and SMB server version\&. | 
|---|
| 70 | .PP | 
|---|
| 71 | 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\&. | 
|---|
| 72 | .PP | 
|---|
| 73 | The command with | 
|---|
| 74 | \fB\-r\fR | 
|---|
| 75 | option must be run on a system without | 
|---|
| 76 | \fBnmbd\fR(8) | 
|---|
| 77 | running\&. If | 
|---|
| 78 | nmbd | 
|---|
| 79 | 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 | 
|---|
| 80 | \fB\-r\fR | 
|---|
| 81 | option on a machine without | 
|---|
| 82 | nmbd | 
|---|
| 83 | running\&. | 
|---|
| 84 | .PP | 
|---|
| 85 | For example, running | 
|---|
| 86 | findsmb | 
|---|
| 87 | without | 
|---|
| 88 | \fB\-r\fR | 
|---|
| 89 | option set would yield output similar to the following | 
|---|
| 90 | .sp | 
|---|
| 91 | .if n \{\ | 
|---|
| 92 | .RS 4 | 
|---|
| 93 | .\} | 
|---|
| 94 | .nf | 
|---|
| 95 | IP ADDR         NETBIOS NAME   WORKGROUP/OS/VERSION | 
|---|
| 96 | \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- | 
|---|
| 97 | 192\&.168\&.35\&.10   MINESET\-TEST1  [DMVENGR] | 
|---|
| 98 | 192\&.168\&.35\&.55   LINUXBOX      *[MYGROUP] [Unix] [Samba 2\&.0\&.6] | 
|---|
| 99 | 192\&.168\&.35\&.56   HERBNT2        [HERB\-NT] | 
|---|
| 100 | 192\&.168\&.35\&.63   GANDALF        [MVENGR] [Unix] [Samba 2\&.0\&.5a for IRIX] | 
|---|
| 101 | 192\&.168\&.35\&.65   SAUNA          [WORKGROUP] [Unix] [Samba 1\&.9\&.18p10] | 
|---|
| 102 | 192\&.168\&.35\&.71   FROGSTAR       [ENGR] [Unix] [Samba 2\&.0\&.0 for IRIX] | 
|---|
| 103 | 192\&.168\&.35\&.78   HERBDHCP1     +[HERB] | 
|---|
| 104 | 192\&.168\&.35\&.88   SCNT2         +[MVENGR] [Windows NT 4\&.0] [NT LAN Manager 4\&.0] | 
|---|
| 105 | 192\&.168\&.35\&.93   FROGSTAR\-PC    [MVENGR] [Windows 5\&.0] [Windows 2000 LAN Manager] | 
|---|
| 106 | 192\&.168\&.35\&.97   HERBNT1       *[HERB\-NT] [Windows NT 4\&.0] [NT LAN Manager 4\&.0] | 
|---|
| 107 | .fi | 
|---|
| 108 | .if n \{\ | 
|---|
| 109 | .RE | 
|---|
| 110 | .\} | 
|---|
| 111 | .SH "VERSION" | 
|---|
| 112 | .PP | 
|---|
| 113 | This man page is correct for version 3 of the Samba suite\&. | 
|---|
| 114 | .SH "SEE ALSO" | 
|---|
| 115 | .PP | 
|---|
| 116 | \fBnmbd\fR(8), | 
|---|
| 117 | \fBsmbclient\fR(1), and | 
|---|
| 118 | \fBnmblookup\fR(1) | 
|---|
| 119 | .SH "AUTHOR" | 
|---|
| 120 | .PP | 
|---|
| 121 | 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\&. | 
|---|
| 122 | .PP | 
|---|
| 123 | 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 | 
|---|
| 124 | ftp://ftp\&.icce\&.rug\&.nl/pub/unix/) 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\&. | 
|---|