summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGerald Carter <jerry@samba.org>2001-02-22 15:43:18 +0000
committerGerald Carter <jerry@samba.org>2001-02-22 15:43:18 +0000
commit7fa7be07a1ba236c839136fbfddc9d9faddf560d (patch)
tree8b248374682c3c21e563d9b0fdda4e21fe68c1e7
parentd091506f68aef214994d34bcc3d39a85f7e5e8b4 (diff)
downloadsamba-7fa7be07a1ba236c839136fbfddc9d9faddf560d.tar.gz
samba-7fa7be07a1ba236c839136fbfddc9d9faddf560d.tar.bz2
samba-7fa7be07a1ba236c839136fbfddc9d9faddf560d.zip
housekeeping and a new SGML source file (findsmb)
(This used to be commit d509bb881da1fdad108a843fa35e2ed7248617e9)
-rw-r--r--docs/docbook/manpages/findsmb.1.sgml131
-rw-r--r--docs/docbook/manpages/nmbd.8.sgml (renamed from docs/docbook/nmbd.8.sgml)0
-rw-r--r--docs/docbook/manpages/samba.7.sgml (renamed from docs/docbook/samba.7.sgml)0
-rw-r--r--docs/docbook/manpages/smb.conf.5.sgml (renamed from docs/docbook/smb.conf.5.sgml)0
-rw-r--r--docs/docbook/manpages/smbd.8.sgml (renamed from docs/docbook/smbd.8.sgml)0
5 files changed, 131 insertions, 0 deletions
diff --git a/docs/docbook/manpages/findsmb.1.sgml b/docs/docbook/manpages/findsmb.1.sgml
new file mode 100644
index 0000000000..852dc7da95
--- /dev/null
+++ b/docs/docbook/manpages/findsmb.1.sgml
@@ -0,0 +1,131 @@
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
+<refentry id="findsmb">
+
+<refmeta>
+ <refentrytitle>findsmb</refentrytitle>
+ <manvolnum>1</manvolnum>
+</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 <ulink url="samba.7.html">
+ Samba</ulink> 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 <ulink url="nmblookup.1.html"><command>
+ nmblookup(1)</command></ulink> and <ulink url="smbclient.1.html">
+ <command>smbclient(1)</command></ulink> to obtain this information.
+ </para>
+</refsect1>
+
+<refsect1>
+ <title>OPTIONS</title>
+
+ <variablelist>
+ <varlistentry>
+ <term>subnet broadcast address</term>
+ <listitem><para>Without this option, <command>findsmb
+ </command> will probe the subnet of the machine where
+ <command>findsmb</command> is run. This value is passed
+ to <command>nmblookup</command> 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, Windows 95 or Windows 98 will
+ not show any information about the operating system or server
+ version.</para>
+
+ <para>The command must be run on a system without <ulink
+ url="nmbd.8.html"><command>nmbd</command></ulink> 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. </para>
+
+ <para>For example running <command>findsmb</command> on a machine
+ without <command>nmbd</command> running would yield output similar
+ to the following</para>
+
+ <screen><computeroutput>
+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]
+ </computeroutput></screen>
+
+</refsect1>
+
+
+<refsect1>
+ <title>VERSION</title>
+
+ <para>This man page is correct for version 2.2 of
+ the Samba suite.</para>
+</refsect1>
+
+<refsect1>
+ <title>SEE ALSO</title>
+ <para><ulink url="nmbd.8.html"><command>nmbd(8)</command></ulink>,
+ <ulink url="smbclient.1.html"><command>smbclient(1)
+ </command></ulink>, and <ulink url="smbclient.1.html">
+ <command>nmblookup(1)</command></ulink>
+ </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>
+
+ <para>The original Samba man pages were written by Karl Auer.
+ The man page sources were converted to YODL format (another
+ excellent piece of Open Source software, available at
+ <ulink url="ftp://ftp.icce.rug.nl/pub/unix/">
+ ftp://ftp.icce.rug.nl/pub/unix/</ulink>) and updated for the Samba 2.0
+ release by Jeremy Allison. The conversion to DocBook for
+ Samba 2.2 was done by Gerald Carter</para>
+</refsect1>
+
+</refentry>
diff --git a/docs/docbook/nmbd.8.sgml b/docs/docbook/manpages/nmbd.8.sgml
index 0188bca748..0188bca748 100644
--- a/docs/docbook/nmbd.8.sgml
+++ b/docs/docbook/manpages/nmbd.8.sgml
diff --git a/docs/docbook/samba.7.sgml b/docs/docbook/manpages/samba.7.sgml
index a27b52ca94..a27b52ca94 100644
--- a/docs/docbook/samba.7.sgml
+++ b/docs/docbook/manpages/samba.7.sgml
diff --git a/docs/docbook/smb.conf.5.sgml b/docs/docbook/manpages/smb.conf.5.sgml
index a00ca178db..a00ca178db 100644
--- a/docs/docbook/smb.conf.5.sgml
+++ b/docs/docbook/manpages/smb.conf.5.sgml
diff --git a/docs/docbook/smbd.8.sgml b/docs/docbook/manpages/smbd.8.sgml
index 2ee7b46e19..2ee7b46e19 100644
--- a/docs/docbook/smbd.8.sgml
+++ b/docs/docbook/manpages/smbd.8.sgml