and some more....

(This used to be commit c82234a03e8adf5ab2e2135f8e0948e3ed559bd9)
author: Gerald Carter <jerry@samba.org> 2001-02-22 16:45:46 +0000
committer: Gerald Carter <jerry@samba.org> 2001-02-22 16:45:46 +0000
commit: 171471c5d2bbda3ca1a25dd12d27e6fc3cd14cec (patch)
tree: ef08b0d74cf319393c8c16ac883498b12f16f6e0 /docs
parent: b7c527b7042c397ace5adef79d679a4596b7418f (diff)
download: samba-171471c5d2bbda3ca1a25dd12d27e6fc3cd14cec.tar.gz
samba-171471c5d2bbda3ca1a25dd12d27e6fc3cd14cec.tar.bz2
samba-171471c5d2bbda3ca1a25dd12d27e6fc3cd14cec.zip
3 files changed, 383 insertions, 155 deletions
diff --git a/docs/docbook/manpages/smbrun.1.sgml b/docs/docbook/manpages/smbrun.1.sgml
new file mode 100644
index 0000000000..f1afd7a28e
--- /dev/null
+++ b/docs/docbook/manpages/smbrun.1.sgml
@@ -0,0 +1,106 @@
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
+<refentry id="findsmb">
+
+<refmeta>
+	<refentrytitle>smbrun</refentrytitle>
+	<manvolnum>1</manvolnum>
+</refmeta>
+
+
+<refnamediv>
+	<refname>smbrun</refname>
+	<refpurpose>interface program between smbd and external 
+	programs</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+	<cmdsynopsis>
+		<command>smbrun</command>
+		<arg choice="req">&lt;shell command&gt;</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>smbrun</command> is a very small 'glue' program, 
+	which runs shell commands for the <ulink url="smbd.8.html"><command>
+	smbd(8)</command></ulink> daemon.</para>
+	
+	<para>It first changes to the highest effective user and group 
+	ID that it can, then runs the command line provided using the 
+	system() call. This program is necessary to allow some operating 
+	systems to run external programs as non-root.</para>
+</refsect1>
+
+<refsect1>
+	<title>OPTIONS</title>
+
+	<variablelist>
+		<varlistentry>
+		<term>shell command</term>
+		<listitem><para>The shell command to execute.  The 
+		command should have a fully-qualified path.</para></listitem>
+		</varlistentry>
+	</variablelist>
+</refsect1>
+
+<refsect1>
+	<title>ENVIRONMENT VARIABLES</title>
+
+	<para>The <parameter>PATH</parameter> variable set for the 
+	environment in which <command>smbrun</command> is executed will affect 
+	what executables are located and executed if a fully-qualified path
+	is not given in the command.</para>
+</refsect1>
+
+
+<refsect1>
+	<title>DIAGNOSTICS</title>
+
+	<para>If <command>smbrun</command> cannot be located or cannot 
+	be executed by <ulink url="smbd.8.html"><command>smbd(8)</command>
+	</ulink>, then appropriate messages will be found in the <command>
+	smbd</command> logs. Other diagnostics are dependent on the shell-command 
+	being run. It is advisable for your shell commands to issue suitable 
+	diagnostics to aid trouble-shooting.</para>
+</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="nmblookup.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/htmldocs/smbrun.1.html b/docs/htmldocs/smbrun.1.html
index 16133fcb22..95de5bebdf 100644
--- a/docs/htmldocs/smbrun.1.html
+++ b/docs/htmldocs/smbrun.1.html
@@ -1,86 +1,215 @@
-
-
- 
-
-
-
-<html><head><title>smbrun (1)</title>
-
-<link rev="made" href="mailto:samba@samba.org">
-</head>
-<body>
-
-<hr>
-
-<h1>smbrun (1)</h1>
-<h2>Samba</h2>
-<h2>23 Oct 1998</h2>
-
-
-    
-<p><a name="NAME"></a>
-<h2>NAME</h2>
-    smbrun - interface program between smbd and external programs
-<p><a name="SYNOPSIS"></a>
-<h2>SYNOPSIS</h2>
-     
-<p><strong>smbrun</strong> <a href="smbrun.1.html#shellcommand">shell-command</a>
-<p><a name="DESCRIPTION"></a>
-<h2>DESCRIPTION</h2>
-    
-<p>This program is part of the <strong>Samba</strong> suite.
-<p><strong>smbrun</strong> is a very small 'glue' program, which runs shell commands
-for the <a href="smbd.8.html"><strong>smbd</strong></a> daemon <a href="smbd.8.html"><strong>smbd
-(8)</strong></a>.
-<p>It first changes to the highest effective user and group ID that it
-can, then runs the command line provided using the system() call. This
-program is necessary to allow some operating systems to run external
-programs as non-root.
-<p><a name="OPTIONS"></a>
-<h2>OPTIONS</h2>
-    
-<p><dl>
-<p><a name="shellcommand"></a>
-<p></p><dt><strong><strong>shell-command</strong></strong><dd> The shell command to execute.  The command
-should have a fully-qualified path.
-<p></dl>
-<p><a name="ENVIRONMENTVARIABLES"></a>
-<h2>ENVIRONMENT VARIABLES</h2>
-    
-<p>The <em>PATH</em> variable set for the environment in which <strong>smbrun</strong> is
-executed will affect what executables are located and executed if a
-fully-qualified path is not given in the command.
-<p><a name="DIAGNOSTICS"></a>
-<h2>DIAGNOSTICS</h2>
-    
-<p>If <strong>smbrun</strong> cannot be located or cannot be executed by
-<a href="smbd.8.html"><strong>smbd</strong></a> then appropriate messages will be found in
-the <a href="smbd.8.html"><strong>smbd</strong></a> logs. Other diagnostics are dependent
-on the shell-command being run. It is advisable for your shell
-commands to issue suitable diagnostics to aid trouble-shooting.
-<p><a name="VERSION"></a>
-<h2>VERSION</h2>
-    
-<p>This man page is correct for version 2.0 of the Samba suite.
-<p><a name="SEEALSO"></a>
-<h2>SEE ALSO</h2>
-    
-<p><a href="smb.conf.5.html"><strong>smb.conf (5)</strong></a>, <a href="smbd.8.html"><strong>smbd (8)</strong></a>
-<p><a name="AUTHOR"></a>
-<h2>AUTHOR</h2>
-    
-<p>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>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/"><strong>ftp://ftp.icce.rug.nl/pub/unix/</strong></a>)
-and updated for the Samba2.0 release by Jeremy Allison.
-<a href="mailto:samba@samba.org"><em>samba@samba.org</em></a>.
-<p>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
+>smbrun</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"
+>smbrun</A
+></H1
+><DIV
+CLASS="REFNAMEDIV"
+><A
+NAME="AEN5"
+></A
+><H2
+>Name</H2
+>smbrun&nbsp;--&nbsp;interface program between smbd and external 
+	programs</DIV
+><DIV
+CLASS="REFSYNOPSISDIV"
+><A
+NAME="AEN8"
+></A
+><H2
+>Synopsis</H2
+><P
+><B
+CLASS="COMMAND"
+>smbrun</B
+>  {&lt;shell command&gt;}</P
+></DIV
+><DIV
+CLASS="REFSECT1"
+><A
+NAME="AEN12"
+></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"
+>smbrun</B
+> is a very small 'glue' program, 
+	which runs shell commands for the <A
+HREF="smbd.8.html"
+TARGET="_top"
+><B
+CLASS="COMMAND"
+>	smbd(8)</B
+></A
+> daemon.</P
+><P
+>It first changes to the highest effective user and group 
+	ID that it can, then runs the command line provided using the 
+	system() call. This program is necessary to allow some operating 
+	systems to run external programs as non-root.</P
+></DIV
+><DIV
+CLASS="REFSECT1"
+><A
+NAME="AEN21"
+></A
+><H2
+>OPTIONS</H2
+><P
+></P
+><DIV
+CLASS="VARIABLELIST"
+><DL
+><DT
+>shell command</DT
+><DD
+><P
+>The shell command to execute.  The 
+		command should have a fully-qualified path.</P
+></DD
+></DL
+></DIV
+></DIV
+><DIV
+CLASS="REFSECT1"
+><A
+NAME="AEN28"
+></A
+><H2
+>ENVIRONMENT VARIABLES</H2
+><P
+>The <TT
+CLASS="PARAMETER"
+><I
+>PATH</I
+></TT
+> variable set for the 
+	environment in which <B
+CLASS="COMMAND"
+>smbrun</B
+> is executed will affect 
+	what executables are located and executed if a fully-qualified path
+	is not given in the command.</P
+></DIV
+><DIV
+CLASS="REFSECT1"
+><A
+NAME="AEN33"
+></A
+><H2
+>DIAGNOSTICS</H2
+><P
+>If <B
+CLASS="COMMAND"
+>smbrun</B
+> cannot be located or cannot 
+	be executed by <A
+HREF="smbd.8.html"
+TARGET="_top"
+><B
+CLASS="COMMAND"
+>smbd(8)</B
+>
+	</A
+>, then appropriate messages will be found in the <B
+CLASS="COMMAND"
+>	smbd</B
+> logs. Other diagnostics are dependent on the shell-command 
+	being run. It is advisable for your shell commands to issue suitable 
+	diagnostics to aid trouble-shooting.</P
+></DIV
+><DIV
+CLASS="REFSECT1"
+><A
+NAME="AEN40"
+></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="AEN43"
+></A
+><H2
+>SEE ALSO</H2
+><P
+><A
+HREF="nmbd.8.html"
+TARGET="_top"
+><B
+CLASS="COMMAND"
+>nmbd(8)</B
+></A
+>, 
+	<A
+HREF="smbclient.1.html"
+TARGET="_top"
+><B
+CLASS="COMMAND"
+>smbclient(1)
+	</B
+></A
+>, and	<A
+HREF="nmblookup.1.html"
+TARGET="_top"
+>	<B
+CLASS="COMMAND"
+>nmblookup(1)</B
+></A
+>
+	</P
+></DIV
+><DIV
+CLASS="REFSECT1"
+><A
+NAME="AEN52"
+></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/smbrun.1 b/docs/manpages/smbrun.1
index 24d6efdfcd..24b320947e 100644
--- a/docs/manpages/smbrun.1
+++ b/docs/manpages/smbrun.1
@@ -1,69 +1,62 @@
-.TH "smbrun " "1" "23 Oct 1998" "Samba" "SAMBA" 
-.PP 
-.SH "NAME" 
-smbrun \- interface program between smbd and external programs
-.PP 
-.SH "SYNOPSIS" 
-.PP 
-\fBsmbrun\fP shell-command
-.PP 
-.SH "DESCRIPTION" 
-.PP 
-This program is part of the \fBSamba\fP suite\&.
-.PP 
-\fBsmbrun\fP is a very small \'glue\' program, which runs shell commands
-for the \fBsmbd\fP daemon \fBsmbd
-(8)\fP\&.
-.PP 
-It first changes to the highest effective user and group ID that it
-can, then runs the command line provided using the system() call\&. This
-program is necessary to allow some operating systems to run external
-programs as non-root\&.
-.PP 
-.SH "OPTIONS" 
-.PP 
-.IP 
-.IP "\fBshell-command\fP" 
-The shell command to execute\&.  The command
-should have a fully-qualified path\&.
-.IP 
-.PP 
-.SH "ENVIRONMENT VARIABLES" 
-.PP 
-The \fIPATH\fP variable set for the environment in which \fBsmbrun\fP is
-executed will affect what executables are located and executed if a
-fully-qualified path is not given in the command\&.
-.PP 
-.SH "DIAGNOSTICS" 
-.PP 
-If \fBsmbrun\fP cannot be located or cannot be executed by
-\fBsmbd\fP then appropriate messages will be found in
-the \fBsmbd\fP logs\&. Other diagnostics are dependent
-on the shell-command being run\&. It is advisable for your shell
-commands to issue suitable diagnostics to aid trouble-shooting\&.
-.PP 
-.SH "VERSION" 
-.PP 
-This man page is correct for version 2\&.0 of the Samba suite\&.
-.PP 
-.SH "SEE ALSO" 
-.PP 
-\fBsmb\&.conf (5)\fP, \fBsmbd (8)\fP
-.PP 
-.SH "AUTHOR" 
-.PP 
-The original Samba software and related utilities were created by
-Andrew Tridgell samba@samba\&.org\&. 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
-\fBftp://ftp\&.icce\&.rug\&.nl/pub/unix/\fP)
-and updated for the Samba2\&.0 release by Jeremy Allison\&.
-samba@samba\&.org\&.
-.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\&.
+.\" 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 "SMBRUN" "1" "22 February 2001" "" ""
+.SH NAME
+smbrun \- interface program between smbd and external  programs
+.SH SYNOPSIS
+.sp
+\fBsmbrun\fR \fB<shell command>\fR
+.SH "DESCRIPTION"
+.PP
+This tool is part of the  Samba <URL:samba.7.html> suite.
+.PP
+\fBsmbrun\fR is a very small 'glue' program, 
+which runs shell commands for the \fB smbd(8)\fR <URL:smbd.8.html> daemon.
+.PP
+It first changes to the highest effective user and group 
+ID that it can, then runs the command line provided using the 
+system() call. This program is necessary to allow some operating 
+systems to run external programs as non-root.
+.SH "OPTIONS"
+.TP
+\fBshell command\fR
+The shell command to execute. The 
+command should have a fully-qualified path.
+.SH "ENVIRONMENT VARIABLES"
+.PP
+The \fIPATH\fR variable set for the 
+environment in which \fBsmbrun\fR is executed will affect 
+what executables are located and executed if a fully-qualified path
+is not given in the command.
+.SH "DIAGNOSTICS"
+.PP
+If \fBsmbrun\fR cannot be located or cannot 
+be executed by \fBsmbd(8)\fR
+ <URL:smbd.8.html>, then appropriate messages will be found in the \fB smbd\fR logs. Other diagnostics are dependent on the shell-command 
+being run. It is advisable for your shell commands to issue suitable 
+diagnostics to aid trouble-shooting.
+.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>, 
+\fBsmbclient(1)
+\fR <URL:smbclient.1.html>, and  \fBnmblookup(1)\fR <URL:nmblookup.1.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
author	Gerald Carter <jerry@samba.org>	2001-02-22 16:45:46 +0000
committer	Gerald Carter <jerry@samba.org>	2001-02-22 16:45:46 +0000
commit	171471c5d2bbda3ca1a25dd12d27e6fc3cd14cec (patch)
tree	ef08b0d74cf319393c8c16ac883498b12f16f6e0 /docs
parent	b7c527b7042c397ace5adef79d679a4596b7418f (diff)
download	samba-171471c5d2bbda3ca1a25dd12d27e6fc3cd14cec.tar.gz samba-171471c5d2bbda3ca1a25dd12d27e6fc3cd14cec.tar.bz2 samba-171471c5d2bbda3ca1a25dd12d27e6fc3cd14cec.zip