syncing up changes in 2.2
[samba.git] / docs / htmldocs / findsmb.1.html
1 <HTML
2 ><HEAD
3 ><TITLE
4 >findsmb</TITLE
5 ><META
6 NAME="GENERATOR"
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.57"></HEAD
8 ><BODY
9 CLASS="REFENTRY"
10 BGCOLOR="#FFFFFF"
11 TEXT="#000000"
12 LINK="#0000FF"
13 VLINK="#840084"
14 ALINK="#0000FF"
15 ><H1
16 ><A
17 NAME="FINDSMB"
18 >findsmb</A
19 ></H1
20 ><DIV
21 CLASS="REFNAMEDIV"
22 ><A
23 NAME="AEN5"
24 ></A
25 ><H2
26 >Name</H2
27 >findsmb&nbsp;--&nbsp;list info about machines that respond to SMB 
28         name queries on a subnet</DIV
29 ><DIV
30 CLASS="REFSYNOPSISDIV"
31 ><A
32 NAME="AEN8"
33 ></A
34 ><H2
35 >Synopsis</H2
36 ><P
37 ><B
38 CLASS="COMMAND"
39 >findsmb</B
40 >  [subnet broadcast address]</P
41 ></DIV
42 ><DIV
43 CLASS="REFSECT1"
44 ><A
45 NAME="AEN12"
46 ></A
47 ><H2
48 >DESCRIPTION</H2
49 ><P
50 >This perl script is part of the <A
51 HREF="samba.7.html"
52 TARGET="_top"
53 >       Samba</A
54 > suite.</P
55 ><P
56 ><B
57 CLASS="COMMAND"
58 >findsmb</B
59 > is a perl script that
60         prints out several pieces of information about machines 
61         on a subnet that respond to SMB  name query requests.
62         It uses <A
63 HREF="nmblookup.1.html"
64 TARGET="_top"
65 ><B
66 CLASS="COMMAND"
67 >       nmblookup(1)</B
68 ></A
69 > and <A
70 HREF="smbclient.1.html"
71 TARGET="_top"
72 >       <B
73 CLASS="COMMAND"
74 >smbclient(1)</B
75 ></A
76 > to obtain this information.
77         </P
78 ></DIV
79 ><DIV
80 CLASS="REFSECT1"
81 ><A
82 NAME="AEN22"
83 ></A
84 ><H2
85 >OPTIONS</H2
86 ><P
87 ></P
88 ><DIV
89 CLASS="VARIABLELIST"
90 ><DL
91 ><DT
92 >subnet broadcast address</DT
93 ><DD
94 ><P
95 >Without this option, <B
96 CLASS="COMMAND"
97 >findsmb
98                 </B
99 > will probe the subnet of the machine where 
100                 <B
101 CLASS="COMMAND"
102 >findsmb</B
103 > is run. This value is passed 
104                 to <B
105 CLASS="COMMAND"
106 >nmblookup</B
107 > as part of the 
108                 <TT
109 CLASS="CONSTANT"
110 >-B</TT
111 > option</P
112 ></DD
113 ></DL
114 ></DIV
115 ></DIV
116 ><DIV
117 CLASS="REFSECT1"
118 ><A
119 NAME="AEN33"
120 ></A
121 ><H2
122 >EXAMPLES</H2
123 ><P
124 >The output of <B
125 CLASS="COMMAND"
126 >findsmb</B
127 > lists the following 
128         information for all machines that respond to the initial 
129         <B
130 CLASS="COMMAND"
131 >nmblookup</B
132 > for any name: IP address, NetBIOS name, 
133         Workgroup name, operating system, and SMB server version.</P
134 ><P
135 >There will be a '+' in front of the workgroup name for 
136         machines that are local master browsers for that workgroup. There 
137         will be an '*' in front of the workgroup name for 
138         machines that are the domain master browser for that workgroup. 
139         Machines that are running Windows, Windows 95 or Windows 98 will 
140         not show any information about the operating system or server 
141         version.</P
142 ><P
143 >The command must be run on a system without <A
144 HREF="nmbd.8.html"
145 TARGET="_top"
146 ><B
147 CLASS="COMMAND"
148 >nmbd</B
149 ></A
150 > running. 
151         If <B
152 CLASS="COMMAND"
153 >nmbd</B
154 > is running on the system, you will 
155         only  get the IP address and the DNS name of the machine. To 
156         get proper responses  from Windows 95 and Windows 98 machines, 
157         the command must be run as root. </P
158 ><P
159 >For example running <B
160 CLASS="COMMAND"
161 >findsmb</B
162 > on a machine 
163         without <B
164 CLASS="COMMAND"
165 >nmbd</B
166 > running would yield output similar
167         to the following</P
168 ><TABLE
169 BORDER="0"
170 BGCOLOR="#E0E0E0"
171 WIDTH="100%"
172 ><TR
173 ><TD
174 ><PRE
175 CLASS="SCREEN"
176 ><TT
177 CLASS="COMPUTEROUTPUT"
178 >IP ADDR         NETBIOS NAME   WORKGROUP/OS/VERSION 
179 --------------------------------------------------------------------- 
180 192.168.35.10   MINESET-TEST1  [DMVENGR]
181 192.168.35.55   LINUXBOX      *[MYGROUP] [Unix] [Samba 2.0.6]
182 192.168.35.56   HERBNT2        [HERB-NT]
183 192.168.35.63   GANDALF        [MVENGR] [Unix] [Samba 2.0.5a for IRIX]
184 192.168.35.65   SAUNA          [WORKGROUP] [Unix] [Samba 1.9.18p10]
185 192.168.35.71   FROGSTAR       [ENGR] [Unix] [Samba 2.0.0 for IRIX]
186 192.168.35.78   HERBDHCP1     +[HERB]
187 192.168.35.88   SCNT2         +[MVENGR] [Windows NT 4.0] [NT LAN Manager 4.0]
188 192.168.35.93   FROGSTAR-PC    [MVENGR] [Windows 5.0] [Windows 2000 LAN Manager]
189 192.168.35.97   HERBNT1       *[HERB-NT] [Windows NT 4.0] [NT LAN Manager 4.0]
190         </TT
191 ></PRE
192 ></TD
193 ></TR
194 ></TABLE
195 ></DIV
196 ><DIV
197 CLASS="REFSECT1"
198 ><A
199 NAME="AEN48"
200 ></A
201 ><H2
202 >VERSION</H2
203 ><P
204 >This man page is correct for version 2.2 of 
205         the Samba suite.</P
206 ></DIV
207 ><DIV
208 CLASS="REFSECT1"
209 ><A
210 NAME="AEN51"
211 ></A
212 ><H2
213 >SEE ALSO</H2
214 ><P
215 ><A
216 HREF="nmbd.8.html"
217 TARGET="_top"
218 ><B
219 CLASS="COMMAND"
220 >nmbd(8)</B
221 ></A
222 >, 
223         <A
224 HREF="smbclient.1.html"
225 TARGET="_top"
226 ><B
227 CLASS="COMMAND"
228 >smbclient(1)
229         </B
230 ></A
231 >, and  <A
232 HREF="nmblookup.1.html"
233 TARGET="_top"
234 >       <B
235 CLASS="COMMAND"
236 >nmblookup(1)</B
237 ></A
238 >
239         </P
240 ></DIV
241 ><DIV
242 CLASS="REFSECT1"
243 ><A
244 NAME="AEN60"
245 ></A
246 ><H2
247 >AUTHOR</H2
248 ><P
249 >The original Samba software and related utilities 
250         were created by Andrew Tridgell. Samba is now developed
251         by the Samba Team as an Open Source project similar 
252         to the way the Linux kernel is developed.</P
253 ><P
254 >The original Samba man pages were written by Karl Auer. 
255         The man page sources were converted to YODL format (another 
256         excellent piece of Open Source software, available at
257         <A
258 HREF="ftp://ftp.icce.rug.nl/pub/unix/"
259 TARGET="_top"
260 >       ftp://ftp.icce.rug.nl/pub/unix/</A
261 >) and updated for the Samba 2.0 
262         release by Jeremy Allison.  The conversion to DocBook for 
263         Samba 2.2 was done by Gerald Carter</P
264 ></DIV
265 ></BODY
266 ></HTML
267 >