summaryrefslogtreecommitdiff
path: root/docs/docbook
diff options
context:
space:
mode:
Diffstat (limited to 'docs/docbook')
-rw-r--r--docs/docbook/manpages/smbrun.1.sgml106
1 files changed, 106 insertions, 0 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>