summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/misc
diff options
context:
space:
mode:
Diffstat (limited to 'docs/docbook/smbdotconf/misc')
-rw-r--r--docs/docbook/smbdotconf/misc/addsharecommand.xml51
-rw-r--r--docs/docbook/smbdotconf/misc/autoservices.xml6
-rw-r--r--docs/docbook/smbdotconf/misc/available.xml11
-rw-r--r--docs/docbook/smbdotconf/misc/changesharecommand.xml50
-rw-r--r--docs/docbook/smbdotconf/misc/configfile.xml21
-rw-r--r--docs/docbook/smbdotconf/misc/copy.xml15
-rw-r--r--docs/docbook/smbdotconf/misc/default.xml5
-rw-r--r--docs/docbook/smbdotconf/misc/defaultservice.xml36
-rw-r--r--docs/docbook/smbdotconf/misc/deletereadonly.xml11
-rw-r--r--docs/docbook/smbdotconf/misc/deletesharecommand.xml44
-rw-r--r--docs/docbook/smbdotconf/misc/dfreecommand.xml50
-rw-r--r--docs/docbook/smbdotconf/misc/dontdescend.xml18
-rw-r--r--docs/docbook/smbdotconf/misc/dosfilemode.xml16
-rw-r--r--docs/docbook/smbdotconf/misc/dosfiletimeresolution.xml23
-rw-r--r--docs/docbook/smbdotconf/misc/dosfiletimes.xml14
-rw-r--r--docs/docbook/smbdotconf/misc/exec.xml5
-rw-r--r--docs/docbook/smbdotconf/misc/fakedirectorycreatetimes.xml31
-rw-r--r--docs/docbook/smbdotconf/misc/followsymlinks.xml18
-rw-r--r--docs/docbook/smbdotconf/misc/fstype.xml14
-rw-r--r--docs/docbook/smbdotconf/misc/hidelocalusers.xml7
-rw-r--r--docs/docbook/smbdotconf/misc/homedirmap.xml28
-rw-r--r--docs/docbook/smbdotconf/misc/include.xml14
-rw-r--r--docs/docbook/smbdotconf/misc/lockdir.xml5
-rw-r--r--docs/docbook/smbdotconf/misc/lockdirectory.xml11
-rw-r--r--docs/docbook/smbdotconf/misc/magicoutput.xml17
-rw-r--r--docs/docbook/smbdotconf/misc/magicscript.xml28
-rw-r--r--docs/docbook/smbdotconf/misc/messagecommand.xml65
-rw-r--r--docs/docbook/smbdotconf/misc/nishomedir.xml30
-rw-r--r--docs/docbook/smbdotconf/misc/panicaction.xml12
-rw-r--r--docs/docbook/smbdotconf/misc/piddirectory.xml9
-rw-r--r--docs/docbook/smbdotconf/misc/postexec.xml22
-rw-r--r--docs/docbook/smbdotconf/misc/preexec.xml23
-rw-r--r--docs/docbook/smbdotconf/misc/preexecclose.xml9
-rw-r--r--docs/docbook/smbdotconf/misc/preload.xml16
-rw-r--r--docs/docbook/smbdotconf/misc/remoteannounce.xml32
-rw-r--r--docs/docbook/smbdotconf/misc/remotebrowsesync.xml33
-rw-r--r--docs/docbook/smbdotconf/misc/rootpostexec.xml14
-rw-r--r--docs/docbook/smbdotconf/misc/rootpreexec.xml15
-rw-r--r--docs/docbook/smbdotconf/misc/rootpreexecclose.xml12
-rw-r--r--docs/docbook/smbdotconf/misc/setdirectory.xml13
-rw-r--r--docs/docbook/smbdotconf/misc/socketaddress.xml14
-rw-r--r--docs/docbook/smbdotconf/misc/sourceenvironment.xml23
-rw-r--r--docs/docbook/smbdotconf/misc/timeoffset.xml11
-rw-r--r--docs/docbook/smbdotconf/misc/utmp.xml21
-rw-r--r--docs/docbook/smbdotconf/misc/utmpdirectory.xml16
-rw-r--r--docs/docbook/smbdotconf/misc/volume.xml9
-rw-r--r--docs/docbook/smbdotconf/misc/widelinks.xml15
-rw-r--r--docs/docbook/smbdotconf/misc/wtmpdirectory.xml20
48 files changed, 983 insertions, 0 deletions
diff --git a/docs/docbook/smbdotconf/misc/addsharecommand.xml b/docs/docbook/smbdotconf/misc/addsharecommand.xml
new file mode 100644
index 0000000000..233d3e7dc4
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/addsharecommand.xml
@@ -0,0 +1,51 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="ADDSHARECOMMAND"/>add share command (G)</term>
+ <listitem><para>Samba 2.2.0 introduced the ability to dynamically
+ add and delete shares via the Windows NT 4.0 Server Manager. The
+ <parameter moreinfo="none">add share command</parameter> is used to define an
+ external program or script which will add a new service definition
+ to <filename moreinfo="none">smb.conf</filename>. In order to successfully
+ execute the <parameter moreinfo="none">add share command</parameter>, <command moreinfo="none">smbd</command>
+ requires that the administrator be connected using a root account (i.e.
+ uid == 0).
+ </para>
+
+ <para>
+ When executed, <command moreinfo="none">smbd</command> will automatically invoke the
+ <parameter moreinfo="none">add share command</parameter> with four parameters.
+ </para>
+
+ <itemizedlist>
+ <listitem><para><parameter moreinfo="none">configFile</parameter> - the location
+ of the global <filename moreinfo="none">smb.conf</filename> file.
+ </para></listitem>
+
+ <listitem><para><parameter moreinfo="none">shareName</parameter> - the name of the new
+ share.
+ </para></listitem>
+
+ <listitem><para><parameter moreinfo="none">pathName</parameter> - path to an **existing**
+ directory on disk.
+ </para></listitem>
+
+ <listitem><para><parameter moreinfo="none">comment</parameter> - comment string to associate
+ with the new share.
+ </para></listitem>
+ </itemizedlist>
+
+ <para>
+ This parameter is only used for add file shares. To add printer shares,
+ see the <link linkend="ADDPRINTERCOMMAND"><parameter moreinfo="none">addprinter
+ command</parameter></link>.
+ </para>
+
+ <para>
+ See also <link linkend="CHANGESHARECOMMAND"><parameter moreinfo="none">change share
+ command</parameter></link>, <link linkend="DELETESHARECOMMAND"><parameter moreinfo="none">delete share
+ command</parameter></link>.
+ </para>
+
+ <para>Default: <emphasis>none</emphasis></para>
+ <para>Example: <command moreinfo="none">add share command = /usr/local/bin/addshare</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/autoservices.xml b/docs/docbook/smbdotconf/misc/autoservices.xml
new file mode 100644
index 0000000000..d137f650f8
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/autoservices.xml
@@ -0,0 +1,6 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="AUTOSERVICES"/>auto services (G)</term>
+ <listitem><para>This is a synonym for the <link linkend="PRELOAD">
+ <parameter moreinfo="none">preload</parameter></link>.</para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/available.xml b/docs/docbook/smbdotconf/misc/available.xml
new file mode 100644
index 0000000000..025c1c06fb
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/available.xml
@@ -0,0 +1,11 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="AVAILABLE"/>available (S)</term>
+ <listitem><para>This parameter lets you &quot;turn off&quot; a service. If
+ <parameter moreinfo="none">available = no</parameter>, then <emphasis>ALL</emphasis>
+ attempts to connect to the service will fail. Such failures are
+ logged.</para>
+
+ <para>Default: <command moreinfo="none">available = yes</command></para>
+
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/changesharecommand.xml b/docs/docbook/smbdotconf/misc/changesharecommand.xml
new file mode 100644
index 0000000000..3fb494c513
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/changesharecommand.xml
@@ -0,0 +1,50 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="CHANGESHARECOMMAND"/>change share command (G)</term>
+ <listitem><para>Samba 2.2.0 introduced the ability to dynamically
+ add and delete shares via the Windows NT 4.0 Server Manager. The
+ <parameter moreinfo="none">change share command</parameter> is used to define an
+ external program or script which will modify an existing service definition
+ in <filename moreinfo="none">smb.conf</filename>. In order to successfully
+ execute the <parameter moreinfo="none">change share command</parameter>, <command moreinfo="none">smbd</command>
+ requires that the administrator be connected using a root account (i.e.
+ uid == 0).
+ </para>
+
+ <para>
+ When executed, <command moreinfo="none">smbd</command> will automatically invoke the
+ <parameter moreinfo="none">change share command</parameter> with four parameters.
+ </para>
+
+ <itemizedlist>
+ <listitem><para><parameter moreinfo="none">configFile</parameter> - the location
+ of the global <filename moreinfo="none">smb.conf</filename> file.
+ </para></listitem>
+
+ <listitem><para><parameter moreinfo="none">shareName</parameter> - the name of the new
+ share.
+ </para></listitem>
+
+ <listitem><para><parameter moreinfo="none">pathName</parameter> - path to an **existing**
+ directory on disk.
+ </para></listitem>
+
+ <listitem><para><parameter moreinfo="none">comment</parameter> - comment string to associate
+ with the new share.
+ </para></listitem>
+ </itemizedlist>
+
+ <para>
+ This parameter is only used modify existing file shares definitions. To modify
+ printer shares, use the &quot;Printers...&quot; folder as seen when browsing the Samba host.
+ </para>
+
+ <para>
+ See also <link linkend="ADDSHARECOMMAND"><parameter moreinfo="none">add share
+ command</parameter></link>, <link linkend="DELETESHARECOMMAND"><parameter moreinfo="none">delete
+ share command</parameter></link>.
+ </para>
+
+ <para>Default: <emphasis>none</emphasis></para>
+ <para>Example: <command moreinfo="none">change share command = /usr/local/bin/addshare</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/configfile.xml b/docs/docbook/smbdotconf/misc/configfile.xml
new file mode 100644
index 0000000000..3edf611b55
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/configfile.xml
@@ -0,0 +1,21 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="CONFIGFILE"/>config file (G)</term>
+ <listitem><para>This allows you to override the config file
+ to use, instead of the default (usually <filename moreinfo="none">smb.conf</filename>).
+ There is a chicken and egg problem here as this option is set
+ in the config file!</para>
+
+ <para>For this reason, if the name of the config file has changed
+ when the parameters are loaded then it will reload them from
+ the new config file.</para>
+
+ <para>This option takes the usual substitutions, which can
+ be very useful.</para>
+
+ <para>If the config file doesn't exist then it won't be loaded
+ (allowing you to special case the config files of just a few
+ clients).</para>
+
+ <para>Example: <command moreinfo="none">config file = /usr/local/samba/lib/smb.conf.%m
+ </command></para></listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/copy.xml b/docs/docbook/smbdotconf/misc/copy.xml
new file mode 100644
index 0000000000..a7945af8ae
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/copy.xml
@@ -0,0 +1,15 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="COPY"/>copy (S)</term>
+ <listitem><para>This parameter allows you to &quot;clone&quot; service
+ entries. The specified service is simply duplicated under the
+ current service's name. Any parameters specified in the current
+ section will override those in the section being copied.</para>
+
+ <para>This feature lets you set up a 'template' service and
+ create similar services easily. Note that the service being
+ copied must occur earlier in the configuration file than the
+ service doing the copying.</para>
+
+ <para>Default: <emphasis>no value</emphasis></para>
+ <para>Example: <command moreinfo="none">copy = otherservice</command></para></listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/default.xml b/docs/docbook/smbdotconf/misc/default.xml
new file mode 100644
index 0000000000..c396d1947b
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/default.xml
@@ -0,0 +1,5 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="DEFAULT"/>default (G)</term>
+ <listitem><para>A synonym for <link linkend="DEFAULTSERVICE"><parameter moreinfo="none">
+ default service</parameter></link>.</para></listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/defaultservice.xml b/docs/docbook/smbdotconf/misc/defaultservice.xml
new file mode 100644
index 0000000000..7aeedb177a
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/defaultservice.xml
@@ -0,0 +1,36 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="DEFAULTSERVICE"/>default service (G)</term>
+ <listitem><para>This parameter specifies the name of a service
+ which will be connected to if the service actually requested cannot
+ be found. Note that the square brackets are <emphasis>NOT</emphasis>
+ given in the parameter value (see example below).</para>
+
+ <para>There is no default value for this parameter. If this
+ parameter is not given, attempting to connect to a nonexistent
+ service results in an error.</para>
+
+ <para>Typically the default service would be a <link linkend="GUESTOK">
+ <parameter moreinfo="none">guest ok</parameter></link>, <link linkend="READONLY">
+ <parameter moreinfo="none">read-only</parameter></link> service.</para>
+
+ <para>Also note that the apparent service name will be changed
+ to equal that of the requested service, this is very useful as it
+ allows you to use macros like <parameter moreinfo="none">%S</parameter> to make
+ a wildcard service.</para>
+
+ <para>Note also that any &quot;_&quot; characters in the name of the service
+ used in the default service will get mapped to a &quot;/&quot;. This allows for
+ interesting things.</para>
+
+
+ <para>Example:</para>
+
+<para><programlisting format="linespecific">
+[global]
+ default service = pub
+
+[pub]
+ path = /%S
+</programlisting></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/deletereadonly.xml b/docs/docbook/smbdotconf/misc/deletereadonly.xml
new file mode 100644
index 0000000000..8e86b5b00b
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/deletereadonly.xml
@@ -0,0 +1,11 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="DELETEREADONLY"/>delete readonly (S)</term>
+ <listitem><para>This parameter allows readonly files to be deleted.
+ This is not normal DOS semantics, but is allowed by UNIX.</para>
+
+ <para>This option may be useful for running applications such
+ as rcs, where UNIX file ownership prevents changing file
+ permissions, and DOS semantics prevent deletion of a read only file.</para>
+
+ <para>Default: <command moreinfo="none">delete readonly = no</command></para></listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/deletesharecommand.xml b/docs/docbook/smbdotconf/misc/deletesharecommand.xml
new file mode 100644
index 0000000000..c3481c86ec
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/deletesharecommand.xml
@@ -0,0 +1,44 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="DELETESHARECOMMAND"/>delete share command (G)</term>
+ <listitem><para>Samba 2.2.0 introduced the ability to dynamically
+ add and delete shares via the Windows NT 4.0 Server Manager. The
+ <parameter moreinfo="none">delete share command</parameter> is used to define an
+ external program or script which will remove an existing service
+ definition from <filename moreinfo="none">smb.conf</filename>. In order to successfully
+ execute the <parameter moreinfo="none">delete share command</parameter>, <command moreinfo="none">smbd</command>
+ requires that the administrator be connected using a root account (i.e.
+ uid == 0).
+ </para>
+
+ <para>
+ When executed, <command moreinfo="none">smbd</command> will automatically invoke the
+ <parameter moreinfo="none">delete share command</parameter> with two parameters.
+ </para>
+
+ <itemizedlist>
+ <listitem><para><parameter moreinfo="none">configFile</parameter> - the location
+ of the global <filename moreinfo="none">smb.conf</filename> file.
+ </para></listitem>
+
+ <listitem><para><parameter moreinfo="none">shareName</parameter> - the name of
+ the existing service.
+ </para></listitem>
+ </itemizedlist>
+
+ <para>
+ This parameter is only used to remove file shares. To delete printer shares,
+ see the <link linkend="DELETEPRINTERCOMMAND"><parameter moreinfo="none">deleteprinter
+ command</parameter></link>.
+ </para>
+
+ <para>
+ See also <link linkend="ADDSHARECOMMAND"><parameter moreinfo="none">add share
+ command</parameter></link>, <link linkend="CHANGESHARECOMMAND"><parameter moreinfo="none">change
+ share command</parameter></link>.
+ </para>
+
+ <para>Default: <emphasis>none</emphasis></para>
+ <para>Example: <command moreinfo="none">delete share command = /usr/local/bin/delshare</command></para>
+
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/dfreecommand.xml b/docs/docbook/smbdotconf/misc/dfreecommand.xml
new file mode 100644
index 0000000000..c71ec8e00b
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/dfreecommand.xml
@@ -0,0 +1,50 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="DFREECOMMAND"/>dfree command (G)</term>
+ <listitem><para>The <parameter moreinfo="none">dfree command</parameter> setting should
+ only be used on systems where a problem occurs with the internal
+ disk space calculations. This has been known to happen with Ultrix,
+ but may occur with other operating systems. The symptom that was
+ seen was an error of &quot;Abort Retry Ignore&quot; at the end of each
+ directory listing.</para>
+
+ <para>This setting allows the replacement of the internal routines to
+ calculate the total disk space and amount available with an external
+ routine. The example below gives a possible script that might fulfill
+ this function.</para>
+
+ <para>The external program will be passed a single parameter indicating
+ a directory in the filesystem being queried. This will typically consist
+ of the string <filename moreinfo="none">./</filename>. The script should return two
+ integers in ASCII. The first should be the total disk space in blocks,
+ and the second should be the number of available blocks. An optional
+ third return value can give the block size in bytes. The default
+ blocksize is 1024 bytes.</para>
+
+ <para>Note: Your script should <emphasis>NOT</emphasis> be setuid or
+ setgid and should be owned by (and writeable only by) root!</para>
+
+ <para>Default: <emphasis>By default internal routines for
+ determining the disk capacity and remaining space will be used.
+ </emphasis></para>
+
+ <para>Example: <command moreinfo="none">dfree command = /usr/local/samba/bin/dfree
+ </command></para>
+
+ <para>Where the script dfree (which must be made executable) could be:</para>
+
+<para><programlisting format="linespecific">
+#!/bin/sh
+df $1 | tail -1 | awk '{print $2&quot; &quot;$4}'
+</programlisting></para>
+
+ <para>or perhaps (on Sys V based systems):</para>
+
+<para><programlisting format="linespecific">
+#!/bin/sh
+/usr/bin/df -k $1 | tail -1 | awk '{print $3&quot; &quot;$5}'
+</programlisting></para>
+
+ <para>Note that you may have to replace the command names
+ with full path names on some systems.</para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/dontdescend.xml b/docs/docbook/smbdotconf/misc/dontdescend.xml
new file mode 100644
index 0000000000..8136f293df
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/dontdescend.xml
@@ -0,0 +1,18 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="DONTDESCEND"/>dont descend (S)</term>
+ <listitem><para>There are certain directories on some systems
+ (e.g., the <filename moreinfo="none">/proc</filename> tree under Linux) that are either not
+ of interest to clients or are infinitely deep (recursive). This
+ parameter allows you to specify a comma-delimited list of directories
+ that the server should always show as empty.</para>
+
+ <para>Note that Samba can be very fussy about the exact format
+ of the &quot;dont descend&quot; entries. For example you may need <filename moreinfo="none">
+ ./proc</filename> instead of just <filename moreinfo="none">/proc</filename>.
+ Experimentation is the best policy :-) </para>
+
+ <para>Default: <emphasis>none (i.e., all directories are OK
+ to descend)</emphasis></para>
+ <para>Example: <command moreinfo="none">dont descend = /proc,/dev</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/dosfilemode.xml b/docs/docbook/smbdotconf/misc/dosfilemode.xml
new file mode 100644
index 0000000000..e8aec3b78d
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/dosfilemode.xml
@@ -0,0 +1,16 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="DOSFILEMODE"/>dos filemode (S)</term>
+ <listitem><para> The default behavior in Samba is to provide
+ UNIX-like behavior where only the owner of a file/directory is
+ able to change the permissions on it. However, this behavior
+ is often confusing to DOS/Windows users. Enabling this parameter
+ allows a user who has write access to the file (by whatever
+ means) to modify the permissions on it. Note that a user
+ belonging to the group owning the file will not be allowed to
+ change permissions if the group is only granted read access.
+ Ownership of the file/directory is not changed, only the permissions
+ are modified.</para>
+
+ <para>Default: <command moreinfo="none">dos filemode = no</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/dosfiletimeresolution.xml b/docs/docbook/smbdotconf/misc/dosfiletimeresolution.xml
new file mode 100644
index 0000000000..bc82582c87
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/dosfiletimeresolution.xml
@@ -0,0 +1,23 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="DOSFILETIMERESOLUTION"/>dos filetime resolution (S)</term>
+ <listitem><para>Under the DOS and Windows FAT filesystem, the finest
+ granularity on time resolution is two seconds. Setting this parameter
+ for a share causes Samba to round the reported time down to the
+ nearest two second boundary when a query call that requires one second
+ resolution is made to <citerefentry><refentrytitle>smbd</refentrytitle>
+ <manvolnum>8</manvolnum></citerefentry>.</para>
+
+ <para>This option is mainly used as a compatibility option for Visual
+ C++ when used against Samba shares. If oplocks are enabled on a
+ share, Visual C++ uses two different time reading calls to check if a
+ file has changed since it was last read. One of these calls uses a
+ one-second granularity, the other uses a two second granularity. As
+ the two second call rounds any odd second down, then if the file has a
+ timestamp of an odd number of seconds then the two timestamps will not
+ match and Visual C++ will keep reporting the file has changed. Setting
+ this option causes the two timestamps to match, and Visual C++ is
+ happy.</para>
+
+ <para>Default: <command moreinfo="none">dos filetime resolution = no</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/dosfiletimes.xml b/docs/docbook/smbdotconf/misc/dosfiletimes.xml
new file mode 100644
index 0000000000..d9b9f3b08b
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/dosfiletimes.xml
@@ -0,0 +1,14 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="DOSFILETIMES"/>dos filetimes (S)</term>
+ <listitem><para>Under DOS and Windows, if a user can write to a
+ file they can change the timestamp on it. Under POSIX semantics,
+ only the owner of the file or root may change the timestamp. By
+ default, Samba runs with POSIX semantics and refuses to change the
+ timestamp on a file if the user <command moreinfo="none">smbd</command> is acting
+ on behalf of is not the file owner. Setting this option to <constant>
+ yes</constant> allows DOS semantics and <citerefentry><refentrytitle>smbd</refentrytitle>
+ <manvolnum>8</manvolnum></citerefentry> will change the file
+ timestamp as DOS requires.</para>
+
+ <para>Default: <command moreinfo="none">dos filetimes = no</command></para></listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/exec.xml b/docs/docbook/smbdotconf/misc/exec.xml
new file mode 100644
index 0000000000..34963c90b2
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/exec.xml
@@ -0,0 +1,5 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="EXEC"/>exec (S)</term>
+ <listitem><para>This is a synonym for <link linkend="PREEXEC">
+ <parameter moreinfo="none">preexec</parameter></link>.</para></listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/fakedirectorycreatetimes.xml b/docs/docbook/smbdotconf/misc/fakedirectorycreatetimes.xml
new file mode 100644
index 0000000000..81773606ee
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/fakedirectorycreatetimes.xml
@@ -0,0 +1,31 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="FAKEDIRECTORYCREATETIMES"/>fake directory create times (S)</term>
+ <listitem><para>NTFS and Windows VFAT file systems keep a create
+ time for all files and directories. This is not the same as the
+ ctime - status change time - that Unix keeps, so Samba by default
+ reports the earliest of the various times Unix does keep. Setting
+ this parameter for a share causes Samba to always report midnight
+ 1-1-1980 as the create time for directories.</para>
+
+ <para>This option is mainly used as a compatibility option for
+ Visual C++ when used against Samba shares. Visual C++ generated
+ makefiles have the object directory as a dependency for each object
+ file, and a make rule to create the directory. Also, when NMAKE
+ compares timestamps it uses the creation time when examining a
+ directory. Thus the object directory will be created if it does not
+ exist, but once it does exist it will always have an earlier
+ timestamp than the object files it contains.</para>
+
+ <para>However, Unix time semantics mean that the create time
+ reported by Samba will be updated whenever a file is created or
+ or deleted in the directory. NMAKE finds all object files in
+ the object directory. The timestamp of the last one built is then
+ compared to the timestamp of the object directory. If the
+ directory's timestamp if newer, then all object files
+ will be rebuilt. Enabling this option
+ ensures directories always predate their contents and an NMAKE build
+ will proceed as expected.</para>
+
+ <para>Default: <command moreinfo="none">fake directory create times = no</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/followsymlinks.xml b/docs/docbook/smbdotconf/misc/followsymlinks.xml
new file mode 100644
index 0000000000..88526da320
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/followsymlinks.xml
@@ -0,0 +1,18 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="FOLLOWSYMLINKS"/>follow symlinks (S)</term>
+ <listitem><para>This parameter allows the Samba administrator
+ to stop <citerefentry><refentrytitle>smbd</refentrytitle>
+ <manvolnum>8</manvolnum></citerefentry> from following symbolic
+ links in a particular share. Setting this
+ parameter to <constant>no</constant> prevents any file or directory
+ that is a symbolic link from being followed (the user will get an
+ error). This option is very useful to stop users from adding a
+ symbolic link to <filename moreinfo="none">/etc/passwd</filename> in their home
+ directory for instance. However it will slow filename lookups
+ down slightly.</para>
+
+ <para>This option is enabled (i.e. <command moreinfo="none">smbd</command> will
+ follow symbolic links) by default.</para>
+
+ <para>Default: <command moreinfo="none">follow symlinks = yes</command></para></listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/fstype.xml b/docs/docbook/smbdotconf/misc/fstype.xml
new file mode 100644
index 0000000000..566bccb465
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/fstype.xml
@@ -0,0 +1,14 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="FSTYPE"/>fstype (S)</term>
+ <listitem><para>This parameter allows the administrator to
+ configure the string that specifies the type of filesystem a share
+ is using that is reported by <citerefentry><refentrytitle>smbd</refentrytitle>
+ <manvolnum>8</manvolnum></citerefentry> when a client queries the filesystem type
+ for a share. The default type is <constant>NTFS</constant> for
+ compatibility with Windows NT but this can be changed to other
+ strings such as <constant>Samba</constant> or <constant>FAT
+ </constant> if required.</para>
+
+ <para>Default: <command moreinfo="none">fstype = NTFS</command></para>
+ <para>Example: <command moreinfo="none">fstype = Samba</command></para></listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/hidelocalusers.xml b/docs/docbook/smbdotconf/misc/hidelocalusers.xml
new file mode 100644
index 0000000000..d0468ead6b
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/hidelocalusers.xml
@@ -0,0 +1,7 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="HIDELOCALUSERS"/>hide local users(G)</term>
+ <listitem><para>This parameter toggles the hiding of local UNIX
+ users (root, wheel, floppy, etc) from remote clients.</para>
+
+ <para>Default: <command moreinfo="none">hide local users = no</command></para></listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/homedirmap.xml b/docs/docbook/smbdotconf/misc/homedirmap.xml
new file mode 100644
index 0000000000..87a59204a2
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/homedirmap.xml
@@ -0,0 +1,28 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="HOMEDIRMAP"/>homedir map (G)</term>
+ <listitem><para>If<link linkend="NISHOMEDIR"><parameter moreinfo="none">nis homedir
+ </parameter></link> is <constant>yes</constant>, and <citerefentry><refentrytitle>smbd</refentrytitle>
+ <manvolnum>8</manvolnum></citerefentry> is also acting
+ as a Win95/98 <parameter moreinfo="none">logon server</parameter> then this parameter
+ specifies the NIS (or YP) map from which the server for the user's
+ home directory should be extracted. At present, only the Sun
+ auto.home map format is understood. The form of the map is:</para>
+
+ <para><command moreinfo="none">username server:/some/file/system</command></para>
+
+ <para>and the program will extract the servername from before
+ the first ':'. There should probably be a better parsing system
+ that copes with different map formats and also Amd (another
+ automounter) maps.</para>
+
+ <para><emphasis>NOTE :</emphasis>A working NIS client is required on
+ the system for this option to work.</para>
+
+ <para>See also <link linkend="NISHOMEDIR"><parameter moreinfo="none">nis homedir</parameter>
+ </link>, <link linkend="DOMAINLOGONS"><parameter moreinfo="none">domain logons</parameter>
+ </link>.</para>
+
+ <para>Default: <command moreinfo="none">homedir map = &lt;empty string&gt;</command></para>
+ <para>Example: <command moreinfo="none">homedir map = amd.homedir</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/include.xml b/docs/docbook/smbdotconf/misc/include.xml
new file mode 100644
index 0000000000..81230d4357
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/include.xml
@@ -0,0 +1,14 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="INCLUDE"/>include (G)</term>
+ <listitem><para>This allows you to include one config file
+ inside another. The file is included literally, as though typed
+ in place.</para>
+
+ <para>It takes the standard substitutions, except <parameter moreinfo="none">%u
+ </parameter>, <parameter moreinfo="none">%P</parameter> and <parameter moreinfo="none">%S</parameter>.
+ </para>
+
+ <para>Default: <emphasis>no file included</emphasis></para>
+ <para>Example: <command moreinfo="none">include = /usr/local/samba/lib/admin_smb.conf
+ </command></para></listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/lockdir.xml b/docs/docbook/smbdotconf/misc/lockdir.xml
new file mode 100644
index 0000000000..2c29b9b61c
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/lockdir.xml
@@ -0,0 +1,5 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="LOCKDIR"/>lock dir (G)</term>
+ <listitem><para>Synonym for <link linkend="LOCKDIRECTORY"><parameter moreinfo="none">
+ lock directory</parameter></link>.</para></listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/lockdirectory.xml b/docs/docbook/smbdotconf/misc/lockdirectory.xml
new file mode 100644
index 0000000000..7945f19864
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/lockdirectory.xml
@@ -0,0 +1,11 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="LOCKDIRECTORY"/>lock directory (G)</term>
+ <listitem><para>This option specifies the directory where lock
+ files will be placed. The lock files are used to implement the
+ <link linkend="MAXCONNECTIONS"><parameter moreinfo="none">max connections</parameter>
+ </link> option.</para>
+
+ <para>Default: <command moreinfo="none">lock directory = ${prefix}/var/locks</command></para>
+ <para>Example: <command moreinfo="none">lock directory = /var/run/samba/locks</command>
+ </para></listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/magicoutput.xml b/docs/docbook/smbdotconf/misc/magicoutput.xml
new file mode 100644
index 0000000000..8208d5bd4c
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/magicoutput.xml
@@ -0,0 +1,17 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="MAGICOUTPUT"/>magic output (S)</term>
+ <listitem><para>This parameter specifies the name of a file
+ which will contain output created by a magic script (see the
+ <link linkend="MAGICSCRIPT"><parameter moreinfo="none">magic script</parameter></link>
+ parameter below).</para>
+
+ <para>Warning: If two clients use the same <parameter moreinfo="none">magic script
+ </parameter> in the same directory the output file content
+ is undefined.</para>
+
+ <para>Default: <command moreinfo="none">magic output = &lt;magic script name&gt;.out
+ </command></para>
+
+ <para>Example: <command moreinfo="none">magic output = myfile.txt</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/magicscript.xml b/docs/docbook/smbdotconf/misc/magicscript.xml
new file mode 100644
index 0000000000..73abb50fc5
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/magicscript.xml
@@ -0,0 +1,28 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="MAGICSCRIPT"/>magic script (S)</term>
+ <listitem><para>This parameter specifies the name of a file which,
+ if opened, will be executed by the server when the file is closed.
+ This allows a UNIX script to be sent to the Samba host and
+ executed on behalf of the connected user.</para>
+
+ <para>Scripts executed in this way will be deleted upon
+ completion assuming that the user has the appropriate level
+ of privilege and the file permissions allow the deletion.</para>
+
+ <para>If the script generates output, output will be sent to
+ the file specified by the <link linkend="MAGICOUTPUT"><parameter moreinfo="none">
+ magic output</parameter></link> parameter (see above).</para>
+
+ <para>Note that some shells are unable to interpret scripts
+ containing CR/LF instead of CR as
+ the end-of-line marker. Magic scripts must be executable
+ <emphasis>as is</emphasis> on the host, which for some hosts and
+ some shells will require filtering at the DOS end.</para>
+
+ <para>Magic scripts are <emphasis>EXPERIMENTAL</emphasis> and
+ should <emphasis>NOT</emphasis> be relied upon.</para>
+
+ <para>Default: <emphasis>None. Magic scripts disabled.</emphasis></para>
+ <para>Example: <command moreinfo="none">magic script = user.csh</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/messagecommand.xml b/docs/docbook/smbdotconf/misc/messagecommand.xml
new file mode 100644
index 0000000000..199fab5610
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/messagecommand.xml
@@ -0,0 +1,65 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="MESSAGECOMMAND"/>message command (G)</term>
+ <listitem><para>This specifies what command to run when the
+ server receives a WinPopup style message.</para>
+
+ <para>This would normally be a command that would
+ deliver the message somehow. How this is to be done is
+ up to your imagination.</para>
+
+ <para>An example is:</para>
+
+ <para><command moreinfo="none">message command = csh -c 'xedit %s;rm %s' &amp;</command>
+ </para>
+
+ <para>This delivers the message using <command moreinfo="none">xedit</command>, then
+ removes it afterwards. <emphasis>NOTE THAT IT IS VERY IMPORTANT
+ THAT THIS COMMAND RETURN IMMEDIATELY</emphasis>. That's why I
+ have the '&amp;' on the end. If it doesn't return immediately then
+ your PCs may freeze when sending messages (they should recover
+ after 30 seconds, hopefully).</para>
+
+ <para>All messages are delivered as the global guest user.
+ The command takes the standard substitutions, although <parameter moreinfo="none">
+ %u</parameter> won't work (<parameter moreinfo="none">%U</parameter> may be better
+ in this case).</para>
+
+ <para>Apart from the standard substitutions, some additional
+ ones apply. In particular:</para>
+
+ <itemizedlist>
+ <listitem><para><parameter moreinfo="none">%s</parameter> = the filename containing
+ the message.</para></listitem>
+
+ <listitem><para><parameter moreinfo="none">%t</parameter> = the destination that
+ the message was sent to (probably the server name).</para></listitem>
+
+ <listitem><para><parameter moreinfo="none">%f</parameter> = who the message
+ is from.</para></listitem>
+ </itemizedlist>
+
+ <para>You could make this command send mail, or whatever else
+ takes your fancy. Please let us know of any really interesting
+ ideas you have.</para>
+
+
+ <para>Here's a way of sending the messages as mail to root:</para>
+
+ <para><command moreinfo="none">message command = /bin/mail -s 'message from %f on
+ %m' root &lt; %s; rm %s</command></para>
+
+ <para>If you don't have a message command then the message
+ won't be delivered and Samba will tell the sender there was
+ an error. Unfortunately WfWg totally ignores the error code
+ and carries on regardless, saying that the message was delivered.
+ </para>
+
+ <para>If you want to silently delete it then try:</para>
+
+ <para><command moreinfo="none">message command = rm %s</command></para>
+
+ <para>Default: <emphasis>no message command</emphasis></para>
+ <para>Example: <command moreinfo="none">message command = csh -c 'xedit %s;
+ rm %s' &amp;</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/nishomedir.xml b/docs/docbook/smbdotconf/misc/nishomedir.xml
new file mode 100644
index 0000000000..5a2980d4fd
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/nishomedir.xml
@@ -0,0 +1,30 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="NISHOMEDIR"/>nis homedir (G)</term>
+ <listitem><para>Get the home share server from a NIS map. For
+ UNIX systems that use an automounter, the user's home directory
+ will often be mounted on a workstation on demand from a remote
+ server. </para>
+
+ <para>When the Samba logon server is not the actual home directory
+ server, but is mounting the home directories via NFS then two
+ network hops would be required to access the users home directory
+ if the logon server told the client to use itself as the SMB server
+ for home directories (one over SMB and one over NFS). This can
+ be very slow.</para>
+
+ <para>This option allows Samba to return the home share as
+ being on a different server to the logon server and as
+ long as a Samba daemon is running on the home directory server,
+ it will be mounted on the Samba client directly from the directory
+ server. When Samba is returning the home share to the client, it
+ will consult the NIS map specified in <link linkend="HOMEDIRMAP">
+ <parameter moreinfo="none">homedir map</parameter></link> and return the server
+ listed there.</para>
+
+ <para>Note that for this option to work there must be a working
+ NIS system and the Samba server with this option must also
+ be a logon server.</para>
+
+ <para>Default: <command moreinfo="none">nis homedir = no</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/panicaction.xml b/docs/docbook/smbdotconf/misc/panicaction.xml
new file mode 100644
index 0000000000..6de37c2c17
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/panicaction.xml
@@ -0,0 +1,12 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="PANICACTION"/>panic action (G)</term>
+ <listitem><para>This is a Samba developer option that allows a
+ system command to be called when either <citerefentry><refentrytitle>smbd</refentrytitle>
+ <manvolnum>8</manvolnum></citerefentry> or <citerefentry><refentrytitle>smbd</refentrytitle>
+ <manvolnum>8</manvolnum></citerefentry> crashes. This is usually used to
+ draw attention to the fact that a problem occurred.</para>
+
+ <para>Default: <command moreinfo="none">panic action = &lt;empty string&gt;</command></para>
+ <para>Example: <command moreinfo="none">panic action = &quot;/bin/sleep 90000&quot;</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/piddirectory.xml b/docs/docbook/smbdotconf/misc/piddirectory.xml
new file mode 100644
index 0000000000..81c1b13e75
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/piddirectory.xml
@@ -0,0 +1,9 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="PIDDIRECTORY"/>pid directory (G)</term>
+ <listitem><para>This option specifies the directory where pid
+ files will be placed. </para>
+
+ <para>Default: <command moreinfo="none">pid directory = ${prefix}/var/locks</command></para>
+ <para>Example: <command moreinfo="none">pid directory = /var/run/</command>
+ </para></listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/postexec.xml b/docs/docbook/smbdotconf/misc/postexec.xml
new file mode 100644
index 0000000000..017177be3d
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/postexec.xml
@@ -0,0 +1,22 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="POSTEXEC"/>postexec (S)</term>
+ <listitem><para>This option specifies a command to be run
+ whenever the service is disconnected. It takes the usual
+ substitutions. The command may be run as the root on some
+ systems.</para>
+
+ <para>An interesting example may be to unmount server
+ resources:</para>
+
+ <para><command moreinfo="none">postexec = /etc/umount /cdrom</command></para>
+
+ <para>See also <link linkend="PREEXEC"><parameter moreinfo="none">preexec</parameter>
+ </link>.</para>
+
+ <para>Default: <emphasis>none (no command executed)</emphasis>
+ </para>
+
+ <para>Example: <command moreinfo="none">postexec = echo \&quot;%u disconnected from %S
+ from %m (%I)\&quot; &gt;&gt; /tmp/log</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/preexec.xml b/docs/docbook/smbdotconf/misc/preexec.xml
new file mode 100644
index 0000000000..fc047e008d
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/preexec.xml
@@ -0,0 +1,23 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="PREEXEC"/>preexec (S)</term>
+ <listitem><para>This option specifies a command to be run whenever
+ the service is connected to. It takes the usual substitutions.</para>
+
+ <para>An interesting example is to send the users a welcome
+ message every time they log in. Maybe a message of the day? Here
+ is an example:</para>
+
+ <para><command moreinfo="none">preexec = csh -c 'echo \&quot;Welcome to %S!\&quot; |
+ /usr/local/samba/bin/smbclient -M %m -I %I' &amp; </command></para>
+
+ <para>Of course, this could get annoying after a while :-)</para>
+
+ <para>See also <link linkend="PREEXECCLOSE"><parameter moreinfo="none">preexec close
+ </parameter></link> and <link linkend="POSTEXEC"><parameter moreinfo="none">postexec
+ </parameter></link>.</para>
+
+ <para>Default: <emphasis>none (no command executed)</emphasis></para>
+ <para>Example: <command moreinfo="none">preexec = echo \&quot;%u connected to %S from %m
+ (%I)\&quot; &gt;&gt; /tmp/log</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/preexecclose.xml b/docs/docbook/smbdotconf/misc/preexecclose.xml
new file mode 100644
index 0000000000..c617a7f7fa
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/preexecclose.xml
@@ -0,0 +1,9 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="PREEXECCLOSE"/>preexec close (S)</term>
+ <listitem><para>This boolean option controls whether a non-zero
+ return code from <link linkend="PREEXEC"><parameter moreinfo="none">preexec
+ </parameter></link> should close the service being connected to.</para>
+
+ <para>Default: <command moreinfo="none">preexec close = no</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/preload.xml b/docs/docbook/smbdotconf/misc/preload.xml
new file mode 100644
index 0000000000..574ed1a369
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/preload.xml
@@ -0,0 +1,16 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="PRELOAD"/>preload (G)</term>
+ <listitem><para>This is a list of services that you want to be
+ automatically added to the browse lists. This is most useful
+ for homes and printers services that would otherwise not be
+ visible.</para>
+
+ <para>Note that if you just want all printers in your
+ printcap file loaded then the <link linkend="LOADPRINTERS">
+ <parameter moreinfo="none">load printers</parameter></link> option is easier.</para>
+
+ <para>Default: <emphasis>no preloaded services</emphasis></para>
+
+ <para>Example: <command moreinfo="none">preload = fred lp colorlp</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/remoteannounce.xml b/docs/docbook/smbdotconf/misc/remoteannounce.xml
new file mode 100644
index 0000000000..e6de4bdcaf
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/remoteannounce.xml
@@ -0,0 +1,32 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="REMOTEANNOUNCE"/>remote announce (G)</term>
+ <listitem><para>This option allows you to setup <ulink url="nmbd.8.html">nmbd(8)</ulink> to periodically announce itself
+ to arbitrary IP addresses with an arbitrary workgroup name.</para>
+
+ <para>This is useful if you want your Samba server to appear
+ in a remote workgroup for which the normal browse propagation
+ rules don't work. The remote workgroup can be anywhere that you
+ can send IP packets to.</para>
+
+ <para>For example:</para>
+
+ <para><command moreinfo="none">remote announce = 192.168.2.255/SERVERS
+ 192.168.4.255/STAFF</command></para>
+
+ <para>the above line would cause <command moreinfo="none">nmbd</command> to announce itself
+ to the two given IP addresses using the given workgroup names.
+ If you leave out the workgroup name then the one given in
+ the <link linkend="WORKGROUP"><parameter moreinfo="none">workgroup</parameter></link>
+ parameter is used instead.</para>
+
+ <para>The IP addresses you choose would normally be the broadcast
+ addresses of the remote networks, but can also be the IP addresses
+ of known browse masters if your network config is that stable.</para>
+
+ <para>See the documentation file <ulink url="improved-browsing.html">BROWSING</ulink>
+ in the <filename moreinfo="none">docs/</filename> directory.</para>
+
+ <para>Default: <command moreinfo="none">remote announce = &lt;empty string&gt;
+ </command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/remotebrowsesync.xml b/docs/docbook/smbdotconf/misc/remotebrowsesync.xml
new file mode 100644
index 0000000000..8b0d863ed7
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/remotebrowsesync.xml
@@ -0,0 +1,33 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="REMOTEBROWSESYNC"/>remote browse sync (G)</term>
+ <listitem><para>This option allows you to setup <ulink url="nmbd.8.html">nmbd(8)</ulink> to periodically request
+ synchronization of browse lists with the master browser of a Samba
+ server that is on a remote segment. This option will allow you to
+ gain browse lists for multiple workgroups across routed networks. This
+ is done in a manner that does not work with any non-Samba servers.</para>
+
+ <para>This is useful if you want your Samba server and all local
+ clients to appear in a remote workgroup for which the normal browse
+ propagation rules don't work. The remote workgroup can be anywhere
+ that you can send IP packets to.</para>
+
+ <para>For example:</para>
+
+ <para><command moreinfo="none">remote browse sync = 192.168.2.255 192.168.4.255
+ </command></para>
+
+ <para>the above line would cause <command moreinfo="none">nmbd</command> to request
+ the master browser on the specified subnets or addresses to
+ synchronize their browse lists with the local server.</para>
+
+ <para>The IP addresses you choose would normally be the broadcast
+ addresses of the remote networks, but can also be the IP addresses
+ of known browse masters if your network config is that stable. If
+ a machine IP address is given Samba makes NO attempt to validate
+ that the remote machine is available, is listening, nor that it
+ is in fact the browse master on its segment.</para>
+
+ <para>Default: <command moreinfo="none">remote browse sync = &lt;empty string&gt;
+ </command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/rootpostexec.xml b/docs/docbook/smbdotconf/misc/rootpostexec.xml
new file mode 100644
index 0000000000..ed60646677
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/rootpostexec.xml
@@ -0,0 +1,14 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="ROOTPOSTEXEC"/>root postexec (S)</term>
+ <listitem><para>This is the same as the <parameter moreinfo="none">postexec</parameter>
+ parameter except that the command is run as root. This
+ is useful for unmounting filesystems
+ (such as CDROMs) after a connection is closed.</para>
+
+ <para>See also <link linkend="POSTEXEC"><parameter moreinfo="none">
+ postexec</parameter></link>.</para>
+
+ <para>Default: <command moreinfo="none">root postexec = &lt;empty string&gt;
+ </command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/rootpreexec.xml b/docs/docbook/smbdotconf/misc/rootpreexec.xml
new file mode 100644
index 0000000000..29802b6d63
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/rootpreexec.xml
@@ -0,0 +1,15 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="ROOTPREEXEC"/>root preexec (S)</term>
+ <listitem><para>This is the same as the <parameter moreinfo="none">preexec</parameter>
+ parameter except that the command is run as root. This
+ is useful for mounting filesystems (such as CDROMs) when a
+ connection is opened.</para>
+
+ <para>See also <link linkend="PREEXEC"><parameter moreinfo="none">
+ preexec</parameter></link> and <link linkend="PREEXECCLOSE">
+ <parameter moreinfo="none">preexec close</parameter></link>.</para>
+
+ <para>Default: <command moreinfo="none">root preexec = &lt;empty string&gt;
+ </command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/rootpreexecclose.xml b/docs/docbook/smbdotconf/misc/rootpreexecclose.xml
new file mode 100644
index 0000000000..d21b0dd7b5
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/rootpreexecclose.xml
@@ -0,0 +1,12 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="ROOTPREEXECCLOSE"/>root preexec close (S)</term>
+ <listitem><para>This is the same as the <parameter moreinfo="none">preexec close
+ </parameter> parameter except that the command is run as root.</para>
+
+ <para>See also <link linkend="PREEXEC"><parameter moreinfo="none">
+ preexec</parameter></link> and <link linkend="PREEXECCLOSE">
+ <parameter moreinfo="none">preexec close</parameter></link>.</para>
+
+ <para>Default: <command moreinfo="none">root preexec close = no</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/setdirectory.xml b/docs/docbook/smbdotconf/misc/setdirectory.xml
new file mode 100644
index 0000000000..860632cdaf
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/setdirectory.xml
@@ -0,0 +1,13 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="SETDIRECTORY"/>set directory (S)</term>
+ <listitem><para>If <command moreinfo="none">set directory = no</command>, then
+ users of the service may not use the setdir command to change
+ directory.</para>
+
+ <para>The <command moreinfo="none">setdir</command> command is only implemented
+ in the Digital Pathworks client. See the Pathworks documentation
+ for details.</para>
+
+ <para>Default: <command moreinfo="none">set directory = no</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/socketaddress.xml b/docs/docbook/smbdotconf/misc/socketaddress.xml
new file mode 100644
index 0000000000..e77737f18b
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/socketaddress.xml
@@ -0,0 +1,14 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="SOCKETADDRESS"/>socket address (G)</term>
+ <listitem><para>This option allows you to control what
+ address Samba will listen for connections on. This is used to
+ support multiple virtual interfaces on the one server, each
+ with a different configuration.</para>
+
+ <para>By default Samba will accept connections on any
+ address.</para>
+
+ <para>Example: <command moreinfo="none">socket address = 192.168.2.20</command>
+ </para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/sourceenvironment.xml b/docs/docbook/smbdotconf/misc/sourceenvironment.xml
new file mode 100644
index 0000000000..07a8abce4d
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/sourceenvironment.xml
@@ -0,0 +1,23 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="SOURCEENVIRONMENT"/>source environment (G)</term>
+ <listitem><para>This parameter causes Samba to set environment
+ variables as per the content of the file named.</para>
+
+ <para>If the value of this parameter starts with a &quot;|&quot; character
+ then Samba will treat that value as a pipe command to open and
+ will set the environment variables from the output of the pipe.</para>
+
+ <para>The contents of the file or the output of the pipe should
+ be formatted as the output of the standard Unix <command moreinfo="none">env(1)
+ </command> command. This is of the form :</para>
+ <para>Example environment entry:</para>
+ <para><command moreinfo="none">SAMBA_NETBIOS_NAME = myhostname</command></para>
+
+ <para>Default: <emphasis>No default value</emphasis></para>
+ <para>Examples: <command moreinfo="none">source environment = |/etc/smb.conf.sh
+ </command></para>
+
+ <para>Example: <command moreinfo="none">source environment =
+ /usr/local/smb_env_vars</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/timeoffset.xml b/docs/docbook/smbdotconf/misc/timeoffset.xml
new file mode 100644
index 0000000000..0c973234c3
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/timeoffset.xml
@@ -0,0 +1,11 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="TIMEOFFSET"/>time offset (G)</term>
+ <listitem><para>This parameter is a setting in minutes to add
+ to the normal GMT to local time conversion. This is useful if
+ you are serving a lot of PCs that have incorrect daylight
+ saving time handling.</para>
+
+ <para>Default: <command moreinfo="none">time offset = 0</command></para>
+ <para>Example: <command moreinfo="none">time offset = 60</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/utmp.xml b/docs/docbook/smbdotconf/misc/utmp.xml
new file mode 100644
index 0000000000..014b85d6bc
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/utmp.xml
@@ -0,0 +1,21 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="UTMP"/>utmp (G)</term>
+ <listitem><para>This boolean parameter is only available if
+ Samba has been configured and compiled with the option <command moreinfo="none">
+ --with-utmp</command>. If set to <constant>yes</constant> then Samba will attempt
+ to add utmp or utmpx records (depending on the UNIX system) whenever a
+ connection is made to a Samba server. Sites may use this to record the
+ user connecting to a Samba share.</para>
+
+ <para>Due to the requirements of the utmp record, we
+ are required to create a unique identifier for the
+ incoming user. Enabling this option creates an n^2
+ algorithm to find this number. This may impede
+ performance on large installations. </para>
+
+ <para>See also the <link linkend="UTMPDIRECTORY"><parameter moreinfo="none">
+ utmp directory</parameter></link> parameter.</para>
+
+ <para>Default: <command moreinfo="none">utmp = no</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/utmpdirectory.xml b/docs/docbook/smbdotconf/misc/utmpdirectory.xml
new file mode 100644
index 0000000000..9e5574fb39
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/utmpdirectory.xml
@@ -0,0 +1,16 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="UTMPDIRECTORY"/>utmp directory(G)</term>
+ <listitem><para>This parameter is only available if Samba has
+ been configured and compiled with the option <command moreinfo="none">
+ --with-utmp</command>. It specifies a directory pathname that is
+ used to store the utmp or utmpx files (depending on the UNIX system) that
+ record user connections to a Samba server. See also the <link linkend="UTMP">
+ <parameter moreinfo="none">utmp</parameter></link> parameter. By default this is
+ not set, meaning the system will use whatever utmp file the
+ native system is set to use (usually
+ <filename moreinfo="none">/var/run/utmp</filename> on Linux).</para>
+
+ <para>Default: <emphasis>no utmp directory</emphasis></para>
+ <para>Example: <command moreinfo="none">utmp directory = /var/run/utmp</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/volume.xml b/docs/docbook/smbdotconf/misc/volume.xml
new file mode 100644
index 0000000000..f0a82c6f0c
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/volume.xml
@@ -0,0 +1,9 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="VOLUME"/>volume (S)</term>
+ <listitem><para> This allows you to override the volume label
+ returned for a share. Useful for CDROMs with installation programs
+ that insist on a particular volume label.</para>
+
+ <para>Default: <emphasis>the name of the share</emphasis></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/widelinks.xml b/docs/docbook/smbdotconf/misc/widelinks.xml
new file mode 100644
index 0000000000..b3474ce26c
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/widelinks.xml
@@ -0,0 +1,15 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="WIDELINKS"/>wide links (S)</term>
+ <listitem><para>This parameter controls whether or not links
+ in the UNIX file system may be followed by the server. Links
+ that point to areas within the directory tree exported by the
+ server are always allowed; this parameter controls access only
+ to areas that are outside the directory tree being exported.</para>
+
+ <para>Note that setting this parameter can have a negative
+ effect on your server performance due to the extra system calls
+ that Samba has to do in order to perform the link checks.</para>
+
+ <para>Default: <command moreinfo="none">wide links = yes</command></para>
+ </listitem>
+ </samba:parameter>
diff --git a/docs/docbook/smbdotconf/misc/wtmpdirectory.xml b/docs/docbook/smbdotconf/misc/wtmpdirectory.xml
new file mode 100644
index 0000000000..bb144473ff
--- /dev/null
+++ b/docs/docbook/smbdotconf/misc/wtmpdirectory.xml
@@ -0,0 +1,20 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+ <term><anchor id="WTMPDIRECTORY"/>wtmp directory(G)</term>
+ <listitem><para>This parameter is only available if Samba has
+ been configured and compiled with the option <command moreinfo="none">
+ --with-utmp</command>. It specifies a directory pathname that is
+ used to store the wtmp or wtmpx files (depending on the UNIX system) that
+ record user connections to a Samba server. The difference with
+ the utmp directory is the fact that user info is kept after a user
+ has logged out.
+
+ See also the <link linkend="UTMP">
+ <parameter moreinfo="none">utmp</parameter></link> parameter. By default this is
+ not set, meaning the system will use whatever utmp file the
+ native system is set to use (usually
+ <filename moreinfo="none">/var/run/wtmp</filename> on Linux).</para>
+
+ <para>Default: <emphasis>no wtmp directory</emphasis></para>
+ <para>Example: <command moreinfo="none">wtmp directory = /var/log/wtmp</command></para>
+ </listitem>
+ </samba:parameter>