summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf
diff options
context:
space:
mode:
Diffstat (limited to 'docs/docbook/smbdotconf')
-rw-r--r--docs/docbook/smbdotconf/.cvsignore4
-rw-r--r--docs/docbook/smbdotconf/expand-smb.conf.xsl74
-rw-r--r--docs/docbook/smbdotconf/man.xsl159
-rwxr-xr-xdocs/docbook/smbdotconf/process-all.sh15
-rw-r--r--docs/docbook/smbdotconf/security/passdbbackend.xml119
-rw-r--r--docs/docbook/smbdotconf/security/restrictanonymous.xml12
6 files changed, 0 insertions, 383 deletions
diff --git a/docs/docbook/smbdotconf/.cvsignore b/docs/docbook/smbdotconf/.cvsignore
deleted file mode 100644
index 0f8c6cb0ed..0000000000
--- a/docs/docbook/smbdotconf/.cvsignore
+++ /dev/null
@@ -1,4 +0,0 @@
-parameters.all.xml
-parameters.global.xml
-parameters.service.xml
-
diff --git a/docs/docbook/smbdotconf/expand-smb.conf.xsl b/docs/docbook/smbdotconf/expand-smb.conf.xsl
deleted file mode 100644
index 87b4898cf7..0000000000
--- a/docs/docbook/smbdotconf/expand-smb.conf.xsl
+++ /dev/null
@@ -1,74 +0,0 @@
-<?xml version='1.0'?>
-<!-- vim:set sts=2 shiftwidth=2 syntax=xml: -->
-<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
- xmlns:exsl="http://exslt.org/common"
- xmlns:samba="http://samba.org/common"
- version="1.1"
- extension-element-prefixes="exsl">
-
-<xsl:output method="xml"/>
-
-<!-- Generates one big XML file for smb.conf -->
-
-<xsl:param name="xmlSambaNsUri" select="'http://samba.org/common'"/>
-
-<!-- This is needed to copy content unchanged -->
-<xsl:template match="@*|node()">
- <xsl:copy>
- <xsl:apply-templates select="@*|node()"/>
- </xsl:copy>
-</xsl:template>
-
-
-<xsl:template match="//samba:parameter">
- <!-- reconstruct varlistentry - not all of them will go into separate files
- and also we must repair the main varlistentry itself.
- -->
- <xsl:message>
- <xsl:text>Processing samba:parameter (</xsl:text>
- <xsl:value-of select="@name"/>
- <xsl:text>)</xsl:text>
- </xsl:message>
-
- <xsl:variable name="name"><xsl:value-of select="translate(translate(string(@name),' ',''),
- 'abcdefghijklmnopqrstuvwxyz','ABCDEFGHIJKLMNOPQRSTUVWXYZ')"/>
- </xsl:variable>
-
- <xsl:variable name="anchor">
- <xsl:element name="anchor">
- <xsl:attribute name="id">
- <xsl:value-of select="$name"/>
- </xsl:attribute>
- </xsl:element>
- </xsl:variable>
-
- <xsl:variable name="context">
- <xsl:text> (</xsl:text>
- <xsl:value-of select="@context"/>
- <xsl:text>)</xsl:text>
- </xsl:variable>
-
- <xsl:variable name="term">
- <xsl:element name="term">
- <xsl:copy-of select="$anchor"/>
- <xsl:value-of select="@name"/>
- <xsl:value-of select="$context"/>
- </xsl:element>
- </xsl:variable>
-
- <xsl:variable name="content">
- <xsl:apply-templates/>
- </xsl:variable>
-
- <xsl:element name="varlistentry">
- <xsl:text>
-</xsl:text>
- <xsl:copy-of select="$term"/>
- <xsl:copy-of select="$content"/>
- <xsl:text>
-</xsl:text>
- </xsl:element>
-
-</xsl:template>
-
-</xsl:stylesheet>
diff --git a/docs/docbook/smbdotconf/man.xsl b/docs/docbook/smbdotconf/man.xsl
deleted file mode 100644
index a7ae76bbd8..0000000000
--- a/docs/docbook/smbdotconf/man.xsl
+++ /dev/null
@@ -1,159 +0,0 @@
-<?xml version='1.0'?>
-<!-- vim:set sts=2 shiftwidth=2 syntax=xml: -->
-<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
- version='1.0'>
-
-<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl"/>
-
-<xsl:param name="chunk.section.depth" select="0"/>
-<xsl:param name="chunk.first.sections" select="1"/>
-<xsl:param name="use.id.as.filename" select="1"/>
-<xsl:param name="base.dir" select="'../../manpages/'"/>
-
-<!--
- Our ulink stylesheet omits @url part if content was specified
--->
-<xsl:template match="ulink">
- <xsl:variable name="content">
- <xsl:apply-templates/>
- </xsl:variable>
- <xsl:if test="$content = ''">
- <xsl:text>: </xsl:text>
- </xsl:if>
- <xsl:if test="$content != ''">
- <xsl:value-of select="$content" />
- </xsl:if>
- <xsl:if test="$content = ''">
- <xsl:apply-templates mode="italic" select="@url" />
- </xsl:if>
-</xsl:template>
-
-<xsl:template match="refentry">
-
- <xsl:variable name="section" select="refmeta/manvolnum"/>
- <xsl:variable name="name" select="refnamediv/refname[1]"/>
- <xsl:variable name="base.dir" select="$base.dir"/>
- <!-- standard man page width is 64 chars; 6 chars needed for the two
- (x) volume numbers, and 2 spaces, leaves 56 -->
- <xsl:variable name="twidth" select="(74 - string-length(refmeta/refentrytitle)) div 2"/>
-
- <xsl:variable name="reftitle"
- select="substring(refmeta/refentrytitle, 1, $twidth)"/>
-
- <xsl:variable name="title">
- <xsl:choose>
- <xsl:when test="refentryinfo/title">
- <xsl:value-of select="refentryinfo/title"/>
- </xsl:when>
- <xsl:when test="../referenceinfo/title">
- <xsl:value-of select="../referenceinfo/title"/>
- </xsl:when>
- </xsl:choose>
- </xsl:variable>
-
- <xsl:variable name="date">
- <xsl:choose>
- <xsl:when test="refentryinfo/date">
- <xsl:value-of select="refentryinfo/date"/>
- </xsl:when>
- <xsl:when test="../referenceinfo/date">
- <xsl:value-of select="../referenceinfo/date"/>
- </xsl:when>
- </xsl:choose>
- </xsl:variable>
-
- <xsl:variable name="productname">
- <xsl:choose>
- <xsl:when test="refentryinfo/productname">
- <xsl:value-of select="refentryinfo/productname"/>
- </xsl:when>
- <xsl:when test="../referenceinfo/productname">
- <xsl:value-of select="../referenceinfo/productname"/>
- </xsl:when>
- </xsl:choose>
- </xsl:variable>
-
- <xsl:call-template name="write.text.chunk">
- <xsl:with-param name="filename"
- select="concat($base.dir, normalize-space ($name), '.', $section)"/>
- <xsl:with-param name="content">
- <xsl:text>.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "</xsl:text>
- <xsl:value-of select="translate($reftitle,'abcdefghijklmnopqrstuvwxyz', 'ABCDEFGHIJKLMNOPQRSTUVWXYZ')"/>
- <xsl:text>" </xsl:text>
- <xsl:value-of select="refmeta/manvolnum[1]"/>
- <xsl:text> "</xsl:text>
- <xsl:value-of select="normalize-space($date)"/>
- <xsl:text>" "</xsl:text>
- <xsl:value-of select="normalize-space($productname)"/>
- <xsl:text>" "</xsl:text>
- <xsl:value-of select="$title"/>
- <xsl:text>"
-</xsl:text>
- <xsl:apply-templates/>
- <xsl:text>&#10;</xsl:text>
-
- <!-- Author section -->
- <xsl:choose>
- <xsl:when test="refentryinfo//author">
- <xsl:apply-templates select="refentryinfo" mode="authorsect"/>
- </xsl:when>
- </xsl:choose>
- </xsl:with-param>
- </xsl:call-template>
-</xsl:template>
-
-<xsl:template match="informalexample|screen|programlisting">
- <xsl:text>.nf&#10;</xsl:text>
- <xsl:apply-templates/>
- <xsl:text>.fi&#10;</xsl:text>
-</xsl:template>
-
-<xsl:template match="//emphasis">
- <xsl:text>\fB</xsl:text>
- <xsl:apply-templates/>
- <xsl:text>\fR</xsl:text>
-</xsl:template>
-
-<xsl:template match="para|simpara|remark" mode="list">
- <xsl:variable name="foo">
- <xsl:apply-templates/>
- </xsl:variable>
- <xsl:choose match="node()">
- <!-- Don't normalize-space() for verbatim paragraphs -->
- <xsl:when test="informalexample|screen|programlisting">
- <xsl:value-of select="$foo"/>
- </xsl:when>
- <xsl:otherwise>
- <xsl:value-of select="normalize-space($foo)"/>
- <xsl:text>&#10;</xsl:text>
- </xsl:otherwise>
- </xsl:choose>
- <xsl:text>&#10;</xsl:text>
- <xsl:if test="following-sibling::para or following-sibling::simpara or
- following-sibling::remark">
- <!-- Make sure multiple paragraphs within a list item don't -->
- <!-- merge together. -->
- <xsl:text>&#10;</xsl:text>
- </xsl:if>
-</xsl:template>
-
-</xsl:stylesheet>
diff --git a/docs/docbook/smbdotconf/process-all.sh b/docs/docbook/smbdotconf/process-all.sh
deleted file mode 100755
index 6d8c9941b4..0000000000
--- a/docs/docbook/smbdotconf/process-all.sh
+++ /dev/null
@@ -1,15 +0,0 @@
-#!/bin/sh
-sh generate-file-list.sh >parameters.all.xml
-
-xsltproc --xinclude \
- --param smb.context "'G'" \
- --output parameters.global.xml \
- generate-context.xsl parameters.all.xml
-
-xsltproc --xinclude \
- --param smb.context "'S'" \
- --output parameters.service.xml \
- generate-context.xsl parameters.all.xml
-
-xsltproc --xinclude expand-smb.conf.xsl smb.conf.5.xml | \
-xsltproc http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl -
diff --git a/docs/docbook/smbdotconf/security/passdbbackend.xml b/docs/docbook/smbdotconf/security/passdbbackend.xml
deleted file mode 100644
index 256b6c9709..0000000000
--- a/docs/docbook/smbdotconf/security/passdbbackend.xml
+++ /dev/null
@@ -1,119 +0,0 @@
-<samba:parameter name="passdb backend"
- context="G"
- advanced="1" developer="1"
- xmlns:samba="http://samba.org/common">
-<listitem>
-
- <para>This option allows the administrator to chose which backends
- to retrieve and store passwords with. This allows (for example) both
- smbpasswd and tdbsam to be used without a recompile. Multiple
- backends can be specified, separated by spaces. The backends will be
- searched in the order they are specified. New users are always added
- to the first backend specified. Experimental backends must still be
- selected (eg --with-tdbsam) at configure time. </para>
-
- <para>This parameter is in two parts, the backend's name, and a 'location'
- string that has meaning only to that particular backed. These are separated
- by a : character.</para>
-
- <para>Available backends can include:
- <itemizedlist>
- <listitem>
- <para><command moreinfo="none">smbpasswd</command> - The default smbpasswd
- backend. Takes a path to the smbpasswd file as an optional argument.
- </para>
- </listitem>
-
- <listitem>
- <para><command moreinfo="none">smbpasswd_nua</command> - The smbpasswd
- backend, but with support for 'not unix accounts'.
- Takes a path to the smbpasswd file as an optional argument.</para>
-
- <para>See also <link linkend="NONUNIXACCOUNTRANGE">
- <parameter moreinfo="none">non unix account range</parameter></link></para>
- </listitem>
-
- <listitem>
- <para><command moreinfo="none">tdbsam</command> - The TDB based password storage
- backend. Takes a path to the TDB as an optional argument (defaults to passdb.tdb
- in the <link linkend="PRIVATEDIR">
- <parameter moreinfo="none">private dir</parameter></link> directory.</para>
- </listitem>
-
- <listitem>
- <para><command moreinfo="none">tdbsam_nua</command> - The TDB based password storage
- backend, with non unix account support. Takes a path to the TDB as an optional argument (defaults to passdb.tdb
- in the <link linkend="PRIVATEDIR">
- <parameter moreinfo="none">private dir</parameter></link> directory.</para>
-
- <para>See also <link linkend="NONUNIXACCOUNTRANGE">
- <parameter moreinfo="none">non unix account range</parameter></link></para>
- </listitem>
-
- <listitem>
- <para><command moreinfo="none">ldapsam</command> - The LDAP based passdb
- backend. Takes an LDAP URL as an optional argument (defaults to
- <command moreinfo="none">ldap://localhost</command>)</para>
- </listitem>
-
- <listitem>
- <para><command moreinfo="none">ldapsam_nua</command> - The LDAP based passdb
- backend, with non unix account support. Takes an LDAP URL as an optional argument (defaults to
- <command moreinfo="none">ldap://localhost</command>)</para>
-
- <para>Note: In this module, any account without a matching POSIX account is regarded
- as 'non unix'. </para>
-
- <para>See also <link linkend="NONUNIXACCOUNTRANGE">
- <parameter moreinfo="none">non unix account range</parameter></link></para>
-
- <para>LDAP connections should be secured where possible. This may be done using either
- Start-TLS (see <link linkend="LDAPSSL"><parameter moreinfo="none">ldap ssl</parameter></link>) or by
- specifying <parameter moreinfo="none">ldaps://</parameter> in
- the URL argument. </para>
- </listitem>
-
- <listitem>
- <para><command moreinfo="none">nisplussam</command> -
- The NIS+ based passdb backend. Takes name NIS domain as
- an optional argument. Only works with sun NIS+ servers.
- </para>
- </listitem>
-
- <listitem>
- <para><command moreinfo="none">plugin</command> - Allows Samba to load an
- arbitary passdb backend from the .so specified as a compulsary argument.
- </para>
-
- <para>Any characters after the (optional) second : are passed to the plugin
- for its own processing</para>
- </listitem>
-
- <listitem>
- <para><command moreinfo="none">unixsam</command> - Allows samba to map all (other)
- available unix users</para>
-
- <para>This backend uses the standard unix database for retrieving users. Users included
- in this pdb are NOT listed in samba user listings and users included in this pdb won't be
- able to login. The use of this backend is to always be able to display the owner of a file
- on the samba server - even when the user doesn't have a 'real' samba account in one of the
- other passdb backends.
- </para>
-
- <para>This backend should always be the last backend listed, since it contains all users in
- the unix passdb and might 'override' mappings if specified earlier. It's meant to only return
- accounts for users that aren't covered by the previous backends.
- </para>
- </listitem>
- </itemizedlist>
- </para>
-
- <para>Default: <command moreinfo="none">passdb backend = smbpasswd unixsam</command></para>
-
- <para>Example: <command moreinfo="none">passdb backend = tdbsam:/etc/samba/private/passdb.tdb smbpasswd:/etc/samba/smbpasswd unixsam</command></para>
-
- <para>Example: <command moreinfo="none">passdb backend = ldapsam_nua:ldaps://ldap.example.com unixsam</command></para>
-
- <para>Example: <command moreinfo="none">passdb backend = plugin:/usr/local/samba/lib/my_passdb.so:my_plugin_args tdbsam:/etc/samba/private/passdb.tdb</command></para>
-</listitem>
-</samba:parameter>
diff --git a/docs/docbook/smbdotconf/security/restrictanonymous.xml b/docs/docbook/smbdotconf/security/restrictanonymous.xml
deleted file mode 100644
index 7f78f94a99..0000000000
--- a/docs/docbook/smbdotconf/security/restrictanonymous.xml
+++ /dev/null
@@ -1,12 +0,0 @@
-<samba:parameter name="restrict anonymous"
- context="G"
- advanced="1" developer="1"
- xmlns:samba="http://samba.org/common">
-<listitem>
- <para>This is a integer parameter, and mirrors as much as possible the functinality the
- <constant>RestrictAnonymous</constant> registry key does on NT/Win2k.
- </para>
-
- <para>Default: <command moreinfo="none">restrict anonymous = 0</command></para>
-</listitem>
-</samba:parameter>