summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/logon/adduserscript.xml
diff options
context:
space:
mode:
authorGerald Carter <jerry@samba.org>2003-10-10 16:46:22 +0000
committerGerald Carter <jerry@samba.org>2003-10-10 16:46:22 +0000
commitfec4b31bc1a76e408732e1a80b366d97fcf38143 (patch)
treee23398c2bcc4e3b2da28c8007ca453228aefb44f /docs/docbook/smbdotconf/logon/adduserscript.xml
parent20c7b998a38424e8e7b4d218f923937b9e8862d4 (diff)
downloadsamba-fec4b31bc1a76e408732e1a80b366d97fcf38143.tar.gz
samba-fec4b31bc1a76e408732e1a80b366d97fcf38143.tar.bz2
samba-fec4b31bc1a76e408732e1a80b366d97fcf38143.zip
removing docs tree from 3.0
(This used to be commit 0a3eb5574c91685ab07436c67b031266fb329693)
Diffstat (limited to 'docs/docbook/smbdotconf/logon/adduserscript.xml')
-rw-r--r--docs/docbook/smbdotconf/logon/adduserscript.xml50
1 files changed, 0 insertions, 50 deletions
diff --git a/docs/docbook/smbdotconf/logon/adduserscript.xml b/docs/docbook/smbdotconf/logon/adduserscript.xml
deleted file mode 100644
index 42f7b04563..0000000000
--- a/docs/docbook/smbdotconf/logon/adduserscript.xml
+++ /dev/null
@@ -1,50 +0,0 @@
-<samba:parameter name="add user script"
- context="G"
- advanced="1" developer="1"
- xmlns:samba="http://samba.org/common">
-<listitem>
- <para>This is the full pathname to a script that will
- be run <emphasis>AS ROOT</emphasis> by <citerefentry><refentrytitle>smbd</refentrytitle>
- <manvolnum>8</manvolnum></citerefentry> under special circumstances described below.</para>
-
- <para>Normally, a Samba server requires that UNIX users are
- created for all users accessing files on this server. For sites
- that use Windows NT account databases as their primary user database
- creating these users and keeping the user list in sync with the
- Windows NT PDC is an onerous task. This option allows smbd to create the required UNIX users
- <emphasis>ON DEMAND</emphasis> when a user accesses the Samba server.</para>
-
- <para>In order to use this option, <citerefentry><refentrytitle>smbd</refentrytitle>
- <manvolnum>8</manvolnum></citerefentry> must <emphasis>NOT</emphasis> be set to <parameter moreinfo="none">security = share</parameter>
- and <parameter moreinfo="none">add user script</parameter>
- must be set to a full pathname for a script that will create a UNIX
- user given one argument of <parameter moreinfo="none">%u</parameter>, which expands into
- the UNIX user name to create.</para>
-
- <para>When the Windows user attempts to access the Samba server,
- at login (session setup in the SMB protocol) time, <citerefentry><refentrytitle>smbd</refentrytitle>
- <manvolnum>8</manvolnum></citerefentry> contacts the <parameter moreinfo="none">password server</parameter> and
- attempts to authenticate the given user with the given password. If the
- authentication succeeds then <command moreinfo="none">smbd</command>
- attempts to find a UNIX user in the UNIX password database to map the
- Windows user into. If this lookup fails, and <parameter moreinfo="none">add user script
- </parameter> is set then <command moreinfo="none">smbd</command> will
- call the specified script <emphasis>AS ROOT</emphasis>, expanding
- any <parameter moreinfo="none">%u</parameter> argument to be the user name to create.</para>
-
- <para>If this script successfully creates the user then <command moreinfo="none">smbd
- </command> will continue on as though the UNIX user
- already existed. In this way, UNIX users are dynamically created to
- match existing Windows NT accounts.</para>
-
- <para>See also <link linkend="SECURITY"><parameter moreinfo="none">
- security</parameter></link>, <link linkend="PASSWORDSERVER">
- <parameter moreinfo="none">password server</parameter></link>,
- <link linkend="DELETEUSERSCRIPT"><parameter moreinfo="none">delete user
- script</parameter></link>.</para>
-
- <para>Default: <command moreinfo="none">add user script = &lt;empty string&gt;</command></para>
-
- <para>Example: <command moreinfo="none">add user script = /usr/local/samba/bin/add_user %u</command></para>
-</listitem>
-</samba:parameter>