summaryrefslogtreecommitdiff
path: root/docs-xml/manpages/findsmb.1.xml
blob: 63233e218e5ab99cef9b5eadc5088e78c0923e32 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
<refentry id="findsmb.1">

<refmeta>
	<refentrytitle>findsmb</refentrytitle>
	<manvolnum>1</manvolnum>
	<refmiscinfo class="source">Samba</refmiscinfo>
	<refmiscinfo class="manual">User Commands</refmiscinfo>
	<refmiscinfo class="version">&doc.version;</refmiscinfo>
</refmeta>


<refnamediv>
	<refname>findsmb</refname>
	<refpurpose>list info about machines that respond to SMB 
	name queries on a subnet</refpurpose>
</refnamediv>

<refsynopsisdiv>
	<cmdsynopsis>
		<command>findsmb</command>
		<arg choice="opt">subnet broadcast address</arg>
	</cmdsynopsis>
</refsynopsisdiv>

<refsect1>
	<title>DESCRIPTION</title>
	
	<para>This perl script is part of the <citerefentry>
	<refentrytitle>samba</refentrytitle><manvolnum>7</manvolnum></citerefentry>
	suite.</para>

	<para><command>findsmb</command> 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 <citerefentry><refentrytitle>nmblookup</refentrytitle><manvolnum>1</manvolnum></citerefentry>
	and <citerefentry><refentrytitle>smbclient</refentrytitle><manvolnum>1</manvolnum></citerefentry>
	to obtain this information.
	</para>
</refsect1>		

<refsect1>
	<title>OPTIONS</title>

	<variablelist>
		<varlistentry>
		<term>-r</term>
		<listitem><para>Controls whether <command>findsmb</command> 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, <citerefentry><refentrytitle>nmblookup</refentrytitle><manvolnum>1</manvolnum></citerefentry>
		will be called with <constant>-B</constant> option.</para></listitem>
		</varlistentry>
		<varlistentry>
		<term>subnet broadcast address</term>
		<listitem><para>Without this option, <command>findsmb
		</command> will probe the subnet of the machine where 
		<citerefentry><refentrytitle>findsmb</refentrytitle><manvolnum>1</manvolnum></citerefentry>
		is run. This value is passed to 
		<citerefentry><refentrytitle>nmblookup</refentrytitle><manvolnum>1</manvolnum></citerefentry>
		as part of the <constant>-B</constant> option.</para></listitem>
		</varlistentry>
	</variablelist>
</refsect1>

<refsect1>
	<title>EXAMPLES</title>

	<para>The output of <command>findsmb</command> lists the following 
	information for all machines that respond to the initial 
	<command>nmblookup</command> for any name: IP address, NetBIOS name, 
	Workgroup name, operating system, and SMB server version.</para>

	<para>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.</para>

	<para>The command with <constant>-r</constant> option
	must be run on a system without <citerefentry>
	<refentrytitle>nmbd</refentrytitle><manvolnum>8</manvolnum>
	</citerefentry>	running. 

	If <command>nmbd</command> 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 <constant>-r</constant>
	option on a machine without <command>nmbd</command> running.</para>

	<para>For example, running <command>findsmb</command> 
	without <constant>-r</constant> option set would yield output similar
	to the following</para>

<programlisting>
IP ADDR         NETBIOS NAME   WORKGROUP/OS/VERSION 
--------------------------------------------------------------------- 
192.168.35.10   MINESET-TEST1  [DMVENGR]
192.168.35.55   LINUXBOX      *[MYGROUP] [Unix] [Samba 2.0.6]
192.168.35.56   HERBNT2        [HERB-NT]
192.168.35.63   GANDALF        [MVENGR] [Unix] [Samba 2.0.5a for IRIX]
192.168.35.65   SAUNA          [WORKGROUP] [Unix] [Samba 1.9.18p10]
192.168.35.71   FROGSTAR       [ENGR] [Unix] [Samba 2.0.0 for IRIX]
192.168.35.78   HERBDHCP1     +[HERB]
192.168.35.88   SCNT2         +[MVENGR] [Windows NT 4.0] [NT LAN Manager 4.0]
192.168.35.93   FROGSTAR-PC    [MVENGR] [Windows 5.0] [Windows 2000 LAN Manager]
192.168.35.97   HERBNT1       *[HERB-NT] [Windows NT 4.0] [NT LAN Manager 4.0]
</programlisting>

</refsect1>


<refsect1>
	<title>VERSION</title>

	<para>This man page is part of version &doc.version; of
	the Samba suite.</para>
</refsect1>

<refsect1>
	<title>SEE ALSO</title>
	<para><citerefentry>
	<refentrytitle>nmbd</refentrytitle><manvolnum>8</manvolnum>
	</citerefentry>,
	<citerefentry><refentrytitle>smbclient</refentrytitle><manvolnum>1</manvolnum>
	</citerefentry>, and <citerefentry><refentrytitle>nmblookup</refentrytitle>
	<manvolnum>1</manvolnum></citerefentry>
	</para>
</refsect1>

<refsect1>
	<title>AUTHOR</title>
	
	<para>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.</para>
</refsect1>

</refentry>