preparing for release of 2.2.0-alpha2
[Samba/ekacnet.git] / docs / manpages / findsmb.1
blob9ab179f2fbda1e08b9150bb2b6fa8e58593bdc61
1 .TH FINDSMB 1 "30 Jan 2001" "findsmb 2.2.0-alpha2"
2 .PP 
3 .SH "NAME" 
4 findsmb \- list info about machines that respond to SMB name queries on a subnet
5 .PP 
6 .SH "SYNOPSIS" 
7 .PP 
8 \fBfindsmb\fP [subnet broadcast address]
9 .PP 
10 .SH "DESCRIPTION" 
11 .PP 
12 This perl script is part of the \fBSamba\fP suite\&.
13 .PP 
14 \fBfindsmb\fP is a perl script that prints out several pieces
15 of information about machines on a subnet that respond to SMB 
16 name query requests\&.
17 It uses \fBnmblookup\fP and 
18 \fBsmbclient\fP to obtain this information\&.
19 .PP 
20 .SH "OPTIONS" 
21 .PP 
22 .IP 
23 .IP "\fBsubnet broadcast address\fP" 
24 Without this option, \fBfindsmb\fP
25 will probe the subnet of the machine where \fBfindsmb\fP is run\&.
26 This value is passed to \fBnmblookup\fP as part of the \fB-B\fP
27 option
28 .IP 
29 .PP 
30 .SH "EXAMPLES" 
31 .PP 
32 The output of \fBfindsmb\fP lists the following information for all
33 machines that respond to the initial \fBnmblookup\fP for any name:
34 IP address, NetBIOS name, Workgroup name, operating system, and
35 SMB server version\&.
36 .PP 
37 There will be a "+" in front of the workgroup name for machines that are
38 local master browsers for that workgroup\&. There will be an "*" in front
39 of the workgroup name for machines that are the domain master browser for
40 that workgroup\&. Machines that are running Windows, Windows 95 or Windows 98
41 will not show any information about the operating system or server version\&.
42 .PP 
43 The command must be run on a system without 
44 \fBnmbd\fP running\&. If \fBnmbd\fP is running on the system, you will only 
45 get the IP address and the DNS name of the machine\&. To get proper responses 
46 from Windows 95 and Windows 98 machines, the command must be run as root\&. 
47 .PP 
48 For example running:
49 .PP 
50 \f(CWfindsmb\fP
51 .PP 
52 on a machine without \fBnmbd\fP running would yield output similar
53 to the following
54 .PP 
56 .DS 
59 IP ADDR         NETBIOS NAME   WORKGROUP/OS/VERSION 
60 --------------------------------------------------------------------- 
61 192\&.168\&.35\&.10   MINESET-TEST1  [DMVENGR]
62 192\&.168\&.35\&.55   LINUXBOX      *[MYGROUP] [Unix] [Samba 2\&.0\&.6]
63 192\&.168\&.35\&.56   HERBNT2        [HERB-NT]
64 192\&.168\&.35\&.63   GANDALF        [MVENGR] [Unix] [Samba 2\&.0\&.5a for IRIX]
65 192\&.168\&.35\&.65   SAUNA          [WORKGROUP] [Unix] [Samba 1\&.9\&.18p10]
66 192\&.168\&.35\&.71   FROGSTAR       [ENGR] [Unix] [Samba 2\&.0\&.0 for IRIX]
67 192\&.168\&.35\&.78   HERBDHCP1     +[HERB]
68 192\&.168\&.35\&.88   SCNT2         +[MVENGR] [Windows NT 4\&.0] [NT LAN Manager 4\&.0]
69 192\&.168\&.35\&.93   FROGSTAR-PC    [MVENGR] [Windows 5\&.0] [Windows 2000 LAN Manager]
70 192\&.168\&.35\&.97   HERBNT1       *[HERB-NT] [Windows NT 4\&.0] [NT LAN Manager 4\&.0]
72 .DE 
75 .PP 
76 .SH "VERSION" 
77 .PP 
78 This man page is correct for version 2\&.0 of the Samba suite\&.
79 .PP 
80 .SH "SEE ALSO" 
81 .PP 
82 \fBnmblookup (1)\fP, \fBsmbclient (1)\fP
83 .PP 
84 .SH "AUTHOR" 
85 .PP 
86 This perl script was developed by Herb Lewis of SGI\&.
87 .PP 
88 The original Samba software and related utilities were created by
89 Andrew Tridgell \fIsamba@samba\&.org\fP\&. Samba is now developed
90 by the Samba Team as an Open Source project similar to the way the
91 Linux kernel is developed\&.
92 .PP 
93 See \fBsamba (7)\fP to find out how to get a full
94 list of contributors and details on how to submit bug reports,
95 comments etc\&.