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