Document Tim's smbtree program

(This used to be commit aa528bf0f2c3286a6f78c1a36e48c6ff15a85457)

1 files changed, 91 insertions, 0 deletions

diff --git a/docs/docbook/manpages/smbtree.1.sgml b/docs/docbook/manpages/smbtree.1.sgml
new file mode 100644
index 0000000000..ce664908bc
--- /dev/null
+++ b/docs/docbook/manpages/smbtree.1.sgml
@@ -0,0 +1,91 @@
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
+<!ENTITY % globalentities SYSTEM '../global.ent'> %globalentities;
+]>
+<refentry id="smbtree.1">
+
+<refmeta>
+	<refentrytitle>smbtree</refentrytitle>
+	<manvolnum>1</manvolnum>
+</refmeta>
+
+
+<refnamediv>
+	<refname>smbtree</refname>
+	<refpurpose>A text based smb network browser
+	</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+	<cmdsynopsis>
+		<command>smbtree</command>
+		<arg choice="opt">-b</arg>
+		<arg choice="opt">-D</arg>
+		<arg choice="opt">-S</arg>
+	</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1>
+	<title>DESCRIPTION</title>
+
+	<para>This tool is part of the <citerefentry><refentrytitle>Samba</refentrytitle>
+	<manvolnum>7</manvolnum></citerefentry> suite.</para>
+
+	<para><command>smbtree</command> is a smb browser program 
+	in text mode. It is similar to the "Network Neighborhood" found 
+	on Windows computers. It prints a tree with all 
+	the known domains, the servers in those domains and 
+	the shares on the servers.
+	</para>
+</refsect1>
+
+
+<refsect1>
+	<title>OPTIONS</title>
+
+	<variablelist>
+		<varlistentry>
+		<term>-b</term>
+		<listitem><para>Query network nodes by sending requests 
+		as broadcasts instead of querying the (domain) master browser.
+		</para></listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term>-D</term>
+		<listitem><para>Only print a list of all 
+		the domains known on broadcast or by the 
+		master browser</para></listitem>
+		</varlistentry>
+
+		<varlistentry>
+		<term>-S</term>
+		<listitem><para>Only print a list of 
+		all the domains and servers responding on broadcast or 
+		known by the master browser. 
+		</para></listitem>
+		</varlistentry>
+
+		&stdarg.help;
+		
+	</variablelist>
+</refsect1>
+
+<refsect1>
+	<title>VERSION</title>
+
+	<para>This man page is correct for version 3.0 of the Samba 
+	suite.</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 smbtree man page was written by Jelmer Vernooij. </para>
+</refsect1>
+
+</refentry>