bd737b29472299c2a5d2e03a29c13ab7a7a77573
[samba.git] / docs / manpages / findsmb.1
1 .\" This manpage has been automatically generated by docbook2man-spec
2 .\" from a DocBook document.  docbook2man-spec can be found at:
3 .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> 
4 .\" Please send any bug reports, improvements, comments, patches, 
5 .\" etc. to Steve Cheng <steve@ggi-project.org>.
6 .TH "FINDSMB" "1" "22 February 2001" "" ""
7 .SH NAME
8 findsmb \- list info about machines that respond to SMB  name queries on a subnet
9 .SH SYNOPSIS
10 .sp
11 \fBfindsmb\fR [ \fBsubnet broadcast address\fR ] 
12 .SH "DESCRIPTION"
13 .PP
14 This perl script is part of the  Samba <URL:samba.7.html> suite.
15 .PP
16 \fBfindsmb\fR is a perl script that
17 prints out several pieces of information about machines 
18 on a subnet that respond to SMB name query requests.
19 It uses \fB nmblookup(1)\fR <URL:nmblookup.1.html> and  \fBsmbclient(1)\fR <URL:smbclient.1.html> to obtain this information.
20 .SH "OPTIONS"
21 .TP
22 \fBsubnet broadcast address\fR
23 Without this option, \fBfindsmb
24 \fRwill probe the subnet of the machine where 
25 \fBfindsmb\fR is run. This value is passed 
26 to \fBnmblookup\fR as part of the 
27 -B option
28 .SH "EXAMPLES"
29 .PP
30 The output of \fBfindsmb\fR lists the following 
31 information for all machines that respond to the initial 
32 \fBnmblookup\fR for any name: IP address, NetBIOS name, 
33 Workgroup name, operating system, and SMB server version.
34 .PP
35 There will be a '+' in front of the workgroup name for 
36 machines that are local master browsers for that workgroup. There 
37 will be an '*' in front of the workgroup name for 
38 machines that are the domain master browser for that workgroup. 
39 Machines that are running Windows, Windows 95 or Windows 98 will 
40 not show any information about the operating system or server 
41 version.
42 .PP
43 The command must be run on a system without \fBnmbd\fR <URL:nmbd.8.html> running. 
44 If \fBnmbd\fR is running on the system, you will 
45 only get the IP address and the DNS name of the machine. To 
46 get proper responses from Windows 95 and Windows 98 machines, 
47 the command must be run as root. 
48 .PP
49 For example running \fBfindsmb\fR on a machine 
50 without \fBnmbd\fR running would yield output similar
51 to the following
52 .sp
53 .nf
54 IP ADDR         NETBIOS NAME   WORKGROUP/OS/VERSION 
55 --------------------------------------------------------------------- 
56 192.168.35.10   MINESET-TEST1  [DMVENGR]
57 192.168.35.55   LINUXBOX      *[MYGROUP] [Unix] [Samba 2.0.6]
58 192.168.35.56   HERBNT2        [HERB-NT]
59 192.168.35.63   GANDALF        [MVENGR] [Unix] [Samba 2.0.5a for IRIX]
60 192.168.35.65   SAUNA          [WORKGROUP] [Unix] [Samba 1.9.18p10]
61 192.168.35.71   FROGSTAR       [ENGR] [Unix] [Samba 2.0.0 for IRIX]
62 192.168.35.78   HERBDHCP1     +[HERB]
63 192.168.35.88   SCNT2         +[MVENGR] [Windows NT 4.0] [NT LAN Manager 4.0]
64 192.168.35.93   FROGSTAR-PC    [MVENGR] [Windows 5.0] [Windows 2000 LAN Manager]
65 192.168.35.97   HERBNT1       *[HERB-NT] [Windows NT 4.0] [NT LAN Manager 4.0]
66         
67 .sp
68 .fi
69 .SH "VERSION"
70 .PP
71 This man page is correct for version 2.2 of 
72 the Samba suite.
73 .SH "SEE ALSO"
74 .PP
75 \fBnmbd(8)\fR <URL:nmbd.8.html>, 
76 \fBsmbclient(1)
77 \fR <URL:smbclient.1.html>, and  \fBnmblookup(1)\fR <URL:smbclient.1.html>
78 .SH "AUTHOR"
79 .PP
80 The original Samba software and related utilities 
81 were created by Andrew Tridgell. Samba is now developed
82 by the Samba Team as an Open Source project similar 
83 to the way the Linux kernel is developed.
84 .PP
85 The original Samba man pages were written by Karl Auer. 
86 The man page sources were converted to YODL format (another 
87 excellent piece of Open Source software, available at
88 ftp://ftp.icce.rug.nl/pub/unix/ <URL:ftp://ftp.icce.rug.nl/pub/unix/>) and updated for the Samba 2.0 
89 release by Jeremy Allison. The conversion to DocBook for 
90 Samba 2.2 was done by Gerald Carter