-<samba:parameter xmlns:samba="http://samba.org/common">
- <term><anchor id="AVAILABLE"/>available (S)</term>
- <listitem><para>This parameter lets you "turn off" 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>
+<samba:parameter name="available"
+ context="S"
+ basic="1" advanced="1" print="1"
+ xmlns:samba="http://samba.org/common">
+<listitem>
+ <para>This parameter lets you "turn off" 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>
+ <para>Default: <command moreinfo="none">available = yes</command></para>
+</listitem>
+</samba:parameter>
-<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>
+<samba:parameter name="dont descend"
+ context="S"
+ xmlns:samba="http://samba.org/common">
+<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 "dont descend" 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>Note that Samba can be very fussy about the exact format
+ of the "dont descend" 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>
+ <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>
-<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>
+<samba:parameter name="follow symlinks"
+ context="S"
+ xmlns:samba="http://samba.org/common">
+<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>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>
+ <para>Default: <command moreinfo="none">follow symlinks = yes</command></para>
+</listitem>
+</samba:parameter>
-<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>
+<samba:parameter name="fstype"
+ context="S"
+ xmlns:samba="http://samba.org/common">
+<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>
+ <para>Default: <command moreinfo="none">fstype = NTFS</command></para>
+
+ <para>Example: <command moreinfo="none">fstype = Samba</command></para>
+</listitem>
+</samba:parameter>
-<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>
+<samba:parameter name="postexec"
+ context="S"
+ advanced="1" developer="1"
+ xmlns:samba="http://samba.org/common">
+<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>An interesting example may be to unmount server
+ resources:</para>
-
<para><command moreinfo="none">postexec = /etc/umount /cdrom</command></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>See also <link linkend="PREEXEC"><parameter moreinfo="none">preexec</parameter></link>.</para>
- <para>Default: <emphasis>none (no command executed)</emphasis>
- </para>
+ <para>Default: <emphasis>none (no command executed)</emphasis></para>
- <para>Example: <command moreinfo="none">postexec = echo \"%u disconnected from %S
- from %m (%I)\" >> /tmp/log</command></para>
- </listitem>
- </samba:parameter>
+ <para>Example: <command moreinfo="none">postexec = echo \"%u disconnected from %S from %m (%I)\" >> /tmp/log</command></para>
+</listitem>
+</samba:parameter>
-<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>
+<samba:parameter name="preexec close"
+ context="S"
+ advanced="1" developer="1"
+ xmlns:samba="http://samba.org/common">
+<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>
+ <para>Default: <command moreinfo="none">preexec close = no</command></para>
+</listitem>
+</samba:parameter>
-<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>
+<samba:parameter name="root postexec"
+ context="S"
+ advanced="1" developer="1"
+ xmlns:samba="http://samba.org/common">
+<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>See also <link linkend="POSTEXEC"><parameter moreinfo="none">
+ postexec</parameter></link>.</para>
- <para>Default: <command moreinfo="none">root postexec = <empty string>
- </command></para>
- </listitem>
- </samba:parameter>
+ <para>Default: <command moreinfo="none">root postexec = <empty string></command></para>
+</listitem>
+</samba:parameter>
-<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>
+<samba:parameter name="root preexec"
+ context="S"
+ advanced="1" wizard="1" developer="1"
+ xmlns:samba="http://samba.org/common">
+<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>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 = <empty string>
- </command></para>
- </listitem>
- </samba:parameter>
+ <para>Default: <command moreinfo="none">root preexec = <empty string></command></para>
+</listitem>
+</samba:parameter>
-<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>
+<samba:parameter name="root preexec close"
+ context="S"
+ advanced="1" developer="1"
+ xmlns:samba="http://samba.org/common">
+<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>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>
+ <para>Default: <command moreinfo="none">root preexec close = no</command></para>
+</listitem>
+</samba:parameter>
-<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>
+<samba:parameter name="set directory"
+ context="S"
+ xmlns:samba="http://samba.org/common">
+<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>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>
+ <para>Default: <command moreinfo="none">set directory = no</command></para>
+</listitem>
+</samba:parameter>
-<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>
+<samba:parameter name="source environment"
+ context="G"
+ advanced="1" developer="1"
+ xmlns:samba="http://samba.org/common">
+<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 "|" 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>If the value of this parameter starts with a "|" 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>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>Default: <emphasis>No default value</emphasis></para>
- <para>Examples: <command moreinfo="none">source environment = |/etc/smb.conf.sh
- </command></para>
+ <para>Example environment entry:</para>
- <para>Example: <command moreinfo="none">source environment =
- /usr/local/smb_env_vars</command></para>
- </listitem>
- </samba:parameter>
+ <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>
-<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>
+<samba:parameter name="volume"
+ context="S"
+ xmlns:samba="http://samba.org/common">
+ <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>
+ <para>Default: <emphasis>the name of the share</emphasis></para>
+</listitem>
+</samba:parameter>
-<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>
+<samba:parameter name="wide links"
+ context="S"
+ xmlns:samba="http://samba.org/common">
+ <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>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>
+ <para>Default: <command moreinfo="none">wide links = yes</command></para>
+</listitem>
+</samba:parameter>
git.samba.org / tprouty / samba.git / commitdiff