Add new framework for smb.conf(5). Please read README before trying to compile.

I will commit more meta-information updates during week-end.
(This used to be commit 8d684dffab6a90b3d612a1aa2b2c457a2bc2e6ac)

9 files changed, 131 insertions, 0 deletions

diff --git a/docs/docbook/smbdotconf/winbind/templatehomedir.xml b/docs/docbook/smbdotconf/winbind/templatehomedir.xml
new file mode 100644
index 0000000000..a931e9b5a3
--- /dev/null
+++ b/docs/docbook/smbdotconf/winbind/templatehomedir.xml
@@ -0,0 +1,13 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+		<term><anchor id="TEMPLATEHOMEDIR"/>template homedir (G)</term>
+		<listitem><para>When filling out the user information for a Windows NT 
+		user, the <ulink url="winbindd.8.html">winbindd(8)</ulink> daemon 
+		uses this parameter to fill in the home directory for that user.  
+		If the string <parameter moreinfo="none">%D</parameter> is present it is substituted 
+		with the user's Windows NT domain name.  If the string <parameter moreinfo="none">%U
+		</parameter> is present it is substituted with the user's Windows 
+		NT user name.</para>
+
+		<para>Default: <command moreinfo="none">template homedir = /home/%D/%U</command></para>
+		</listitem>
+		</samba:parameter>
diff --git a/docs/docbook/smbdotconf/winbind/templateshell.xml b/docs/docbook/smbdotconf/winbind/templateshell.xml
new file mode 100644
index 0000000000..e0b9f1a2ca
--- /dev/null
+++ b/docs/docbook/smbdotconf/winbind/templateshell.xml
@@ -0,0 +1,10 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+		<term><anchor id="TEMPLATESHELL"/>template shell (G)</term>
+		<listitem><para>When filling out the user information for a Windows NT 
+		user, the <citerefentry><refentrytitle>winbindd</refentrytitle>
+		<manvolnum>8</manvolnum></citerefentry> daemon 
+		uses this parameter to fill in the login shell for that user.</para>
+
+		<para>Default: <command moreinfo="none">template shell = /bin/false</command></para>
+		</listitem>
+		</samba:parameter>
diff --git a/docs/docbook/smbdotconf/winbind/winbindcachetime.xml b/docs/docbook/smbdotconf/winbind/winbindcachetime.xml
new file mode 100644
index 0000000000..adbb8b12f6
--- /dev/null
+++ b/docs/docbook/smbdotconf/winbind/winbindcachetime.xml
@@ -0,0 +1,11 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+		<term><anchor id="WINBINDCACHETIME"/>winbind cache time (G)</term>
+		<listitem><para>This parameter specifies the number of 
+		seconds the <citerefentry><refentrytitle>winbindd</refentrytitle>
+		<manvolnum>8</manvolnum></citerefentry> daemon will cache 
+		user and group information before querying a Windows NT server 
+		again.</para>
+
+		<para>Default: <command moreinfo="none">winbind cache type = 15</command></para>
+		</listitem>
+		</samba:parameter>
diff --git a/docs/docbook/smbdotconf/winbind/winbindenumgroups.xml b/docs/docbook/smbdotconf/winbind/winbindenumgroups.xml
new file mode 100644
index 0000000000..096c280fc2
--- /dev/null
+++ b/docs/docbook/smbdotconf/winbind/winbindenumgroups.xml
@@ -0,0 +1,18 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+		<term><anchor id="WINBINDENUMGROUPS"/>winbind enum groups (G)</term> 
+		<listitem><para>On large installations using <citerefentry><refentrytitle>winbindd</refentrytitle>
+		<manvolnum>8</manvolnum></citerefentry> it may be necessary to suppress 
+		the enumeration of groups through the <command moreinfo="none">setgrent()</command>,
+		<command moreinfo="none">getgrent()</command> and
+		<command moreinfo="none">endgrent()</command> group of system calls.  If
+		the <parameter moreinfo="none">winbind enum groups</parameter> parameter is
+		<constant>no</constant>, calls to the <command moreinfo="none">getgrent()</command> system
+		call will not return any data. </para>
+
+		<para><emphasis>Warning:</emphasis> Turning off group
+		enumeration may cause some programs to behave oddly.
+		</para>
+
+		<para>Default: <command moreinfo="none">winbind enum groups = yes </command>
+		</para></listitem>
+		</samba:parameter>
diff --git a/docs/docbook/smbdotconf/winbind/winbindenumusers.xml b/docs/docbook/smbdotconf/winbind/winbindenumusers.xml
new file mode 100644
index 0000000000..7935755f0c
--- /dev/null
+++ b/docs/docbook/smbdotconf/winbind/winbindenumusers.xml
@@ -0,0 +1,20 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+		<term><anchor id="WINBINDENUMUSERS"/>winbind enum users (G)</term> 
+		<listitem><para>On large installations using <citerefentry><refentrytitle>winbindd</refentrytitle>
+		<manvolnum>8</manvolnum></citerefentry> it may be
+		necessary to suppress the enumeration of users through the <command moreinfo="none">setpwent()</command>,
+		<command moreinfo="none">getpwent()</command> and
+		<command moreinfo="none">endpwent()</command> group of system calls.  If
+		the <parameter moreinfo="none">winbind enum users</parameter> parameter is
+		<constant>no</constant>, calls to the <command moreinfo="none">getpwent</command> system call
+		will not return any data. </para>
+
+		<para><emphasis>Warning:</emphasis> Turning off user
+		enumeration may cause some programs to behave oddly.  For
+		example, the finger program relies on having access to the
+		full user list when searching for matching
+		usernames. </para>
+
+		<para>Default: <command moreinfo="none">winbind enum users = yes </command></para>
+		</listitem>
+		</samba:parameter>
diff --git a/docs/docbook/smbdotconf/winbind/winbindgid.xml b/docs/docbook/smbdotconf/winbind/winbindgid.xml
new file mode 100644
index 0000000000..a8a9683b01
--- /dev/null
+++ b/docs/docbook/smbdotconf/winbind/winbindgid.xml
@@ -0,0 +1,14 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+		<term><anchor id="WINBINDGID"/>winbind gid (G)</term>
+		<listitem><para>The winbind gid parameter specifies the range of group 
+		ids that are allocated by the <citerefentry><refentrytitle>winbindd</refentrytitle>
+		<manvolnum>8</manvolnum></citerefentry> daemon.  This range of group ids should have no 
+		existing local or NIS groups within it as strange conflicts can 
+		occur otherwise.</para>
+
+		<para>Default: <command moreinfo="none">winbind gid = &lt;empty string&gt;
+		</command></para>
+
+		<para>Example: <command moreinfo="none">winbind gid = 10000-20000</command></para>
+		</listitem>
+		</samba:parameter>
diff --git a/docs/docbook/smbdotconf/winbind/winbindseparator.xml b/docs/docbook/smbdotconf/winbind/winbindseparator.xml
new file mode 100644
index 0000000000..416adcb531
--- /dev/null
+++ b/docs/docbook/smbdotconf/winbind/winbindseparator.xml
@@ -0,0 +1,17 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+		<term><anchor id="WINBINDSEPARATOR"/>winbind separator (G)</term>
+		<listitem><para>This parameter allows an admin to define the character 
+		used when listing a username of the form of <replaceable>DOMAIN
+		</replaceable>\<replaceable>user</replaceable>.  This parameter 
+		is only applicable when using the <filename moreinfo="none">pam_winbind.so</filename>
+		and <filename moreinfo="none">nss_winbind.so</filename> modules for UNIX services.
+		</para>
+
+		<para>Please note that setting this parameter to + causes problems
+		with group membership at least on glibc systems, as the character +
+		is used as a special character for NIS in /etc/group.</para>
+
+		<para>Default: <command moreinfo="none">winbind separator = '\'</command></para>
+		<para>Example: <command moreinfo="none">winbind separator = +</command></para>
+		</listitem>
+		</samba:parameter>
diff --git a/docs/docbook/smbdotconf/winbind/winbinduid.xml b/docs/docbook/smbdotconf/winbind/winbinduid.xml
new file mode 100644
index 0000000000..ecd7848f61
--- /dev/null
+++ b/docs/docbook/smbdotconf/winbind/winbinduid.xml
@@ -0,0 +1,14 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+		<term><anchor id="WINBINDUID"/>winbind uid (G)</term>
+		<listitem><para>The winbind gid parameter specifies the range of group 
+		ids that are allocated by the <citerefentry><refentrytitle>winbindd</refentrytitle>
+		<manvolnum>8</manvolnum></citerefentry> daemon.  This range of ids should have no 
+		existing local or NIS users within it as strange conflicts can 
+		occur otherwise.</para>
+
+		<para>Default: <command moreinfo="none">winbind uid = &lt;empty string&gt;
+		</command></para>
+		
+		<para>Example: <command moreinfo="none">winbind uid = 10000-20000</command></para>
+		</listitem>
+		</samba:parameter>
diff --git a/docs/docbook/smbdotconf/winbind/winbindusedefaultdomain.xml b/docs/docbook/smbdotconf/winbind/winbindusedefaultdomain.xml
new file mode 100644
index 0000000000..a6b7bcd7e5
--- /dev/null
+++ b/docs/docbook/smbdotconf/winbind/winbindusedefaultdomain.xml
@@ -0,0 +1,14 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+		<term><anchor id="WINBINDUSEDEFAULTDOMAIN"/>winbind use default domain (G)</term>
+		<listitem><para>This parameter specifies whether the <citerefentry><refentrytitle>winbindd</refentrytitle>
+		<manvolnum>8</manvolnum></citerefentry> daemon should operate on users 
+		without domain component in their username.  
+                Users without a domain component are treated as is part of the winbindd server's 
+                own domain.  While this does not benifit Windows users, it makes SSH, FTP and e-mail 
+                function in a way much closer to the way they would in a native unix system.</para>
+		
+		<para>Default: <command moreinfo="none">winbind use default domain = &lt;no&gt; 
+		</command></para>
+		<para>Example: <command moreinfo="none">winbind use default domain = yes</command></para>
+		</listitem>
+		</samba:parameter>