summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorGerald Carter <jerry@samba.org>2001-02-22 17:28:24 +0000
committerGerald Carter <jerry@samba.org>2001-02-22 17:28:24 +0000
commit5462cf51ee3056b93dbf48138f5b3268f18a5158 (patch)
tree50409415cdfec7972f43e9cc05dee8b4df6c987b /docs
parent5cd4655426c8a2da6bd0d7800f95492b577c1f77 (diff)
downloadsamba-5462cf51ee3056b93dbf48138f5b3268f18a5158.tar.gz
samba-5462cf51ee3056b93dbf48138f5b3268f18a5158.tar.bz2
samba-5462cf51ee3056b93dbf48138f5b3268f18a5158.zip
getting closer
.... (This used to be commit 5aed6bf227e9a83eab810560a21dca0c96d14dcf)
Diffstat (limited to 'docs')
-rw-r--r--docs/docbook/manpages/smbcontrol.1.sgml160
-rw-r--r--docs/htmldocs/smbcontrol.1.html413
-rw-r--r--docs/manpages/smbcontrol.1210
3 files changed, 576 insertions, 207 deletions
diff --git a/docs/docbook/manpages/smbcontrol.1.sgml b/docs/docbook/manpages/smbcontrol.1.sgml
new file mode 100644
index 0000000000..44418ea85f
--- /dev/null
+++ b/docs/docbook/manpages/smbcontrol.1.sgml
@@ -0,0 +1,160 @@
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
+<refentry id="findsmb">
+
+<refmeta>
+ <refentrytitle>smbcontrol</refentrytitle>
+ <manvolnum>1</manvolnum>
+</refmeta>
+
+
+<refnamediv>
+ <refname>smbcontrol</refname>
+ <refpurpose>send messages to smbd or nmbd processes</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+ <cmdsynopsis>
+ <command>smbcontrol</command>
+ <arg>-i</arg>
+ </cmdsynopsis>
+
+ <cmdsynopsis>
+ <command>smbcontrol</command>
+ <arg>destination</arg>
+ <arg>message-type</arg>
+ <arg>parameter</arg>
+ </cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1>
+ <title>DESCRIPTION</title>
+
+ <para>This tool is part of the <ulink url="samba.7.html">
+ Samba</ulink> suite.</para>
+
+ <para><command>smbcontrol</command> is a very small program, which
+ sends messages to an <ulink url="smbd.8.html">smbd(8)</ulink> or
+ an <ulink url="nmbd.8.html">nmbd(8)</ulink> daemon running on the
+ system.</para>
+</refsect1>
+
+
+<refsect1>
+ <title>OPTIONS</title>
+
+ <variablelist>
+ <varlistentry>
+ <term>-i</term>
+ <listitem><para>Run interactively. Individual commands
+ of the form destination message-type parameters can be entered
+ on STDIN. An empty command line or a "q" will quit the
+ program.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>destination</term>
+ <listitem><para>One of <parameter>nmbd</parameter>
+ <parameter>smbd</parameter> or a process ID.</para>
+
+ <para>The <parameter>smbd</parameter> destination causes the
+ message to "broadcast" to all smbd daemons.</para>
+
+ <para>The <parameter>nmbd</parameter> destination causes the
+ message to be sent to the nmbd daemon specified in the
+ <filename>nmbd.pid</filename> file.</para>
+
+ <para>If a single process ID is given, the message is sent
+ to only that process.</para></listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term>message-type</term>
+ <listitem><para>One of: <constant>debug</constant>,
+ <constant>force-election</constant>, <constant>ping
+ </constant>, <constant>profile</constant>, <constant>
+ debuglevel</constant>, <constant>profilelevel</constant>,
+ or <constant>printer-notify</constant>.</para>
+
+ <para>The <constant>debug</constant> message-type allows
+ the debug level to be set to the value specified by the
+ parameter. This can be sent to any of the destinations.</para>
+
+ <para>The <constant>force-election</constant> message-type can only be
+ sent to the <constant>nmbd</constant> destination. This message
+ causes the <command>nmbd</command> daemon to force a new browse
+ master election.</para>
+
+ <para>The <constant>ping</constant> message-type sends the
+ number of "ping" messages specified by the parameter and waits
+ for the same number of reply "pong" messages. This can be sent to
+ any of the destinations.</para>
+
+ <para>The <constant>profile</constant> message-type sends a
+ message to an smbd to change the profile settings based on the
+ parameter. The parameter can be "on" to turn on profile stats
+ collection, "off" to turn off profile stats collection, "count"
+ to enable only collection of count stats (time stats are
+ disabled), and "flush" to zero the current profile stats. This can
+ be sent to any of the destinations.</para>
+
+ <para>The <constant>debuglevel</constant> message-type sends
+ a "request debug level" message. The current debug level setting
+ is returned by a "debuglevel" message. This can be
+ sent to any of the destinations.</para>
+
+ <para>The <constant>profilelevel</constant> message-type sends
+ a "request profile level" message. The current profile level
+ setting is returned by a "profilelevel" message. This can be sent
+ to any of the destinations.</para>
+
+ <para>The <constant>printer-notify</constant> message-type sends a
+ message to smbd which in turn sends a printer notify message to
+ any Windows NT clients connected to a printer. This message-type
+ takes an argument of the printer name to send notify messages to.
+ This message can only be sent to <constant>smbd</constant>.</para>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term>parameters</term>
+ <listitem><para>any parameters required for the message-type</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+
+</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>,
+ and <ulink url="smbd.8.html"><command>smbd(8)</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/htmldocs/smbcontrol.1.html b/docs/htmldocs/smbcontrol.1.html
index 57bda3759c..2a06439687 100644
--- a/docs/htmldocs/smbcontrol.1.html
+++ b/docs/htmldocs/smbcontrol.1.html
@@ -1,106 +1,307 @@
-
-
-
-
-
-<html><head><title>smbcontrol (1)</title>
-
-<link rev="made" href="mailto:samba@samba.org">
-</head>
-<body>
-
-<hr>
-
-<h1>smbcontrol (1)</h1>
-<h2>Samba</h2>
-<h2>29 Sep 2000</h2>
-
-
-
-
-<p><br><a name="NAME"></a>
-<h2>NAME</h2>
- smbcontrol - send messages to smbd or nmbd processes
-<p><br><a name="SYNOPSIS"></a>
-<h2>SYNOPSIS</h2>
-
-<p><br><strong>smbcontrol</strong> <a href="smbcontrol.1.html#minusi">-i</a>
-<p><br><strong>smbcontrol</strong> <a href="smbcontrol.1.html#destination">destination</a> <a href="smbcontrol.1.html#messagetype">message-type</a> <a href="smbcontrol.1.html#parameters">parameters</a>
-<p><br><a name="DESCRIPTION"></a>
-<h2>DESCRIPTION</h2>
-
-<p><br>This program is part of the <strong>Samba</strong> suite.
-<p><br><strong>smbcontrol</strong> is a very small program, which sends messages to an
-<a href="smbd.8.html"><strong>smbd</strong></a> or an <a href="nmbd.8.html"><strong>nmbd</strong></a> daemon
-running on the system.
-<p><br><a name="OPTIONS"></a>
-<h2>OPTIONS</h2>
-
-<p><br><ul>
-<p><br><a name="minusi"></a>
-<li><strong><strong>-i</strong></strong> Run interactively. Individual commands of the form
-<a href="smbcontrol.1.html#destination">destination</a> <a href="smbcontrol.1.html#messagetype">message-type</a> <a href="smbcontrol.1.html#parameters">parameters</a>
-can be entered on STDIN. An empty command line or a "q" will quit the program.
-<p><br><a name="destination"></a>
-<li><strong><strong>destination</strong></strong> is one of "nmbd", "smbd" or a process ID.
-<p><br>The <strong>smbd</strong> destination causes the message to be "broadcast" to all
-smbd daemons.
-<p><br>The <strong>nmbd</strong> destination causes the message to be sent to the nmbd
-daemon specified in the <strong>nmbd.pid</strong> file.
-<p><br>If a single process ID is given, the message is sent to only that
-process.
-<p><br><a name="messagetype"></a>
-<li><strong><strong>message-type</strong></strong> is one of: debug, force-election, ping, profile,
-debuglevel, profilelevel, or printer-notify.
-<p><br>The <strong>debug</strong> message-type allows the debug level to be set to the value
-specified by the parameter. This can be sent to any of the destinations.
-<p><br>The <strong>force-election</strong> message-type can only be sent to the <strong>nmbd</strong>
-destination. This message causes the <strong>nmbd</strong> daemon to force a
-new browse master election.
-<p><br>The <strong>ping</strong> message-type sends the number of "ping" messages specified
-by the parameter and waits for the same number of
-reply "pong" messages. This can be sent to any of the destinations.
-<p><br>The <strong>profile</strong> message-type sends a message to an smbd to change the profile
-settings based on the parameter. The parameter can be "on" to turn on
-profile stats collection, "off" to turn off profile stats collection, "count"
-to enable only collection of count stats (time stats are disabled), and
-"flush" to zero the current profile stats.
-This can be sent to any of the destinations.
-<p><br>The <strong>debuglevel</strong> message-type sends a "request debug level" message.
-The current debug level setting is returned by a
-"debuglevel" message. This can be sent to any of the destinations.
-<p><br>The <strong>profilelevel</strong> message-type sends a "request profile level" message.
-The current profile level setting is returned by a
-"profilelevel" message. This can be sent to any of the destinations.
-<p><br>The <strong>printer-notify</strong> message-type sends a message to smbd which in turn
-sends a printer notify message to any Windows NT clients connected to
-a printer. This message-type takes an argument of the printer name to
-send notify messages to. This message can only be sent to smbd.
-<p><br><a name="parameters"></a>
-<li><strong><strong>parameters</strong></strong> is any parameters required for the message-type
-<p><br></ul>
-<p><br><a name="VERSION"></a>
-<h2>VERSION</h2>
-
-<p><br>This man page is correct for version 2.2.0 of the Samba suite.
-<p><br><a name="SEEALSO"></a>
-<h2>SEE ALSO</h2>
-
-<p><br><a href="smbd.8.html"><strong>smbd (8)</strong></a>, <a href="nmbd.8.html"><strong>nmbd (8)</strong></a>
-<p><br><a name="AUTHOR"></a>
-<h2>AUTHOR</h2>
-
-<p><br>The original Samba software and related utilities were created by
-Andrew Tridgell <a href="mailto:samba@samba.org"><em>samba@samba.org</em></a>. Samba is now developed
-by the Samba Team as an Open Source project similar to the way the
-Linux kernel is developed.
-<p><br>This man page source was written in YODL format (another excellent piece of Open
-Source software, available at
-<a href="ftp://ftp.icce.rug.nl/pub/unix/"><strong>ftp://ftp.icce.rug.nl/pub/unix/</strong></a>)
-for the Samba 2.2.0 release by Herb Lewis.
-<a href="mailto:samba@samba.org"><em>samba@samba.org</em></a>.
-<p><br>See <a href="samba.7.html"><strong>samba (7)</strong></a> to find out how to get a full
-list of contributors and details on how to submit bug reports,
-comments etc.
-</body>
-</html>
+<HTML
+><HEAD
+><TITLE
+>smbcontrol</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.57"></HEAD
+><BODY
+CLASS="REFENTRY"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><H1
+><A
+NAME="FINDSMB"
+>smbcontrol</A
+></H1
+><DIV
+CLASS="REFNAMEDIV"
+><A
+NAME="AEN5"
+></A
+><H2
+>Name</H2
+>smbcontrol&nbsp;--&nbsp;send messages to smbd or nmbd processes</DIV
+><DIV
+CLASS="REFSYNOPSISDIV"
+><A
+NAME="AEN8"
+></A
+><H2
+>Synopsis</H2
+><P
+><B
+CLASS="COMMAND"
+>smbcontrol</B
+> [-i]</P
+><P
+><B
+CLASS="COMMAND"
+>smbcontrol</B
+> [destination] [message-type] [parameter]</P
+></DIV
+><DIV
+CLASS="REFSECT1"
+><A
+NAME="AEN17"
+></A
+><H2
+>DESCRIPTION</H2
+><P
+>This tool is part of the <A
+HREF="samba.7.html"
+TARGET="_top"
+> Samba</A
+> suite.</P
+><P
+><B
+CLASS="COMMAND"
+>smbcontrol</B
+> is a very small program, which
+ sends messages to an <A
+HREF="smbd.8.html"
+TARGET="_top"
+>smbd(8)</A
+> or
+ an <A
+HREF="nmbd.8.html"
+TARGET="_top"
+>nmbd(8)</A
+> daemon running on the
+ system.</P
+></DIV
+><DIV
+CLASS="REFSECT1"
+><A
+NAME="AEN25"
+></A
+><H2
+>OPTIONS</H2
+><P
+></P
+><DIV
+CLASS="VARIABLELIST"
+><DL
+><DT
+>-i&#62;</DT
+><DD
+><P
+>Run interactively. Individual commands
+ of the form destination message-type parameters can be entered
+ on STDIN. An empty command line or a "q" will quit the
+ program.</P
+></DD
+><DT
+>destination</DT
+><DD
+><P
+>One of <TT
+CLASS="PARAMETER"
+><I
+>nmbd</I
+></TT
+>
+ <TT
+CLASS="PARAMETER"
+><I
+>smbd</I
+></TT
+> or a process ID.</P
+><P
+>The <TT
+CLASS="PARAMETER"
+><I
+>smbd</I
+></TT
+> destination causes the
+ message to "broadcast" to all smbd daemons.</P
+><P
+>The <TT
+CLASS="PARAMETER"
+><I
+>nmbd</I
+></TT
+> destination causes the
+ message to be sent to the nmbd daemon specified in the
+ <TT
+CLASS="FILENAME"
+>nmbd.pid</TT
+> file.</P
+><P
+>If a single process ID is given, the message is sent
+ to only that process.</P
+></DD
+><DT
+>message-type</DT
+><DD
+><P
+>One of: <TT
+CLASS="CONSTANT"
+>debug</TT
+>,
+ <TT
+CLASS="CONSTANT"
+>force-election</TT
+>, <TT
+CLASS="CONSTANT"
+>ping
+ </TT
+>, <TT
+CLASS="CONSTANT"
+>profile</TT
+>, <TT
+CLASS="CONSTANT"
+> debuglevel</TT
+>, <TT
+CLASS="CONSTANT"
+>profilelevel</TT
+>,
+ or <TT
+CLASS="CONSTANT"
+>printer-notify</TT
+>.</P
+><P
+>The <TT
+CLASS="CONSTANT"
+>debug</TT
+> message-type allows
+ the debug level to be set to the value specified by the
+ parameter. This can be sent to any of the destinations.</P
+><P
+>The <TT
+CLASS="CONSTANT"
+>force-election</TT
+> message-type can only be
+ sent to the <TT
+CLASS="CONSTANT"
+>nmbd</TT
+> destination. This message
+ causes the <B
+CLASS="COMMAND"
+>nmbd</B
+> daemon to force a new browse
+ master election.</P
+><P
+>The <TT
+CLASS="CONSTANT"
+>ping</TT
+> message-type sends the
+ number of "ping" messages specified by the parameter and waits
+ for the same number of reply "pong" messages. This can be sent to
+ any of the destinations.</P
+><P
+>The <TT
+CLASS="CONSTANT"
+>profile</TT
+> message-type sends a
+ message to an smbd to change the profile settings based on the
+ parameter. The parameter can be "on" to turn on profile stats
+ collection, "off" to turn off profile stats collection, "count"
+ to enable only collection of count stats (time stats are
+ disabled), and "flush" to zero the current profile stats. This can
+ be sent to any of the destinations.</P
+><P
+>The <TT
+CLASS="CONSTANT"
+>debuglevel</TT
+> message-type sends
+ a "request debug level" message. The current debug level setting
+ is returned by a "debuglevel" message. This can be
+ sent to any of the destinations.</P
+><P
+>The <TT
+CLASS="CONSTANT"
+>profilelevel</TT
+> message-type sends
+ a "request profile level" message. The current profile level
+ setting is returned by a "profilelevel" message. This can be sent
+ to any of the destinations.</P
+><P
+>The <TT
+CLASS="CONSTANT"
+>printer-notify</TT
+> message-type sends a
+ message to smbd which in turn sends a printer notify message to
+ any Windows NT clients connected to a printer. This message-type
+ takes an argument of the printer name to send notify messages to.
+ This message can only be sent to <TT
+CLASS="CONSTANT"
+>smbd</TT
+>.</P
+></DD
+><DT
+>parameters</DT
+><DD
+><P
+>any parameters required for the message-type</P
+></DD
+></DL
+></DIV
+></DIV
+><DIV
+CLASS="REFSECT1"
+><A
+NAME="AEN76"
+></A
+><H2
+>VERSION</H2
+><P
+>This man page is correct for version 2.2 of
+ the Samba suite.</P
+></DIV
+><DIV
+CLASS="REFSECT1"
+><A
+NAME="AEN79"
+></A
+><H2
+>SEE ALSO</H2
+><P
+><A
+HREF="nmbd.8.html"
+TARGET="_top"
+><B
+CLASS="COMMAND"
+>nmbd(8)</B
+></A
+>,
+ and <A
+HREF="smbd.8.html"
+TARGET="_top"
+><B
+CLASS="COMMAND"
+>smbd(8)</B
+></A
+>.
+ </P
+></DIV
+><DIV
+CLASS="REFSECT1"
+><A
+NAME="AEN86"
+></A
+><H2
+>AUTHOR</H2
+><P
+>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.</P
+><P
+>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
+ <A
+HREF="ftp://ftp.icce.rug.nl/pub/unix/"
+TARGET="_top"
+> ftp://ftp.icce.rug.nl/pub/unix/</A
+>) and updated for the Samba 2.0
+ release by Jeremy Allison. The conversion to DocBook for
+ Samba 2.2 was done by Gerald Carter</P
+></DIV
+></BODY
+></HTML
+> \ No newline at end of file
diff --git a/docs/manpages/smbcontrol.1 b/docs/manpages/smbcontrol.1
index 2dbe1212cf..02cd2ca6c4 100644
--- a/docs/manpages/smbcontrol.1
+++ b/docs/manpages/smbcontrol.1
@@ -1,102 +1,110 @@
-.TH SMBCONTROL 1 "23 Nov 2000" "smbcontrol 2.2.0-alpha1"
-.PP
-.SH "NAME"
+.\" This manpage has been automatically generated by docbook2man-spec
+.\" from a DocBook document. docbook2man-spec can be found at:
+.\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/>
+.\" Please send any bug reports, improvements, comments, patches,
+.\" etc. to Steve Cheng <steve@ggi-project.org>.
+.TH "SMBCONTROL" "1" "22 February 2001" "" ""
+.SH NAME
smbcontrol \- send messages to smbd or nmbd processes
-.PP
-.SH "SYNOPSIS"
-.PP
-\fBsmbcontrol\fP -i
-.PP
-\fBsmbcontrol\fP destination message-type parameters
-.PP
-.SH "DESCRIPTION"
-.PP
-This program is part of the \fBSamba\fP suite\&.
-.PP
-\fBsmbcontrol\fP is a very small program, which sends messages to an
-\fBsmbd\fP or an \fBnmbd\fP daemon
-running on the system\&.
-.PP
-.SH "OPTIONS"
-.PP
-.IP
-.IP "\fB-i\fP"
-Run interactively\&. Individual commands of the form
-destination message-type parameters
-can be entered on STDIN\&. An empty command line or a "q" will quit the program\&.
-.IP
-.IP "\fBdestination\fP"
-is one of "nmbd", "smbd" or a process ID\&.
-.IP
-The \fBsmbd\fP destination causes the message to be "broadcast" to all
-smbd daemons\&.
-.IP
-The \fBnmbd\fP destination causes the message to be sent to the nmbd
-daemon specified in the \fBnmbd\&.pid\fP file\&.
-.IP
-If a single process ID is given, the message is sent to only that
-process\&.
-.IP
-.IP "\fBmessage-type\fP"
-is one of: debug, force-election, ping, profile,
-debuglevel, profilelevel, or printer-notify\&.
-.IP
-The \fBdebug\fP message-type allows the debug level to be set to the value
-specified by the parameter\&. This can be sent to any of the destinations\&.
-.IP
-The \fBforce-election\fP message-type can only be sent to the \fBnmbd\fP
-destination\&. This message causes the \fBnmbd\fP daemon to force a
-new browse master election\&.
-.IP
-The \fBping\fP message-type sends the number of "ping" messages specified
-by the parameter and waits for the same number of
-reply "pong" messages\&. This can be sent to any of the destinations\&.
-.IP
-The \fBprofile\fP message-type sends a message to an smbd to change the profile
-settings based on the parameter\&. The parameter can be "on" to turn on
-profile stats collection, "off" to turn off profile stats collection, "count"
-to enable only collection of count stats (time stats are disabled), and
-"flush" to zero the current profile stats\&.
-This can be sent to any of the destinations\&.
-.IP
-The \fBdebuglevel\fP message-type sends a "request debug level" message\&.
-The current debug level setting is returned by a
-"debuglevel" message\&. This can be sent to any of the destinations\&.
-.IP
-The \fBprofilelevel\fP message-type sends a "request profile level" message\&.
-The current profile level setting is returned by a
-"profilelevel" message\&. This can be sent to any of the destinations\&.
-.IP
-The \fBprinter-notify\fP message-type sends a message to smbd which in turn
-sends a printer notify message to any Windows NT clients connected to
-a printer\&. This message-type takes an argument of the printer name to
-send notify messages to\&. This message can only be sent to smbd\&.
-.IP
-.IP "\fBparameters\fP"
-is any parameters required for the message-type
-.IP
-.PP
-.SH "VERSION"
-.PP
-This man page is correct for version 2\&.2\&.0 of the Samba suite\&.
-.PP
-.SH "SEE ALSO"
-.PP
-\fBsmbd (8)\fP, \fBnmbd (8)\fP
-.PP
-.SH "AUTHOR"
-.PP
-The original Samba software and related utilities were created by
-Andrew Tridgell \fIsamba@samba\&.org\fP\&. Samba is now developed
-by the Samba Team as an Open Source project similar to the way the
-Linux kernel is developed\&.
-.PP
-This man page source was written in YODL format (another excellent piece of Open
-Source software, available at
-\fBftp://ftp\&.icce\&.rug\&.nl/pub/unix/\fP)
-for the Samba 2\&.2\&.0 release by Herb Lewis\&.
-\fIsamba@samba\&.org\fP\&.
-.PP
-See \fBsamba (7)\fP to find out how to get a full
-list of contributors and details on how to submit bug reports,
-comments etc\&.
+.SH SYNOPSIS
+.sp
+\fBsmbcontrol\fR [ \fB-i\fR ]
+.sp
+\fBsmbcontrol\fR [ \fBdestination\fR ] [ \fBmessage-type\fR ] [ \fBparameter\fR ]
+.SH "DESCRIPTION"
+.PP
+This tool is part of the Samba <URL:samba.7.html> suite.
+.PP
+\fBsmbcontrol\fR is a very small program, which
+sends messages to an smbd(8) <URL:smbd.8.html> or
+an nmbd(8) <URL:nmbd.8.html> daemon running on the
+system.
+.SH "OPTIONS"
+.TP
+\fB-i>\fR
+Run interactively. Individual commands
+of the form destination message-type parameters can be entered
+on STDIN. An empty command line or a "q" will quit the
+program.
+.TP
+\fBdestination\fR
+One of \fInmbd\fR
+\fIsmbd\fR or a process ID.
+
+The \fIsmbd\fR destination causes the
+message to "broadcast" to all smbd daemons.
+
+The \fInmbd\fR destination causes the
+message to be sent to the nmbd daemon specified in the
+\fInmbd.pid\fR file.
+
+If a single process ID is given, the message is sent
+to only that process.
+.TP
+\fBmessage-type\fR
+One of: debug,
+force-election, ping
+, profile, debuglevel, profilelevel,
+or printer-notify.
+
+The debug message-type allows
+the debug level to be set to the value specified by the
+parameter. This can be sent to any of the destinations.
+
+The force-election message-type can only be
+sent to the nmbd destination. This message
+causes the \fBnmbd\fR daemon to force a new browse
+master election.
+
+The ping message-type sends the
+number of "ping" messages specified by the parameter and waits
+for the same number of reply "pong" messages. This can be sent to
+any of the destinations.
+
+The profile message-type sends a
+message to an smbd to change the profile settings based on the
+parameter. The parameter can be "on" to turn on profile stats
+collection, "off" to turn off profile stats collection, "count"
+to enable only collection of count stats (time stats are
+disabled), and "flush" to zero the current profile stats. This can
+be sent to any of the destinations.
+
+The debuglevel message-type sends
+a "request debug level" message. The current debug level setting
+is returned by a "debuglevel" message. This can be
+sent to any of the destinations.
+
+The profilelevel message-type sends
+a "request profile level" message. The current profile level
+setting is returned by a "profilelevel" message. This can be sent
+to any of the destinations.
+
+The printer-notify message-type sends a
+message to smbd which in turn sends a printer notify message to
+any Windows NT clients connected to a printer. This message-type
+takes an argument of the printer name to send notify messages to.
+This message can only be sent to smbd.
+.TP
+\fBparameters\fR
+any parameters required for the message-type
+.SH "VERSION"
+.PP
+This man page is correct for version 2.2 of
+the Samba suite.
+.SH "SEE ALSO"
+.PP
+\fBnmbd(8)\fR <URL:nmbd.8.html>,
+and \fBsmbd(8)\fR <URL:smbd.8.html>.
+.SH "AUTHOR"
+.PP
+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.
+.PP
+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
+ftp://ftp.icce.rug.nl/pub/unix/ <URL:ftp://ftp.icce.rug.nl/pub/unix/>) and updated for the Samba 2.0
+release by Jeremy Allison. The conversion to DocBook for
+Samba 2.2 was done by Gerald Carter