Ignore:
Timestamp:
Nov 27, 2012, 4:43:17 PM (13 years ago)
Author:
Silvan Scherrer
Message:

Samba Server: updated trunk to 3.6.0

Location:
trunk/server
Files:
3 deleted
76 edited
4 copied

Legend:

Unmodified
Added
Removed

  • trunk/server

  • trunk/server/docs/htmldocs/manpages/eventlogadm.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>eventlogadm</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="eventlogadm"><a name="eventlogadm.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>eventlogadm &#8212; push records into the Samba event log store</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">eventlogadm</code> [<code class="option">-d</code>] [<code class="option">-h</code>]  <code class="option">-o</code>
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>eventlogadm</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="eventlogadm"><a name="eventlogadm.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>eventlogadm &#8212; push records into the Samba event log store</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">eventlogadm</code> [<code class="option">-s</code>] [<code class="option">-d</code>] [<code class="option">-h</code>]  <code class="option">-o</code>
    22                <code class="literal">addsource</code>
    33                <em class="replaceable"><code>EVENTLOG</code></em>
    44                <em class="replaceable"><code>SOURCENAME</code></em>
    55                <em class="replaceable"><code>MSGFILE</code></em>
    6                  </p></div><div class="cmdsynopsis"><p><code class="literal">eventlogadm</code> [<code class="option">-d</code>] [<code class="option">-h</code>]  <code class="option">-o</code>
     6                 </p></div><div class="cmdsynopsis"><p><code class="literal">eventlogadm</code> [<code class="option">-s</code>] [<code class="option">-d</code>] [<code class="option">-h</code>]  <code class="option">-o</code>
    77                <code class="literal">write</code>
    88                <em class="replaceable"><code>EVENTLOG</code></em>
    9                  </p></div><div class="cmdsynopsis"><p><code class="literal">eventlogadm</code> [<code class="option">-d</code>] [<code class="option">-h</code>]  <code class="option">-o</code>
     9                 </p></div><div class="cmdsynopsis"><p><code class="literal">eventlogadm</code> [<code class="option">-s</code>] [<code class="option">-d</code>] [<code class="option">-h</code>]  <code class="option">-o</code>
    1010                <code class="literal">dump</code>
    1111                <em class="replaceable"><code>EVENTLOG</code></em>
    1212                <em class="replaceable"><code>RECORD_NUMBER</code></em>
    13                  </p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id265734"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.1.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(1)</span></a> suite.</p><p><code class="literal">eventlogadm</code> is a filter that accepts
     13                 </p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id265759"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.1.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(1)</span></a> suite.</p><p><code class="literal">eventlogadm</code> is a filter that accepts
    1414        formatted event log records on standard input and writes them
    1515        to the Samba event log store. Windows client can then manipulate
    16         these record using the usual administration tools.</p></div><div class="refsect1" title="OPTIONS"><a name="id265762"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term"><code class="option">-d</code></span></dt><dd><p>
     16        these record using the usual administration tools.</p></div><div class="refsect1" title="OPTIONS"><a name="id265788"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">
     17                <code class="option">-s</code>
     18                <em class="replaceable"><code>FILENAME</code></em>
     19                </span></dt><dd><p>
     20                The <code class="literal">-s</code> option causes <code class="literal">eventlogadm</code> to load the
     21                configuration file given as FILENAME instead of the default one used by Samba.
     22                </p></dd><dt><span class="term"><code class="option">-d</code></span></dt><dd><p>
    1723                The <code class="literal">-d</code> option causes <code class="literal">eventlogadm</code> to emit debugging
    1824                information.
    … …  
    4551                </p></dd><dt><span class="term"><code class="option">-h</code></span></dt><dd><p>
    4652                Print usage information.
    47                 </p></dd></dl></div></div><div class="refsect1" title="EVENTLOG RECORD FORMAT"><a name="id265911"></a><h2>EVENTLOG RECORD FORMAT</h2><p>For the write operation, <code class="literal">eventlogadm</code>
     53                </p></dd></dl></div></div><div class="refsect1" title="EVENTLOG RECORD FORMAT"><a name="id265966"></a><h2>EVENTLOG RECORD FORMAT</h2><p>For the write operation, <code class="literal">eventlogadm</code>
    4854        expects to be able to read structured records from standard
    4955        input. These records are a sequence of lines, with the record key
    … …  
    94100                </p></li><li class="listitem"><p>
    95101                <code class="literal">DAT</code> - This field should be left unset.
    96                 </p></li></ul></div></div><div class="refsect1" title="EXAMPLES"><a name="id307151"></a><h2>EXAMPLES</h2><p>An example of the record format accepted by <code class="literal">eventlogadm</code>:</p><pre class="programlisting">
     102                </p></li></ul></div></div><div class="refsect1" title="EXAMPLES"><a name="id307202"></a><h2>EXAMPLES</h2><p>An example of the record format accepted by <code class="literal">eventlogadm</code>:</p><pre class="programlisting">
    97103        LEN: 0
    98104        RS1: 1699505740
    … …  
    117123                my_program_to_parse_into_eventlog_records | \\
    118124                eventlogadm SystemLogEvents
    119         </pre></div><div class="refsect1" title="VERSION"><a name="id307192"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id307202"></a><h2>AUTHOR</h2><p> The original Samba software and related utilities were
     125        </pre></div><div class="refsect1" title="VERSION"><a name="id307243"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id307252"></a><h2>AUTHOR</h2><p> The original Samba software and related utilities were
    120126        created by Andrew Tridgell.  Samba is now developed by the
    121127        Samba Team as an Open Source project similar to the way the

  • trunk/server/docs/htmldocs/manpages/findsmb.1.html

    r599 r745  
    11<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>findsmb</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="findsmb"><a name="findsmb.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>findsmb &#8212; list info about machines that respond to SMB
    2         name queries on a subnet</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">findsmb</code> [subnet broadcast address]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266348"></a><h2>DESCRIPTION</h2><p>This perl script is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>
     2        name queries on a subnet</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">findsmb</code> [subnet broadcast address]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266347"></a><h2>DESCRIPTION</h2><p>This perl script is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>
    33        suite.</p><p><code class="literal">findsmb</code> is a perl script that
    44        prints out several pieces of information about machines
    … …  
    77        and <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>
    88        to obtain this information.
    9         </p></div><div class="refsect1" title="OPTIONS"><a name="id266846"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-r</span></dt><dd><p>Controls whether <code class="literal">findsmb</code> takes
     9        </p></div><div class="refsect1" title="OPTIONS"><a name="id266844"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-r</span></dt><dd><p>Controls whether <code class="literal">findsmb</code> takes
    1010                bugs in Windows95 into account when trying to find a Netbios name
    1111                registered of the remote machine. This option is disabled by default
    … …  
    1717                is run. This value is passed to
    1818                <a class="citerefentry" href="nmblookup.1.html"><span class="citerefentry"><span class="refentrytitle">nmblookup</span>(1)</span></a>
    19                 as part of the <code class="constant">-B</code> option.</p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id265716"></a><h2>EXAMPLES</h2><p>The output of <code class="literal">findsmb</code> lists the following
     19                as part of the <code class="constant">-B</code> option.</p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id265714"></a><h2>EXAMPLES</h2><p>The output of <code class="literal">findsmb</code> lists the following
    2020        information for all machines that respond to the initial
    2121        <code class="literal">nmblookup</code> for any name: IP address, NetBIOS name,
    … …  
    4949192.168.35.93   FROGSTAR-PC    [MVENGR] [Windows 5.0] [Windows 2000 LAN Manager]
    5050192.168.35.97   HERBNT1       *[HERB-NT] [Windows NT 4.0] [NT LAN Manager 4.0]
    51 </pre></div><div class="refsect1" title="VERSION"><a name="id265803"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    52         the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id265813"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>,
     51</pre></div><div class="refsect1" title="VERSION"><a name="id265801"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     52        the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id265811"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>,
    5353        <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>, and <a class="citerefentry" href="nmblookup.1.html"><span class="citerefentry"><span class="refentrytitle">nmblookup</span>(1)</span></a>
    54         </p></div><div class="refsect1" title="AUTHOR"><a name="id265846"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     54        </p></div><div class="refsect1" title="AUTHOR"><a name="id265845"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    5555        were created by Andrew Tridgell. Samba is now developed
    5656        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/idmap_ad.8.html

    r599 r745  
    55        by the administrator by adding the posixAccount/posixGroup
    66        classes and relative attribute/value pairs to the user and
    7         group objects in the AD.</p></div><div class="refsect1" title="IDMAP OPTIONS"><a name="id266339"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">range = low - high</span></dt><dd><p>
     7        group objects in the AD.</p><p>
     8        Note that the idmap_ad module has changed considerably since
     9        Samba versions 3.0 and 3.2.
     10        Currently, the <em class="parameter"><code>ad</code></em> backend
     11        does not work as the the default idmap backend, but one has
     12        to configure it separately for each domain for which one wants
     13        to use it, using disjoint ranges. One usually needs to configure
     14        a writeable default idmap range, using for example the
     15        <em class="parameter"><code>tdb</code></em> or <em class="parameter"><code>ldap</code></em>)
     16        backend, in order to be able to map the BUILTIN sids and
     17        possibly other trusted domains. The writeable default config
     18        is also needed in order to be able to create group mappings.
     19        This catch-all default idmap configuration should have a range
     20        that is disjoint from any explicitly configured domain with
     21        idmap backend <em class="parameter"><code>ad</code></em>. See the example below.
     22        </p></div><div class="refsect1" title="IDMAP OPTIONS"><a name="id266828"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">range = low - high</span></dt><dd><p>
    823                        Defines the available matching UID and GID range for which the
    924                        backend is authoritative. Note that the range acts as a filter.
    … …  
    1732                        This can be either the RFC2307 schema support included
    1833                        in Windows 2003 R2 or the Service for Unix (SFU) schema.
    19                 </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id266832"></a><h2>EXAMPLES</h2><p>
     34                </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id266865"></a><h2>EXAMPLES</h2><p>
    2035        The following example shows how to retrieve idmappings from our principal and
    2136        trusted AD domains. If trusted domains are present id conflicts must be
    … …  
    3348        idmap config CORP : backend  = ad
    3449        idmap config CORP : range = 1000-999999
    35         </pre></div><div class="refsect1" title="AUTHOR"><a name="id266852"></a><h2>AUTHOR</h2><p>
     50        </pre></div><div class="refsect1" title="AUTHOR"><a name="id266886"></a><h2>AUTHOR</h2><p>
    3651        The original Samba software and related utilities
    3752        were created by Andrew Tridgell. Samba is now developed

  • trunk/server/docs/htmldocs/manpages/idmap_ldap.8.html

    r599 r745  
    6666        store. The "net idmap " command is used to store a secret
    6767        for the DN specified in a specific idmap domain.
    68         </p></div><div class="refsect1" title="AUTHOR"><a name="id265751"></a><h2>AUTHOR</h2><p>
     68        </p></div><div class="refsect1" title="AUTHOR"><a name="id265752"></a><h2>AUTHOR</h2><p>
    6969        The original Samba software and related utilities
    7070        were created by Andrew Tridgell. Samba is now developed

  • trunk/server/docs/htmldocs/manpages/idmap_rid.8.html

    r599 r745  
    11<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>idmap_rid</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="idmap_rid"><a name="idmap_rid.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>idmap_rid &#8212; Samba's idmap_rid Backend for Winbind</p></div><div class="refsynopsisdiv" title="DESCRIPTION"><h2>DESCRIPTION</h2><p>The idmap_rid backend provides a way to use an algorithmic
    22        mapping scheme to map UIDs/GIDs and SIDs. No database is required
    3         in this case as the mapping is deterministic.</p></div><div class="refsect1" title="IDMAP OPTIONS"><a name="id266338"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">range = low - high</span></dt><dd><p>
     3        in this case as the mapping is deterministic.</p><p>
     4        Note that the idmap_rid module has changed considerably since Samba
     5        versions 3.0. and 3.2.
     6        Currently, there should to be an explicit idmap configuration for each
     7        domain that should use the idmap_rid backend, using disjoint ranges.
     8        One usually needs to define a writeable default idmap range, using
     9        a backent like <em class="parameter"><code>tdb</code></em> or <em class="parameter"><code>ldap</code></em>
     10        that can create unix ids, in order to be able to map the BUILTIN sids
     11        and other domains, and also in order to be able to create group mappings.
     12        See the example below.
     13        </p><p>
     14        Note that the old syntax
     15        <em class="parameter"><code>idmap backend = rid:"DOM1=range DOM2=range2 ..."</code></em>
     16        is not supported any more since Samba version 3.0.25.
     17        </p></div><div class="refsect1" title="IDMAP OPTIONS"><a name="id266822"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">range = low - high</span></dt><dd><p>
    418                        Defines the available matching uid and gid range for which the
    519                        backend is authoritative. Note that the range acts as a filter.
    … …  
    1832                </p><p>
    1933                        Use of this parameter is deprecated.
    20                 </p></dd></dl></div></div><div class="refsect1" title="THE MAPPING FORMULAS"><a name="id266835"></a><h2>THE MAPPING FORMULAS</h2><p>
     34                </p></dd></dl></div></div><div class="refsect1" title="THE MAPPING FORMULAS"><a name="id266864"></a><h2>THE MAPPING FORMULAS</h2><p>
    2135                The Unix ID for a RID is calculated this way:
    2236                </p><pre class="programlisting">
    … …  
    2943                        RID = ID + BASE_RID - LOW_RANGE_ID.
    3044                </pre><p>
    31         </p></div><div class="refsect1" title="EXAMPLES"><a name="id266860"></a><h2>EXAMPLES</h2><p>
     45        </p></div><div class="refsect1" title="EXAMPLES"><a name="id266889"></a><h2>EXAMPLES</h2><p>
    3246                This example shows how to configure two domains with idmap_rid,
    3347                the principal domain and a trusted domain, leaving the default
    … …  
    4963        idmap config TRUSTED : range    = 50000 - 99999
    5064        idmap config TRUSTED : base_rid = 1000
    51         </pre></div><div class="refsect1" title="AUTHOR"><a name="id266881"></a><h2>AUTHOR</h2><p>
     65        </pre></div><div class="refsect1" title="AUTHOR"><a name="id265706"></a><h2>AUTHOR</h2><p>
    5266        The original Samba software and related utilities
    5367        were created by Andrew Tridgell. Samba is now developed

  • trunk/server/docs/htmldocs/manpages/idmap_tdb.8.html

    r599 r745  
    2626                        the "idmap uid" and "idmap gid" options
    2727                        from smb.conf.
    28                 </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id266838"></a><h2>EXAMPLES</h2><p>
     28                </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id266840"></a><h2>EXAMPLES</h2><p>
    2929        This example shows how tdb is used as a the default idmap backend.
    3030        It configures the idmap range through the global options for all
    … …  
    5454        idmap config DOM1 : backend = tdb
    5555        idmap config DOM1 : range = 1000000-2000000
    56         </pre></div><div class="refsect1" title="AUTHOR"><a name="id266872"></a><h2>AUTHOR</h2><p>
     56        </pre></div><div class="refsect1" title="AUTHOR"><a name="id266873"></a><h2>AUTHOR</h2><p>
    5757        The original Samba software and related utilities
    5858        were created by Andrew Tridgell. Samba is now developed

  • trunk/server/docs/htmldocs/manpages/idmap_tdb2.8.html

    r599 r745  
    2121        should have the same range as the default range, since it needs
    2222        to use the global uid / gid allocator. See the example below.
    23         </p></div><div class="refsect1" title="IDMAP OPTIONS"><a name="id266361"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">range = low - high</span></dt><dd><p>
     23        </p></div><div class="refsect1" title="IDMAP OPTIONS"><a name="id266362"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">range = low - high</span></dt><dd><p>
    2424                        Defines the available matching uid and gid range for which the
    2525                        backend is authoritative.

  • trunk/server/docs/htmldocs/manpages/index.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title></title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article"><div class="titlepage"><hr></div><div class="variablelist"><dl><dt><span class="term"><a class="ulink" href="cifs.upcall.8.html" target="_top">cifs.upcall(8)</a></span></dt><dd><p>Userspace upcall helper for Common Internet File System (CIFS)
    2 </p></dd><dt><span class="term"><a class="ulink" href="eventlogadm.8.html" target="_top">eventlogadm(8)</a></span></dt><dd><p>push records into the Samba event log store
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title></title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article"><div class="titlepage"><hr></div><div class="variablelist"><dl><dt><span class="term"><a class="ulink" href="eventlogadm.8.html" target="_top">eventlogadm(8)</a></span></dt><dd><p>push records into the Samba event log store
    32</p></dd><dt><span class="term"><a class="ulink" href="findsmb.1.html" target="_top">findsmb(1)</a></span></dt><dd><p>list info about machines that respond to SMB
    43        name queries on a subnet
    54</p></dd><dt><span class="term"><a class="ulink" href="idmap_ad.8.html" target="_top">idmap_ad(8)</a></span></dt><dd><p>Samba's idmap_ad Backend for Winbind
    65</p></dd><dt><span class="term"><a class="ulink" href="idmap_adex.8.html" target="_top">idmap_adex(8)</a></span></dt><dd><p>Samba's idmap_adex Backend for Winbind
     6</p></dd><dt><span class="term"><a class="ulink" href="idmap_autorid.8.html" target="_top">idmap_autorid(8)</a></span></dt><dd><p>Samba's idmap_autorid Backend for Winbind
    77</p></dd><dt><span class="term"><a class="ulink" href="idmap_hash.8.html" target="_top">idmap_hash(8)</a></span></dt><dd><p>Samba's idmap_hash Backend for Winbind
    88</p></dd><dt><span class="term"><a class="ulink" href="idmap_ldap.8.html" target="_top">idmap_ldap(8)</a></span></dt><dd><p>Samba's idmap_ldap Backend for Winbind
    … …  
    2121</p></dd><dt><span class="term"><a class="ulink" href="lmhosts.5.html" target="_top">lmhosts(5)</a></span></dt><dd><p>The Samba NetBIOS hosts file
    2222</p></dd><dt><span class="term"><a class="ulink" href="log2pcap.1.html" target="_top">log2pcap(1)</a></span></dt><dd><p>Extract network traces from Samba log files
    23 </p></dd><dt><span class="term"><a class="ulink" href="mount.cifs.8.html" target="_top">mount.cifs(8)</a></span></dt><dd><p>mount using the Common Internet File System (CIFS)
    2423</p></dd><dt><span class="term"><a class="ulink" href="net.8.html" target="_top">net(8)</a></span></dt><dd><p>Tool for administration of Samba and remote
    2524        CIFS servers.
    … …  
    5453</p></dd><dt><span class="term"><a class="ulink" href="smbtar.1.html" target="_top">smbtar(1)</a></span></dt><dd><p>shell script for backing up SMB/CIFS shares
    5554        directly to UNIX tape drives
     55</p></dd><dt><span class="term"><a class="ulink" href="smbta-util.8.html" target="_top">smbta-util(8)</a></span></dt><dd><p>control encryption in VFS smb_traffic_analyzer
    5656</p></dd><dt><span class="term"><a class="ulink" href="smbtree.1.html" target="_top">smbtree(1)</a></span></dt><dd><p>A text based smb network browser
    5757       
    … …  
    6262</p></dd><dt><span class="term"><a class="ulink" href="testparm.1.html" target="_top">testparm(1)</a></span></dt><dd><p>check an smb.conf configuration file for
    6363        internal correctness
    64 </p></dd><dt><span class="term"><a class="ulink" href="umount.cifs.8.html" target="_top">umount.cifs(8)</a></span></dt><dd><p>for normal, non-root users, to unmount their own Common Internet File System (CIFS) mounts
    6564</p></dd><dt><span class="term"><a class="ulink" href="vfs_acl_tdb.8.html" target="_top">vfs_acl_tdb(8)</a></span></dt><dd><p>Save NTFS-ACLs in a tdb file
    6665</p></dd><dt><span class="term"><a class="ulink" href="vfs_acl_xattr.8.html" target="_top">vfs_acl_xattr(8)</a></span></dt><dd><p>Save NTFS-ACLs in Extended Attributes (EAs)
    … …  
    7069</p></dd><dt><span class="term"><a class="ulink" href="vfs_catia.8.html" target="_top">vfs_catia(8)</a></span></dt><dd><p>translate illegal characters in Catia filenames
    7170</p></dd><dt><span class="term"><a class="ulink" href="vfs_commit.8.html" target="_top">vfs_commit(8)</a></span></dt><dd><p>flush dirty data at specified intervals
     71</p></dd><dt><span class="term"><a class="ulink" href="vfs_crossrename.8.html" target="_top">vfs_crossrename(8)</a></span></dt><dd><p>server side rename files across filesystem boundaries
    7272</p></dd><dt><span class="term"><a class="ulink" href="vfs_default_quota.8.html" target="_top">vfs_default_quota(8)</a></span></dt><dd><p>store default quota records for Windows clients
    7373</p></dd><dt><span class="term"><a class="ulink" href="vfs_dirsort.8.html" target="_top">vfs_dirsort(8)</a></span></dt><dd><p>Sort directory contents
    … …  
    9696</p></dd><dt><span class="term"><a class="ulink" href="vfs_streams_xattr.8.html" target="_top">vfs_streams_xattr(8)</a></span></dt><dd><p>Store alternate data streams in posix xattrs
    9797</p></dd><dt><span class="term"><a class="ulink" href="vfstest.1.html" target="_top">vfstest(1)</a></span></dt><dd><p>tool for testing samba VFS modules
     98</p></dd><dt><span class="term"><a class="ulink" href="vfs_time_audit.8.html" target="_top">vfs_time_audit(8)</a></span></dt><dd><p>samba vfs module to log slow VFS operations
    9899</p></dd><dt><span class="term"><a class="ulink" href="vfs_xattr_tdb.8.html" target="_top">vfs_xattr_tdb(8)</a></span></dt><dd><p>Save Extended Attributes (EAs) in a tdb file
    99100</p></dd><dt><span class="term"><a class="ulink" href="wbinfo.1.html" target="_top">wbinfo(1)</a></span></dt><dd><p>Query information from winbind daemon

  • trunk/server/docs/htmldocs/manpages/ldb.3.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ldb</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="ldb"><a name="ldb.3"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ldb<b>The Samba Project</b> &#8212; A light-weight database library</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">#include &lt;ldb.h&gt;</pre></div><div class="refsect1" title="description"><a name="id266338"></a><h2>description</h2><p>
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ldb</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="ldb"><a name="ldb.3"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ldb<b>The Samba Project</b> &#8212; A light-weight database library</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">#include &lt;ldb.h&gt;</pre></div><div class="refsect1" title="description"><a name="id266337"></a><h2>description</h2><p>
    22ldb is a light weight embedded database library and API. With a
    33programming interface that is very similar to LDAP, ldb can store its
    … …  
    3535database. Then I suggest you look at the ldb_connect(3) and
    3636ldb_search(3) manual pages.
    37         </p></div><div class="refsect1" title="TOOLS"><a name="id266833"></a><h2>TOOLS</h2><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     37        </p></div><div class="refsect1" title="TOOLS"><a name="id266832"></a><h2>TOOLS</h2><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
    3838                        <span class="application">ldbsearch(1)</span>
    3939                          - command line ldb search utility
    … …  
    5050                        <span class="application">ldbmodify(1)</span>
    5151                         - modify records in a ldb database using LDIF formatted input
    52                 </p></li></ul></div></div><div class="refsect1" title="FUNCTIONS"><a name="id266894"></a><h2>FUNCTIONS</h2><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     52                </p></li></ul></div></div><div class="refsect1" title="FUNCTIONS"><a name="id266892"></a><h2>FUNCTIONS</h2><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
    5353                        <code class="function">ldb_connect(3)</code>
    5454                         - connect to a ldb backend
    … …  
    125125                        <code class="function">ldb_set_debug_stderr(3)</code>
    126126                         - set a debug handler for stderr output
    127                 </p></li></ul></div></div><div class="refsect1" title="Author"><a name="id265958"></a><h2>Author</h2><p>
     127                </p></li></ul></div></div><div class="refsect1" title="Author"><a name="id265957"></a><h2>Author</h2><p>
    128128                ldb was written by
    129129                 <a class="ulink" href="http://samba.org/~tridge/" target="_top">Andrew Tridgell</a>.

  • trunk/server/docs/htmldocs/manpages/ldbadd.1.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ldbadd</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="ldbadd"><a name="ldbadd.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ldbadd &#8212; Command-line utility for adding records to an LDB</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">ldbadd</code> [-h] [-H LDB-URL] [ldif-file1] [ldif-file2] [...]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266834"></a><h2>DESCRIPTION</h2><p>ldbadd adds records to an ldb(7) database. It reads
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ldbadd</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="ldbadd"><a name="ldbadd.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ldbadd &#8212; Command-line utility for adding records to an LDB</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">ldbadd</code> [-h] [-H LDB-URL] [ldif-file1] [ldif-file2] [...]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266833"></a><h2>DESCRIPTION</h2><p>ldbadd adds records to an ldb(7) database. It reads
    22                the ldif(5) files specified on the command line and adds
    33                the records from these files to the LDB database, which is specified
    44                by the -H option or the LDB_URL environment variable.
    55        </p><p>If - is specified as a ldb file, the ldif input is read from
    6                 standard input.</p></div><div class="refsect1" title="OPTIONS"><a name="id266850"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h</span></dt><dd><p>
     6                standard input.</p></div><div class="refsect1" title="OPTIONS"><a name="id266848"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h</span></dt><dd><p>
    77                Show list of available options.</p></dd><dt><span class="term">-H &lt;ldb-url&gt;</span></dt><dd><p>
    88                                LDB URL to connect to. See ldb(7) for details.
    9                         </p></dd></dl></div></div><div class="refsect1" title="ENVIRONMENT"><a name="id266883"></a><h2>ENVIRONMENT</h2><div class="variablelist"><dl><dt><span class="term">LDB_URL</span></dt><dd><p>LDB URL to connect to (can be overrided by using the
     9                        </p></dd></dl></div></div><div class="refsect1" title="ENVIRONMENT"><a name="id266881"></a><h2>ENVIRONMENT</h2><div class="variablelist"><dl><dt><span class="term">LDB_URL</span></dt><dd><p>LDB URL to connect to (can be overrided by using the
    1010                                        -H command-line option.)</p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id265698"></a><h2>VERSION</h2><p>This man page is correct for version 4.0 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id265708"></a><h2>SEE ALSO</h2><p>ldb(7), ldbmodify, ldbdel, ldif(5)</p></div><div class="refsect1" title="AUTHOR"><a name="id265718"></a><h2>AUTHOR</h2><p> ldb was written by
    1111                 <a class="ulink" href="http://samba.org/~tridge/" target="_top">Andrew Tridgell</a>.

  • trunk/server/docs/htmldocs/manpages/ldbdel.1.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ldbdel</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="ldbdel"><a name="ldbdel.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ldbdel &#8212; Command-line program for deleting LDB records</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">ldbdel</code> [-h] [-H LDB-URL] [dn] [...]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266826"></a><h2>DESCRIPTION</h2><p>ldbdel deletes records from an ldb(7) database.
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ldbdel</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="ldbdel"><a name="ldbdel.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ldbdel &#8212; Command-line program for deleting LDB records</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">ldbdel</code> [-h] [-H LDB-URL] [dn] [...]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266825"></a><h2>DESCRIPTION</h2><p>ldbdel deletes records from an ldb(7) database.
    22                It deletes the records identified by the dn's specified
    33                on the command-line. </p><p>ldbdel uses either the database that is specified with
    44                the -H option or the database specified by the LDB_URL environment
    5                 variable.</p></div><div class="refsect1" title="OPTIONS"><a name="id266842"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h</span></dt><dd><p>
     5                variable.</p></div><div class="refsect1" title="OPTIONS"><a name="id266841"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h</span></dt><dd><p>
    66                Show list of available options.</p></dd><dt><span class="term">-H &lt;ldb-url&gt;</span></dt><dd><p>
    77                                LDB URL to connect to. See ldb(7) for details.
    8                         </p></dd></dl></div></div><div class="refsect1" title="ENVIRONMENT"><a name="id266876"></a><h2>ENVIRONMENT</h2><div class="variablelist"><dl><dt><span class="term">LDB_URL</span></dt><dd><p>LDB URL to connect to (can be overrided by using the
    9                                         -H command-line option.)</p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id266895"></a><h2>VERSION</h2><p>This man page is correct for version 4.0 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id265701"></a><h2>SEE ALSO</h2><p>ldb(7), ldbmodify, ldbadd, ldif(5)</p></div><div class="refsect1" title="AUTHOR"><a name="id265712"></a><h2>AUTHOR</h2><p> ldb was written by
     8                        </p></dd></dl></div></div><div class="refsect1" title="ENVIRONMENT"><a name="id266874"></a><h2>ENVIRONMENT</h2><div class="variablelist"><dl><dt><span class="term">LDB_URL</span></dt><dd><p>LDB URL to connect to (can be overrided by using the
     9                                        -H command-line option.)</p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id266894"></a><h2>VERSION</h2><p>This man page is correct for version 4.0 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id265699"></a><h2>SEE ALSO</h2><p>ldb(7), ldbmodify, ldbadd, ldif(5)</p></div><div class="refsect1" title="AUTHOR"><a name="id265710"></a><h2>AUTHOR</h2><p> ldb was written by
    1010                 <a class="ulink" href="http://samba.org/~tridge/" target="_top">Andrew Tridgell</a>.
    1111        </p><p>

  • trunk/server/docs/htmldocs/manpages/ldbmodify.1.html

    r599 r745  
    55        </p><p>For now, see ldapmodify(1) for details on the LDIF file format.</p></div><div class="refsect1" title="OPTIONS"><a name="id266826"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-H &lt;ldb-url&gt;</span></dt><dd><p>
    66                                LDB URL to connect to. See ldb(7) for details.
    7                         </p></dd></dl></div></div><div class="refsect1" title="ENVIRONMENT"><a name="id266848"></a><h2>ENVIRONMENT</h2><div class="variablelist"><dl><dt><span class="term">LDB_URL</span></dt><dd><p>LDB URL to connect to (can be overrided by using the
    8                                         -H command-line option.)</p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id266868"></a><h2>VERSION</h2><p>This man page is correct for version 4.0 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id266878"></a><h2>SEE ALSO</h2><p>ldb(7), ldbedit</p></div><div class="refsect1" title="AUTHOR"><a name="id266888"></a><h2>AUTHOR</h2><p> ldb was written by
     7                        </p></dd></dl></div></div><div class="refsect1" title="ENVIRONMENT"><a name="id266847"></a><h2>ENVIRONMENT</h2><div class="variablelist"><dl><dt><span class="term">LDB_URL</span></dt><dd><p>LDB URL to connect to (can be overrided by using the
     8                                        -H command-line option.)</p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id266867"></a><h2>VERSION</h2><p>This man page is correct for version 4.0 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id266877"></a><h2>SEE ALSO</h2><p>ldb(7), ldbedit</p></div><div class="refsect1" title="AUTHOR"><a name="id266887"></a><h2>AUTHOR</h2><p> ldb was written by
    99                 <a class="ulink" href="http://samba.org/~tridge/" target="_top">Andrew Tridgell</a>.
    1010        </p><p>

  • trunk/server/docs/htmldocs/manpages/ldbrename.1.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ldbrename</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="ldbrename"><a name="ldbrename.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ldbrename &#8212; Edit LDB databases using your favorite editor</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">ldbrename</code> [-h] [-o options] {olddn} {newdb}</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266827"></a><h2>DESCRIPTION</h2><p>ldbrename is a utility that allows you to rename trees in
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ldbrename</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="ldbrename"><a name="ldbrename.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ldbrename &#8212; Edit LDB databases using your favorite editor</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">ldbrename</code> [-h] [-o options] {olddn} {newdb}</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266825"></a><h2>DESCRIPTION</h2><p>ldbrename is a utility that allows you to rename trees in
    22                an LDB database based by DN. This utility takes
    33                two arguments: the original
    44                DN name of the top element and the DN to change it to.
    5         </p></div><div class="refsect1" title="OPTIONS"><a name="id266839"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h</span></dt><dd><p>
     5        </p></div><div class="refsect1" title="OPTIONS"><a name="id266837"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h</span></dt><dd><p>
    66                Show list of available options.</p></dd><dt><span class="term">-H &lt;ldb-url&gt;</span></dt><dd><p>
    77                                LDB URL to connect to. See ldb(7) for details.
    88                        </p></dd><dt><span class="term">-o options</span></dt><dd><p>Extra ldb options, such as
    9                         modules.</p></dd></dl></div></div><div class="refsect1" title="ENVIRONMENT"><a name="id266883"></a><h2>ENVIRONMENT</h2><div class="variablelist"><dl><dt><span class="term">LDB_URL</span></dt><dd><p>LDB URL to connect to (can be overrided by using the
    10                                         -H command-line option.)</p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id265699"></a><h2>VERSION</h2><p>This man page is correct for version 4.0 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id265709"></a><h2>SEE ALSO</h2><p>ldb(7), ldbmodify, ldbdel, ldif(5)</p></div><div class="refsect1" title="AUTHOR"><a name="id265719"></a><h2>AUTHOR</h2><p> ldb was written by
     9                        modules.</p></dd></dl></div></div><div class="refsect1" title="ENVIRONMENT"><a name="id266882"></a><h2>ENVIRONMENT</h2><div class="variablelist"><dl><dt><span class="term">LDB_URL</span></dt><dd><p>LDB URL to connect to (can be overrided by using the
     10                                        -H command-line option.)</p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id265697"></a><h2>VERSION</h2><p>This man page is correct for version 4.0 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id265707"></a><h2>SEE ALSO</h2><p>ldb(7), ldbmodify, ldbdel, ldif(5)</p></div><div class="refsect1" title="AUTHOR"><a name="id265717"></a><h2>AUTHOR</h2><p> ldb was written by
    1111                 <a class="ulink" href="http://samba.org/~tridge/" target="_top">Andrew Tridgell</a>.
    1212        </p><p>

  • trunk/server/docs/htmldocs/manpages/libsmbclient.7.html

    r599 r745  
    1515        extension of the capabilities of tools such as file managers and browsers.  This man page describes the
    1616        configuration options for this tool so that the user may obtain greatest utility of use.
    17         </p></div><div class="refsect1" title="OPTIONS"><a name="id266840"></a><h2>OPTIONS</h2><p>
     17        </p></div><div class="refsect1" title="OPTIONS"><a name="id266841"></a><h2>OPTIONS</h2><p>
    1818        What the URLs mean:
    1919        </p><div class="variablelist"><dl><dt><span class="term">smb://</span></dt><dd><p>
    … …  
    4949        </p></div><div class="refsect1" title="PROGRAMMERS GUIDE"><a name="id265757"></a><h2>PROGRAMMERS GUIDE</h2><p>
    5050        Watch this space for future updates.
    51         </p></div><div class="refsect1" title="VERSION"><a name="id265767"></a><h2>VERSION</h2><p>
     51        </p></div><div class="refsect1" title="VERSION"><a name="id265766"></a><h2>VERSION</h2><p>
    5252        This man page is correct for version 3 of the Samba suite.
    53         </p></div><div class="refsect1" title="AUTHOR"><a name="id265777"></a><h2>AUTHOR</h2><p>
     53        </p></div><div class="refsect1" title="AUTHOR"><a name="id265776"></a><h2>AUTHOR</h2><p>
    5454        The original Samba software and related utilities were created by Andrew Tridgell.
    5555        Samba is now developed by the Samba Team as an Open Source project similar to the way

  • trunk/server/docs/htmldocs/manpages/lmhosts.5.html

    r599 r745  
    2626        type for a name "NTSERVER" is queried. Any other name type will not
    2727        be resolved.</p><p>The default location of the <code class="filename">lmhosts</code> file
    28         is in the same directory as the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file.</p></div><div class="refsect1" title="FILES"><a name="id265704"></a><h2>FILES</h2><p>lmhosts is loaded from the configuration directory. This is
     28        is in the same directory as the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file.</p></div><div class="refsect1" title="FILES"><a name="id265703"></a><h2>FILES</h2><p>lmhosts is loaded from the configuration directory. This is
    2929                usually <code class="filename">/etc/samba</code> or <code class="filename">/usr/local/samba/lib</code>.
    30         </p></div><div class="refsect1" title="VERSION"><a name="id265726"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id265736"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>, <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>, and <a class="citerefentry" href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a>
    31         </p></div><div class="refsect1" title="AUTHOR"><a name="id265770"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     30        </p></div><div class="refsect1" title="VERSION"><a name="id265724"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id265734"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>, <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>, and <a class="citerefentry" href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a>
     31        </p></div><div class="refsect1" title="AUTHOR"><a name="id265769"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    3232        were created by Andrew Tridgell. Samba is now developed
    3333        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/log2pcap.1.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>log2pcap</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="log2pcap"><a name="log2pcap.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>log2pcap &#8212; Extract network traces from Samba log files</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">log2pcap</code> [-h] [-q] [logfile] [pcap_file]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266827"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">log2pcap</code> reads in a
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>log2pcap</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="log2pcap"><a name="log2pcap.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>log2pcap &#8212; Extract network traces from Samba log files</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">log2pcap</code> [-h] [-q] [logfile] [pcap_file]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266825"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">log2pcap</code> reads in a
    22        samba log file and generates a pcap file (readable
    33        by most sniffers, such as ethereal or tcpdump) based on the packet
    … …  
    66        right, <code class="constant">10</code> to get the first 512 data bytes of the
    77        packet and <code class="constant">50</code> to get the whole packet.
    8         </p></div><div class="refsect1" title="OPTIONS"><a name="id266875"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h</span></dt><dd><p>If this parameter is
     8        </p></div><div class="refsect1" title="OPTIONS"><a name="id266874"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h</span></dt><dd><p>If this parameter is
    99                specified the output file will be a
    1010                hex dump, in a format that is readable
    … …  
    1818                to stdout.
    1919                </p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    20 </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id265745"></a><h2>EXAMPLES</h2><p>Extract all network traffic from all samba log files:</p><pre class="programlisting">
     20</p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id265743"></a><h2>EXAMPLES</h2><p>Extract all network traffic from all samba log files:</p><pre class="programlisting">
    2121                        <code class="prompt">$</code> log2pcap &lt; /var/log/* &gt; trace.pcap
    2222        </pre><p>Convert to pcap using text2pcap:</p><pre class="programlisting">
    2323        <code class="prompt">$</code> log2pcap -h samba.log | text2pcap -T 139,139 - trace.pcap
    24         </pre></div><div class="refsect1" title="VERSION"><a name="id265784"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="BUGS"><a name="id265794"></a><h2>BUGS</h2><p>Only SMB data is extracted from the samba logs, no LDAP,
     24        </pre></div><div class="refsect1" title="VERSION"><a name="id265782"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="BUGS"><a name="id265792"></a><h2>BUGS</h2><p>Only SMB data is extracted from the samba logs, no LDAP,
    2525        NetBIOS lookup or other data.</p><p>The generated TCP and IP headers don't contain a valid
    26         checksum.</p></div><div class="refsect1" title="SEE ALSO"><a name="id265808"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="text2pcap.1.html"><span class="citerefentry"><span class="refentrytitle">text2pcap</span>(1)</span></a>, <a class="citerefentry" href="ethereal.1.html"><span class="citerefentry"><span class="refentrytitle">ethereal</span>(1)</span></a></p></div><div class="refsect1" title="AUTHOR"><a name="id265831"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     26        checksum.</p></div><div class="refsect1" title="SEE ALSO"><a name="id265806"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="text2pcap.1.html"><span class="citerefentry"><span class="refentrytitle">text2pcap</span>(1)</span></a>, <a class="citerefentry" href="ethereal.1.html"><span class="citerefentry"><span class="refentrytitle">ethereal</span>(1)</span></a></p></div><div class="refsect1" title="AUTHOR"><a name="id265828"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    2727        were created by Andrew Tridgell. Samba is now developed
    2828        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/net.8.html

    r599 r745  
    11<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>net</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="net"><a name="net.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>net &#8212; Tool for administration of Samba and remote
    22        CIFS servers.
    3         </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">net</code> {&lt;ads|rap|rpc&gt;} [-h] [-w workgroup] [-W myworkgroup] [-U user] [-I ip-address] [-p port] [-n myname] [-s conffile] [-S server] [-l] [-P] [-d debuglevel] [-V] [--request-timeout seconds]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id265711"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The Samba net utility is meant to work just like the net utility
     3        </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">net</code> {&lt;ads|rap|rpc&gt;} [-h] [-w workgroup] [-W myworkgroup] [-U user] [-I ip-address] [-p port] [-n myname] [-s conffile] [-S server] [-l] [-P] [-d debuglevel] [-V] [--request-timeout seconds]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id265710"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The Samba net utility is meant to work just like the net utility
    44        available for windows and DOS. The first argument should be used
    55        to specify the protocol to use when executing a certain command.
    … …  
    88        argument is omitted, net will try to determine it automatically.
    99        Not all commands are available on all protocols.
    10         </p></div><div class="refsect1" title="OPTIONS"><a name="id265737"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
     10        </p></div><div class="refsect1" title="OPTIONS"><a name="id265736"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    1111</p></dd><dt><span class="term">-w target-workgroup</span></dt><dd><p>
    1212                Sets target workgroup or domain. You have to specify
    … …  
    5858data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
    5959override the <a class="link" href="smb.conf.5.html#" target="_top"></a> parameter
    60 in the <code class="filename">smb.conf</code> file.</p></dd></dl></div></div><div class="refsect1" title="COMMANDS"><a name="id307116"></a><h2>COMMANDS</h2><div class="refsect2" title="CHANGESECRETPW"><a name="id307121"></a><h3>CHANGESECRETPW</h3><p>This command allows the Samba machine account password to be set from an external application
     60in the <code class="filename">smb.conf</code> file.</p></dd></dl></div></div><div class="refsect1" title="COMMANDS"><a name="id307116"></a><h2>COMMANDS</h2><div class="refsect2" title="CHANGESECRETPW"><a name="id307122"></a><h3>CHANGESECRETPW</h3><p>This command allows the Samba machine account password to be set from an external application
    6161to a machine account password that has already been stored in Active Directory. DO NOT USE this command
    6262unless you know exactly what you are doing. The use of this command requires that the force flag (-f)
    … …  
    6565this without care and attention as it will overwrite a legitimate machine password without warning.
    6666YOU HAVE BEEN WARNED.
    67 </p></div><div class="refsect2" title="TIME"><a name="id307136"></a><h3>TIME</h3><p>The <code class="literal">NET TIME</code> command allows you to view the time on a remote server
    68         or synchronise the time on the local server with the time on the remote server.</p><div class="refsect3" title="TIME"><a name="id307151"></a><h4>TIME</h4><p>Without any options, the <code class="literal">NET TIME</code> command
     67</p></div><div class="refsect2" title="TIME"><a name="id307137"></a><h3>TIME</h3><p>The <code class="literal">NET TIME</code> command allows you to view the time on a remote server
     68        or synchronise the time on the local server with the time on the remote server.</p><div class="refsect3" title="TIME"><a name="id307152"></a><h4>TIME</h4><p>Without any options, the <code class="literal">NET TIME</code> command
    6969displays the time on the remote server.
    7070</p></div><div class="refsect3" title="TIME SYSTEM"><a name="id307166"></a><h4>TIME SYSTEM</h4><p>Displays the time on the remote server in a format ready for <code class="literal">/bin/date</code>.</p></div><div class="refsect3" title="TIME SET"><a name="id307181"></a><h4>TIME SET</h4><p>Tries to set the date and time of the local server to that on
    71 the remote server using <code class="literal">/bin/date</code>. </p></div><div class="refsect3" title="TIME ZONE"><a name="id307196"></a><h4>TIME ZONE</h4><p>Displays the timezone in hours from GMT on the remote computer.</p></div></div><div class="refsect2" title="[RPC|ADS] JOIN [TYPE] [-U username[%password]] [createupn=UPN] [createcomputer=OU] [options]"><a name="id307206"></a><h3>[RPC|ADS] JOIN [TYPE] [-U username[%password]] [createupn=UPN] [createcomputer=OU] [options]</h3><p>
     71the remote server using <code class="literal">/bin/date</code>. </p></div><div class="refsect3" title="TIME ZONE"><a name="id307196"></a><h4>TIME ZONE</h4><p>Displays the timezone in hours from GMT on the remote computer.</p></div></div><div class="refsect2" title="[RPC|ADS] JOIN [TYPE] [-U username[%password]] [createupn=UPN] [createcomputer=OU] [options]"><a name="id307207"></a><h3>[RPC|ADS] JOIN [TYPE] [-U username[%password]] [createupn=UPN] [createcomputer=OU] [options]</h3><p>
    7272Join a domain.  If the account already exists on the server, and
    7373[TYPE] is MEMBER, the machine will attempt to join automatically.
    … …  
    8686and ldap, so it may need to be doubled or quadrupled to pass through,
    8787and it is not used as a delimiter.
    88 </p></div><div class="refsect2" title="[RPC] OLDJOIN [options]"><a name="id307233"></a><h3>[RPC] OLDJOIN [options]</h3><p>Join a domain. Use the OLDJOIN option to join the domain
     88</p></div><div class="refsect2" title="[RPC] OLDJOIN [options]"><a name="id307234"></a><h3>[RPC] OLDJOIN [options]</h3><p>Join a domain. Use the OLDJOIN option to join the domain
    8989using the old style of domain joining - you need to create a trust
    90 account in server manager first.</p></div><div class="refsect2" title="[RPC|ADS] USER"><a name="id307244"></a><h3>[RPC|ADS] USER</h3><div class="refsect3" title="[RPC|ADS] USER"><a name="id307250"></a><h4>[RPC|ADS] USER</h4><p>List all users</p></div><div class="refsect3" title="[RPC|ADS] USER DELETE target"><a name="id307259"></a><h4>[RPC|ADS] USER DELETE <em class="replaceable"><code>target</code></em></h4><p>Delete specified user</p></div><div class="refsect3" title="[RPC|ADS] USER INFO target"><a name="id307271"></a><h4>[RPC|ADS] USER INFO <em class="replaceable"><code>target</code></em></h4><p>List the domain groups of the specified user.</p></div><div class="refsect3" title="[RPC|ADS] USER RENAME oldname newname"><a name="id307283"></a><h4>[RPC|ADS] USER RENAME <em class="replaceable"><code>oldname</code></em> <em class="replaceable"><code>newname</code></em></h4><p>Rename specified user.</p></div><div class="refsect3" title="[RPC|ADS] USER ADD name [password] [-F user flags] [-C comment]"><a name="id307298"></a><h4>[RPC|ADS] USER ADD <em class="replaceable"><code>name</code></em> [password] [-F user flags] [-C comment]</h4><p>Add specified user.</p></div></div><div class="refsect2" title="[RPC|ADS] GROUP"><a name="id307312"></a><h3>[RPC|ADS] GROUP</h3><div class="refsect3" title="[RPC|ADS] GROUP [misc options] [targets]"><a name="id307317"></a><h4>[RPC|ADS] GROUP [misc options] [targets]</h4><p>List user groups.</p></div><div class="refsect3" title="[RPC|ADS] GROUP DELETE name [misc. options]"><a name="id307327"></a><h4>[RPC|ADS] GROUP DELETE <em class="replaceable"><code>name</code></em> [misc. options]</h4><p>Delete specified group.</p></div><div class="refsect3" title="[RPC|ADS] GROUP ADD name [-C comment]"><a name="id307339"></a><h4>[RPC|ADS] GROUP ADD <em class="replaceable"><code>name</code></em> [-C comment]</h4><p>Create specified group.</p></div></div><div class="refsect2" title="[RAP|RPC] SHARE"><a name="id307353"></a><h3>[RAP|RPC] SHARE</h3><div class="refsect3" title="[RAP|RPC] SHARE [misc. options] [targets]"><a name="id307359"></a><h4>[RAP|RPC] SHARE [misc. options] [targets]</h4><p>Enumerates all exported resources (network shares) on target server.</p></div><div class="refsect3" title="[RAP|RPC] SHARE ADD name=serverpath [-C comment] [-M maxusers] [targets]"><a name="id307368"></a><h4>[RAP|RPC] SHARE ADD <em class="replaceable"><code>name=serverpath</code></em> [-C comment] [-M maxusers] [targets]</h4><p>Adds a share from a server (makes the export active). Maxusers
     90account in server manager first.</p></div><div class="refsect2" title="[RPC|ADS] USER"><a name="id307245"></a><h3>[RPC|ADS] USER</h3><div class="refsect3" title="[RPC|ADS] USER"><a name="id307250"></a><h4>[RPC|ADS] USER</h4><p>List all users</p></div><div class="refsect3" title="[RPC|ADS] USER DELETE target"><a name="id307260"></a><h4>[RPC|ADS] USER DELETE <em class="replaceable"><code>target</code></em></h4><p>Delete specified user</p></div><div class="refsect3" title="[RPC|ADS] USER INFO target"><a name="id307272"></a><h4>[RPC|ADS] USER INFO <em class="replaceable"><code>target</code></em></h4><p>List the domain groups of the specified user.</p></div><div class="refsect3" title="[RPC|ADS] USER RENAME oldname newname"><a name="id307283"></a><h4>[RPC|ADS] USER RENAME <em class="replaceable"><code>oldname</code></em> <em class="replaceable"><code>newname</code></em></h4><p>Rename specified user.</p></div><div class="refsect3" title="[RPC|ADS] USER ADD name [password] [-F user flags] [-C comment]"><a name="id307298"></a><h4>[RPC|ADS] USER ADD <em class="replaceable"><code>name</code></em> [password] [-F user flags] [-C comment]</h4><p>Add specified user.</p></div></div><div class="refsect2" title="[RPC|ADS] GROUP"><a name="id307312"></a><h3>[RPC|ADS] GROUP</h3><div class="refsect3" title="[RPC|ADS] GROUP [misc options] [targets]"><a name="id307318"></a><h4>[RPC|ADS] GROUP [misc options] [targets]</h4><p>List user groups.</p></div><div class="refsect3" title="[RPC|ADS] GROUP DELETE name [misc. options]"><a name="id307327"></a><h4>[RPC|ADS] GROUP DELETE <em class="replaceable"><code>name</code></em> [misc. options]</h4><p>Delete specified group.</p></div><div class="refsect3" title="[RPC|ADS] GROUP ADD name [-C comment]"><a name="id307340"></a><h4>[RPC|ADS] GROUP ADD <em class="replaceable"><code>name</code></em> [-C comment]</h4><p>Create specified group.</p></div></div><div class="refsect2" title="[RAP|RPC] SHARE"><a name="id307354"></a><h3>[RAP|RPC] SHARE</h3><div class="refsect3" title="[RAP|RPC] SHARE [misc. options] [targets]"><a name="id307359"></a><h4>[RAP|RPC] SHARE [misc. options] [targets]</h4><p>Enumerates all exported resources (network shares) on target server.</p></div><div class="refsect3" title="[RAP|RPC] SHARE ADD name=serverpath [-C comment] [-M maxusers] [targets]"><a name="id307369"></a><h4>[RAP|RPC] SHARE ADD <em class="replaceable"><code>name=serverpath</code></em> [-C comment] [-M maxusers] [targets]</h4><p>Adds a share from a server (makes the export active). Maxusers
    9191specifies the number of users that can be connected to the
    92 share simultaneously.</p></div><div class="refsect3" title="SHARE DELETE sharename"><a name="id307382"></a><h4>SHARE DELETE <em class="replaceable"><code>sharename</code></em></h4><p>Delete specified share.</p></div></div><div class="refsect2" title="[RPC|RAP] FILE"><a name="id307395"></a><h3>[RPC|RAP] FILE</h3><div class="refsect3" title="[RPC|RAP] FILE"><a name="id307400"></a><h4>[RPC|RAP] FILE</h4><p>List all open files on remote server.</p></div><div class="refsect3" title="[RPC|RAP] FILE CLOSE fileid"><a name="id307410"></a><h4>[RPC|RAP] FILE CLOSE <em class="replaceable"><code>fileid</code></em></h4><p>Close file with specified <em class="replaceable"><code>fileid</code></em> on
    93 remote server.</p></div><div class="refsect3" title="[RPC|RAP] FILE INFO fileid"><a name="id307425"></a><h4>[RPC|RAP] FILE INFO <em class="replaceable"><code>fileid</code></em></h4><p>
     92share simultaneously.</p></div><div class="refsect3" title="SHARE DELETE sharename"><a name="id307383"></a><h4>SHARE DELETE <em class="replaceable"><code>sharename</code></em></h4><p>Delete specified share.</p></div></div><div class="refsect2" title="[RPC|RAP] FILE"><a name="id307396"></a><h3>[RPC|RAP] FILE</h3><div class="refsect3" title="[RPC|RAP] FILE"><a name="id307401"></a><h4>[RPC|RAP] FILE</h4><p>List all open files on remote server.</p></div><div class="refsect3" title="[RPC|RAP] FILE CLOSE fileid"><a name="id307411"></a><h4>[RPC|RAP] FILE CLOSE <em class="replaceable"><code>fileid</code></em></h4><p>Close file with specified <em class="replaceable"><code>fileid</code></em> on
     93remote server.</p></div><div class="refsect3" title="[RPC|RAP] FILE INFO fileid"><a name="id307426"></a><h4>[RPC|RAP] FILE INFO <em class="replaceable"><code>fileid</code></em></h4><p>
    9494Print information on specified <em class="replaceable"><code>fileid</code></em>.
    9595Currently listed are: file-id, username, locks, path, permissions.
    … …  
    9898Please note that <code class="literal">net rap file user</code> does not work
    9999against Samba servers.
    100 </p></div></div><div class="refsect2" title="SESSION"><a name="id307461"></a><h3>SESSION</h3><div class="refsect3" title="RAP SESSION"><a name="id307466"></a><h4>RAP SESSION</h4><p>Without any other options, SESSION enumerates all active SMB/CIFS
    101 sessions on the target server.</p></div><div class="refsect3" title="RAP SESSION DELETE|CLOSE CLIENT_NAME"><a name="id307477"></a><h4>RAP SESSION DELETE|CLOSE <em class="replaceable"><code>CLIENT_NAME</code></em></h4><p>Close the specified sessions.</p></div><div class="refsect3" title="RAP SESSION INFO CLIENT_NAME"><a name="id307489"></a><h4>RAP SESSION INFO <em class="replaceable"><code>CLIENT_NAME</code></em></h4><p>Give a list with all the open files in specified session.</p></div></div><div class="refsect2" title="RAP SERVER DOMAIN"><a name="id307502"></a><h3>RAP SERVER <em class="replaceable"><code>DOMAIN</code></em></h3><p>List all servers in specified domain or workgroup. Defaults
    102 to local domain.</p></div><div class="refsect2" title="RAP DOMAIN"><a name="id307514"></a><h3>RAP DOMAIN</h3><p>Lists all domains and workgroups visible on the
    103 current network.</p></div><div class="refsect2" title="RAP PRINTQ"><a name="id307524"></a><h3>RAP PRINTQ</h3><div class="refsect3" title="RAP PRINTQ INFO QUEUE_NAME"><a name="id307529"></a><h4>RAP PRINTQ INFO <em class="replaceable"><code>QUEUE_NAME</code></em></h4><p>Lists the specified print queue and print jobs on the server.
     100</p></div></div><div class="refsect2" title="SESSION"><a name="id307462"></a><h3>SESSION</h3><div class="refsect3" title="RAP SESSION"><a name="id307467"></a><h4>RAP SESSION</h4><p>Without any other options, SESSION enumerates all active SMB/CIFS
     101sessions on the target server.</p></div><div class="refsect3" title="RAP SESSION DELETE|CLOSE CLIENT_NAME"><a name="id307478"></a><h4>RAP SESSION DELETE|CLOSE <em class="replaceable"><code>CLIENT_NAME</code></em></h4><p>Close the specified sessions.</p></div><div class="refsect3" title="RAP SESSION INFO CLIENT_NAME"><a name="id307489"></a><h4>RAP SESSION INFO <em class="replaceable"><code>CLIENT_NAME</code></em></h4><p>Give a list with all the open files in specified session.</p></div></div><div class="refsect2" title="RAP SERVER DOMAIN"><a name="id307502"></a><h3>RAP SERVER <em class="replaceable"><code>DOMAIN</code></em></h3><p>List all servers in specified domain or workgroup. Defaults
     102to local domain.</p></div><div class="refsect2" title="RAP DOMAIN"><a name="id307515"></a><h3>RAP DOMAIN</h3><p>Lists all domains and workgroups visible on the
     103current network.</p></div><div class="refsect2" title="RAP PRINTQ"><a name="id307524"></a><h3>RAP PRINTQ</h3><div class="refsect3" title="RAP PRINTQ INFO QUEUE_NAME"><a name="id307530"></a><h4>RAP PRINTQ INFO <em class="replaceable"><code>QUEUE_NAME</code></em></h4><p>Lists the specified print queue and print jobs on the server.
    104104If the <em class="replaceable"><code>QUEUE_NAME</code></em> is omitted, all
    105 queues are listed.</p></div><div class="refsect3" title="RAP PRINTQ DELETE JOBID"><a name="id307545"></a><h4>RAP PRINTQ DELETE <em class="replaceable"><code>JOBID</code></em></h4><p>Delete job with specified id.</p></div></div><div class="refsect2" title="RAP VALIDATE user [password]"><a name="id307557"></a><h3>RAP VALIDATE <em class="replaceable"><code>user</code></em> [<em class="replaceable"><code>password</code></em>]</h3><p>
     105queues are listed.</p></div><div class="refsect3" title="RAP PRINTQ DELETE JOBID"><a name="id307545"></a><h4>RAP PRINTQ DELETE <em class="replaceable"><code>JOBID</code></em></h4><p>Delete job with specified id.</p></div></div><div class="refsect2" title="RAP VALIDATE user [password]"><a name="id307558"></a><h3>RAP VALIDATE <em class="replaceable"><code>user</code></em> [<em class="replaceable"><code>password</code></em>]</h3><p>
    106106Validate whether the specified user can log in to the
    107107remote server. If the password is not specified on the commandline, it
    108108will be prompted.
    109 </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div><div class="refsect2" title="RAP GROUPMEMBER"><a name="id307579"></a><h3>RAP GROUPMEMBER</h3><div class="refsect3" title="RAP GROUPMEMBER LIST GROUP"><a name="id307584"></a><h4>RAP GROUPMEMBER LIST <em class="replaceable"><code>GROUP</code></em></h4><p>List all members of the specified group.</p></div><div class="refsect3" title="RAP GROUPMEMBER DELETE GROUP USER"><a name="id307596"></a><h4>RAP GROUPMEMBER DELETE <em class="replaceable"><code>GROUP</code></em> <em class="replaceable"><code>USER</code></em></h4><p>Delete member from group.</p></div><div class="refsect3" title="RAP GROUPMEMBER ADD GROUP USER"><a name="id307611"></a><h4>RAP GROUPMEMBER ADD <em class="replaceable"><code>GROUP</code></em> <em class="replaceable"><code>USER</code></em></h4><p>Add member to group.</p></div></div><div class="refsect2" title="RAP ADMIN command"><a name="id307627"></a><h3>RAP ADMIN <em class="replaceable"><code>command</code></em></h3><p>Execute the specified <em class="replaceable"><code>command</code></em> on
     109</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div><div class="refsect2" title="RAP GROUPMEMBER"><a name="id307580"></a><h3>RAP GROUPMEMBER</h3><div class="refsect3" title="RAP GROUPMEMBER LIST GROUP"><a name="id307585"></a><h4>RAP GROUPMEMBER LIST <em class="replaceable"><code>GROUP</code></em></h4><p>List all members of the specified group.</p></div><div class="refsect3" title="RAP GROUPMEMBER DELETE GROUP USER"><a name="id307597"></a><h4>RAP GROUPMEMBER DELETE <em class="replaceable"><code>GROUP</code></em> <em class="replaceable"><code>USER</code></em></h4><p>Delete member from group.</p></div><div class="refsect3" title="RAP GROUPMEMBER ADD GROUP USER"><a name="id307612"></a><h4>RAP GROUPMEMBER ADD <em class="replaceable"><code>GROUP</code></em> <em class="replaceable"><code>USER</code></em></h4><p>Add member to group.</p></div></div><div class="refsect2" title="RAP ADMIN command"><a name="id307628"></a><h3>RAP ADMIN <em class="replaceable"><code>command</code></em></h3><p>Execute the specified <em class="replaceable"><code>command</code></em> on
    110110the remote server. Only works with OS/2 servers.
    111 </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div><div class="refsect2" title="RAP SERVICE"><a name="id307646"></a><h3>RAP SERVICE</h3><div class="refsect3" title="RAP SERVICE START NAME [arguments...]"><a name="id307652"></a><h4>RAP SERVICE START <em class="replaceable"><code>NAME</code></em> [arguments...]</h4><p>Start the specified service on the remote server. Not implemented yet.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div><div class="refsect3" title="RAP SERVICE STOP"><a name="id307669"></a><h4>RAP SERVICE STOP</h4><p>Stop the specified service on the remote server.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div></div><div class="refsect2" title="RAP PASSWORD USER OLDPASS NEWPASS"><a name="id307684"></a><h3>RAP PASSWORD <em class="replaceable"><code>USER</code></em> <em class="replaceable"><code>OLDPASS</code></em> <em class="replaceable"><code>NEWPASS</code></em></h3><p>
     111</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div><div class="refsect2" title="RAP SERVICE"><a name="id307647"></a><h3>RAP SERVICE</h3><div class="refsect3" title="RAP SERVICE START NAME [arguments...]"><a name="id307652"></a><h4>RAP SERVICE START <em class="replaceable"><code>NAME</code></em> [arguments...]</h4><p>Start the specified service on the remote server. Not implemented yet.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div><div class="refsect3" title="RAP SERVICE STOP"><a name="id307670"></a><h4>RAP SERVICE STOP</h4><p>Stop the specified service on the remote server.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div></div><div class="refsect2" title="RAP PASSWORD USER OLDPASS NEWPASS"><a name="id307685"></a><h3>RAP PASSWORD <em class="replaceable"><code>USER</code></em> <em class="replaceable"><code>OLDPASS</code></em> <em class="replaceable"><code>NEWPASS</code></em></h3><p>
    112112Change password of <em class="replaceable"><code>USER</code></em> from <em class="replaceable"><code>OLDPASS</code></em> to <em class="replaceable"><code>NEWPASS</code></em>.
    113 </p></div><div class="refsect2" title="LOOKUP"><a name="id307712"></a><h3>LOOKUP</h3><div class="refsect3" title="LOOKUP HOST HOSTNAME [TYPE]"><a name="id307717"></a><h4>LOOKUP HOST <em class="replaceable"><code>HOSTNAME</code></em> [<em class="replaceable"><code>TYPE</code></em>]</h4><p>
     113</p></div><div class="refsect2" title="LOOKUP"><a name="id307712"></a><h3>LOOKUP</h3><div class="refsect3" title="LOOKUP HOST HOSTNAME [TYPE]"><a name="id307718"></a><h4>LOOKUP HOST <em class="replaceable"><code>HOSTNAME</code></em> [<em class="replaceable"><code>TYPE</code></em>]</h4><p>
    114114Lookup the IP address of the given host with the specified type (netbios suffix).
    115115The type defaults to 0x20 (workstation).
    116 </p></div><div class="refsect3" title="LOOKUP LDAP [DOMAIN]"><a name="id307734"></a><h4>LOOKUP LDAP [<em class="replaceable"><code>DOMAIN</code></em>]</h4><p>Give IP address of LDAP server of specified <em class="replaceable"><code>DOMAIN</code></em>. Defaults to local domain.</p></div><div class="refsect3" title="LOOKUP KDC [REALM]"><a name="id307750"></a><h4>LOOKUP KDC [<em class="replaceable"><code>REALM</code></em>]</h4><p>Give IP address of KDC for the specified <em class="replaceable"><code>REALM</code></em>.
    117 Defaults to local realm.</p></div><div class="refsect3" title="LOOKUP DC [DOMAIN]"><a name="id307766"></a><h4>LOOKUP DC [<em class="replaceable"><code>DOMAIN</code></em>]</h4><p>Give IP's of Domain Controllers for specified <em class="replaceable"><code>
    118 DOMAIN</code></em>. Defaults to local domain.</p></div><div class="refsect3" title="LOOKUP MASTER DOMAIN"><a name="id307782"></a><h4>LOOKUP MASTER <em class="replaceable"><code>DOMAIN</code></em></h4><p>Give IP of master browser for specified <em class="replaceable"><code>DOMAIN</code></em>
    119 or workgroup. Defaults to local domain.</p></div></div><div class="refsect2" title="CACHE"><a name="id307798"></a><h3>CACHE</h3><p>Samba uses a general caching interface called 'gencache'. It
     116</p></div><div class="refsect3" title="LOOKUP LDAP [DOMAIN]"><a name="id307735"></a><h4>LOOKUP LDAP [<em class="replaceable"><code>DOMAIN</code></em>]</h4><p>Give IP address of LDAP server of specified <em class="replaceable"><code>DOMAIN</code></em>. Defaults to local domain.</p></div><div class="refsect3" title="LOOKUP KDC [REALM]"><a name="id307751"></a><h4>LOOKUP KDC [<em class="replaceable"><code>REALM</code></em>]</h4><p>Give IP address of KDC for the specified <em class="replaceable"><code>REALM</code></em>.
     117Defaults to local realm.</p></div><div class="refsect3" title="LOOKUP DC [DOMAIN]"><a name="id307767"></a><h4>LOOKUP DC [<em class="replaceable"><code>DOMAIN</code></em>]</h4><p>Give IP's of Domain Controllers for specified <em class="replaceable"><code>
     118DOMAIN</code></em>. Defaults to local domain.</p></div><div class="refsect3" title="LOOKUP MASTER DOMAIN"><a name="id307783"></a><h4>LOOKUP MASTER <em class="replaceable"><code>DOMAIN</code></em></h4><p>Give IP of master browser for specified <em class="replaceable"><code>DOMAIN</code></em>
     119or workgroup. Defaults to local domain.</p></div></div><div class="refsect2" title="CACHE"><a name="id307799"></a><h3>CACHE</h3><p>Samba uses a general caching interface called 'gencache'. It
    120120can be controlled using 'NET CACHE'.</p><p>All the timeout parameters support the suffixes:
    121121
    122122</p><table border="0" summary="Simple list" class="simplelist"><tr><td>s - Seconds</td></tr><tr><td>m - Minutes</td></tr><tr><td>h - Hours</td></tr><tr><td>d - Days</td></tr><tr><td>w - Weeks</td></tr></table><p>
    123123
    124 </p><div class="refsect3" title="CACHE ADD key data time-out"><a name="id307832"></a><h4>CACHE ADD <em class="replaceable"><code>key</code></em> <em class="replaceable"><code>data</code></em> <em class="replaceable"><code>time-out</code></em></h4><p>Add specified key+data to the cache with the given timeout.</p></div><div class="refsect3" title="CACHE DEL key"><a name="id307851"></a><h4>CACHE DEL <em class="replaceable"><code>key</code></em></h4><p>Delete key from the cache.</p></div><div class="refsect3" title="CACHE SET key data time-out"><a name="id307863"></a><h4>CACHE SET <em class="replaceable"><code>key</code></em> <em class="replaceable"><code>data</code></em> <em class="replaceable"><code>time-out</code></em></h4><p>Update data of existing cache entry.</p></div><div class="refsect3" title="CACHE SEARCH PATTERN"><a name="id307881"></a><h4>CACHE SEARCH <em class="replaceable"><code>PATTERN</code></em></h4><p>Search for the specified pattern in the cache data.</p></div><div class="refsect3" title="CACHE LIST"><a name="id307893"></a><h4>CACHE LIST</h4><p>
     124</p><div class="refsect3" title="CACHE ADD key data time-out"><a name="id307833"></a><h4>CACHE ADD <em class="replaceable"><code>key</code></em> <em class="replaceable"><code>data</code></em> <em class="replaceable"><code>time-out</code></em></h4><p>Add specified key+data to the cache with the given timeout.</p></div><div class="refsect3" title="CACHE DEL key"><a name="id307852"></a><h4>CACHE DEL <em class="replaceable"><code>key</code></em></h4><p>Delete key from the cache.</p></div><div class="refsect3" title="CACHE SET key data time-out"><a name="id307863"></a><h4>CACHE SET <em class="replaceable"><code>key</code></em> <em class="replaceable"><code>data</code></em> <em class="replaceable"><code>time-out</code></em></h4><p>Update data of existing cache entry.</p></div><div class="refsect3" title="CACHE SEARCH PATTERN"><a name="id307882"></a><h4>CACHE SEARCH <em class="replaceable"><code>PATTERN</code></em></h4><p>Search for the specified pattern in the cache data.</p></div><div class="refsect3" title="CACHE LIST"><a name="id307893"></a><h4>CACHE LIST</h4><p>
    125125List all current items in the cache.
    126 </p></div><div class="refsect3" title="CACHE FLUSH"><a name="id307902"></a><h4>CACHE FLUSH</h4><p>Remove all the current items from the cache.</p></div></div><div class="refsect2" title="GETLOCALSID [DOMAIN]"><a name="id307913"></a><h3>GETLOCALSID [DOMAIN]</h3><p>Prints the SID of the specified domain, or if the parameter is
    127 omitted, the SID of the local server.</p></div><div class="refsect2" title="SETLOCALSID S-1-5-21-x-y-z"><a name="id307924"></a><h3>SETLOCALSID S-1-5-21-x-y-z</h3><p>Sets SID for the local server to the specified SID.</p></div><div class="refsect2" title="GETDOMAINSID"><a name="id307933"></a><h3>GETDOMAINSID</h3><p>Prints the local machine SID and the SID of the current
    128 domain.</p></div><div class="refsect2" title="SETDOMAINSID"><a name="id307943"></a><h3>SETDOMAINSID</h3><p>Sets the SID of the current domain.</p></div><div class="refsect2" title="GROUPMAP"><a name="id307953"></a><h3>GROUPMAP</h3><p>Manage the mappings between Windows group SIDs and UNIX groups.
     126</p></div><div class="refsect3" title="CACHE FLUSH"><a name="id307903"></a><h4>CACHE FLUSH</h4><p>Remove all the current items from the cache.</p></div></div><div class="refsect2" title="GETLOCALSID [DOMAIN]"><a name="id307914"></a><h3>GETLOCALSID [DOMAIN]</h3><p>Prints the SID of the specified domain, or if the parameter is
     127omitted, the SID of the local server.</p></div><div class="refsect2" title="SETLOCALSID S-1-5-21-x-y-z"><a name="id307924"></a><h3>SETLOCALSID S-1-5-21-x-y-z</h3><p>Sets SID for the local server to the specified SID.</p></div><div class="refsect2" title="GETDOMAINSID"><a name="id307934"></a><h3>GETDOMAINSID</h3><p>Prints the local machine SID and the SID of the current
     128domain.</p></div><div class="refsect2" title="SETDOMAINSID"><a name="id307944"></a><h3>SETDOMAINSID</h3><p>Sets the SID of the current domain.</p></div><div class="refsect2" title="GROUPMAP"><a name="id307954"></a><h3>GROUPMAP</h3><p>Manage the mappings between Windows group SIDs and UNIX groups.
    129129Common options include:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>unixgroup - Name of the UNIX group</p></li><li class="listitem"><p>ntgroup - Name of the Windows NT group (must be
    130130  resolvable to a SID</p></li><li class="listitem"><p>rid - Unsigned 32-bit integer</p></li><li class="listitem"><p>sid - Full SID in the form of "S-1-..."</p></li><li class="listitem"><p>type - Type of the group; either 'domain', 'local',
    131   or 'builtin'</p></li><li class="listitem"><p>comment - Freeform text description of the group</p></li></ul></div><div class="refsect3" title="GROUPMAP ADD"><a name="id307992"></a><h4>GROUPMAP ADD</h4><p>
     131  or 'builtin'</p></li><li class="listitem"><p>comment - Freeform text description of the group</p></li></ul></div><div class="refsect3" title="GROUPMAP ADD"><a name="id307993"></a><h4>GROUPMAP ADD</h4><p>
    132132Add a new group mapping entry:
    133133</p><pre class="programlisting">
    … …  
    135135        [type={domain|local}] [ntgroup=string] [comment=string]
    136136</pre><p>
    137 </p></div><div class="refsect3" title="GROUPMAP DELETE"><a name="id308008"></a><h4>GROUPMAP DELETE</h4><p>Delete a group mapping entry. If more than one group name matches, the first entry found is deleted.</p><p>net groupmap delete {ntgroup=string|sid=SID}</p></div><div class="refsect3" title="GROUPMAP MODIFY"><a name="id308022"></a><h4>GROUPMAP MODIFY</h4><p>Update en existing group entry.</p><p>
     137</p></div><div class="refsect3" title="GROUPMAP DELETE"><a name="id308009"></a><h4>GROUPMAP DELETE</h4><p>Delete a group mapping entry. If more than one group name matches, the first entry found is deleted.</p><p>net groupmap delete {ntgroup=string|sid=SID}</p></div><div class="refsect3" title="GROUPMAP MODIFY"><a name="id308023"></a><h4>GROUPMAP MODIFY</h4><p>Update en existing group entry.</p><p>
    138138</p><pre class="programlisting">
    139139net groupmap modify {ntgroup=string|sid=SID} [unixgroup=string] \
    140140       [comment=string] [type={domain|local}]
    141141</pre><p>
    142 </p></div><div class="refsect3" title="GROUPMAP LIST"><a name="id308041"></a><h4>GROUPMAP LIST</h4><p>List existing group mapping entries.</p><p>net groupmap list [verbose] [ntgroup=string] [sid=SID]</p></div></div><div class="refsect2" title="MAXRID"><a name="id308055"></a><h3>MAXRID</h3><p>Prints out the highest RID currently in use on the local
     142</p></div><div class="refsect3" title="GROUPMAP LIST"><a name="id308042"></a><h4>GROUPMAP LIST</h4><p>List existing group mapping entries.</p><p>net groupmap list [verbose] [ntgroup=string] [sid=SID]</p></div></div><div class="refsect2" title="MAXRID"><a name="id308056"></a><h3>MAXRID</h3><p>Prints out the highest RID currently in use on the local
    143143server (by the active 'passdb backend').
    144144</p></div><div class="refsect2" title="RPC INFO"><a name="id308066"></a><h3>RPC INFO</h3><p>Print information about the domain of the remote server,
    145145such as domain name, domain sid and number of users and groups.
    146 </p></div><div class="refsect2" title="[RPC|ADS] TESTJOIN"><a name="id308076"></a><h3>[RPC|ADS] TESTJOIN</h3><p>Check whether participation in a domain is still valid.</p></div><div class="refsect2" title="[RPC|ADS] CHANGETRUSTPW"><a name="id308086"></a><h3>[RPC|ADS] CHANGETRUSTPW</h3><p>Force change of domain trust password.</p></div><div class="refsect2" title="RPC TRUSTDOM"><a name="id308096"></a><h3>RPC TRUSTDOM</h3><div class="refsect3" title="RPC TRUSTDOM ADD DOMAIN"><a name="id308101"></a><h4>RPC TRUSTDOM ADD <em class="replaceable"><code>DOMAIN</code></em></h4><p>Add a interdomain trust account for <em class="replaceable"><code>DOMAIN</code></em>.
     146</p></div><div class="refsect2" title="[RPC|ADS] TESTJOIN"><a name="id308077"></a><h3>[RPC|ADS] TESTJOIN</h3><p>Check whether participation in a domain is still valid.</p></div><div class="refsect2" title="[RPC|ADS] CHANGETRUSTPW"><a name="id308086"></a><h3>[RPC|ADS] CHANGETRUSTPW</h3><p>Force change of domain trust password.</p></div><div class="refsect2" title="RPC TRUSTDOM"><a name="id308096"></a><h3>RPC TRUSTDOM</h3><div class="refsect3" title="RPC TRUSTDOM ADD DOMAIN"><a name="id308101"></a><h4>RPC TRUSTDOM ADD <em class="replaceable"><code>DOMAIN</code></em></h4><p>Add a interdomain trust account for <em class="replaceable"><code>DOMAIN</code></em>.
    147147This is in fact a Samba account named <em class="replaceable"><code>DOMAIN$</code></em>
    148148with the account flag <code class="constant">'I'</code> (interdomain trust account).
    … …  
    156156<em class="replaceable"><code>DOMAIN</code></em>. If it is used against localhost
    157157it has the same effect as <code class="literal">smbpasswd -x DOMAIN$</code>.
    158 </p></div><div class="refsect3" title="RPC TRUSTDOM ESTABLISH DOMAIN"><a name="id308151"></a><h4>RPC TRUSTDOM ESTABLISH <em class="replaceable"><code>DOMAIN</code></em></h4><p>
     158</p></div><div class="refsect3" title="RPC TRUSTDOM ESTABLISH DOMAIN"><a name="id308152"></a><h4>RPC TRUSTDOM ESTABLISH <em class="replaceable"><code>DOMAIN</code></em></h4><p>
    159159Establish a trust relationship to a trusted domain.
    160160Interdomain account must already be created on the remote PDC.
    … …  
    164164You'll need winbind and a working idmap config to make them
    165165appear in your system.
    166 </p></div><div class="refsect3" title="RPC TRUSTDOM REVOKE DOMAIN"><a name="id308166"></a><h4>RPC TRUSTDOM REVOKE <em class="replaceable"><code>DOMAIN</code></em></h4><p>Abandon relationship to trusted domain</p></div><div class="refsect3" title="RPC TRUSTDOM LIST"><a name="id308178"></a><h4>RPC TRUSTDOM LIST</h4><p>List all interdomain trust relationships.</p></div><div class="refsect3" title="RPC RIGHTS"><a name="id308188"></a><h4>RPC RIGHTS</h4><p>This subcommand is used to view and manage Samba's rights assignments (also
     166</p></div><div class="refsect3" title="RPC TRUSTDOM REVOKE DOMAIN"><a name="id308167"></a><h4>RPC TRUSTDOM REVOKE <em class="replaceable"><code>DOMAIN</code></em></h4><p>Abandon relationship to trusted domain</p></div><div class="refsect3" title="RPC TRUSTDOM LIST"><a name="id308179"></a><h4>RPC TRUSTDOM LIST</h4><p>List all interdomain trust relationships.</p></div><div class="refsect3" title="RPC RIGHTS"><a name="id308188"></a><h4>RPC RIGHTS</h4><p>This subcommand is used to view and manage Samba's rights assignments (also
    167167referred to as privileges).  There are three options currently available:
    168168<em class="parameter"><code>list</code></em>, <em class="parameter"><code>grant</code></em>, and
    169169<em class="parameter"><code>revoke</code></em>.  More details on Samba's privilege model and its use
    170 can be found in the Samba-HOWTO-Collection.</p></div></div><div class="refsect2" title="RPC ABORTSHUTDOWN"><a name="id308216"></a><h3>RPC ABORTSHUTDOWN</h3><p>Abort the shutdown of a remote server.</p></div><div class="refsect2" title="RPC SHUTDOWN [-t timeout] [-r] [-f] [-C message]"><a name="id308226"></a><h3>RPC SHUTDOWN [-t timeout] [-r] [-f] [-C message]</h3><p>Shut down the remote server.</p><div class="variablelist"><dl><dt><span class="term">-r</span></dt><dd><p>
     170can be found in the Samba-HOWTO-Collection.</p></div></div><div class="refsect2" title="RPC ABORTSHUTDOWN"><a name="id308217"></a><h3>RPC ABORTSHUTDOWN</h3><p>Abort the shutdown of a remote server.</p></div><div class="refsect2" title="RPC SHUTDOWN [-t timeout] [-r] [-f] [-C message]"><a name="id308227"></a><h3>RPC SHUTDOWN [-t timeout] [-r] [-f] [-C message]</h3><p>Shut down the remote server.</p><div class="variablelist"><dl><dt><span class="term">-r</span></dt><dd><p>
    171171Reboot after shutdown.
    172172</p></dd><dt><span class="term">-f</span></dt><dd><p>
    … …  
    176176user of the system can use this time to cancel the shutdown.
    177177</p></dd><dt><span class="term">-C message</span></dt><dd><p>Display the specified message on the screen to
    178 announce the shutdown.</p></dd></dl></div></div><div class="refsect2" title="RPC SAMDUMP"><a name="id308283"></a><h3>RPC SAMDUMP</h3><p>Print out sam database of remote server. You need
     178announce the shutdown.</p></dd></dl></div></div><div class="refsect2" title="RPC SAMDUMP"><a name="id308284"></a><h3>RPC SAMDUMP</h3><p>Print out sam database of remote server. You need
    179179to run this against the PDC, from a Samba machine joined as a BDC. </p></div><div class="refsect2" title="RPC VAMPIRE"><a name="id308294"></a><h3>RPC VAMPIRE</h3><p>Export users, aliases and groups from remote server to
    180180local server.  You need to run this against the PDC, from a Samba machine joined as a BDC.
    181181</p></div><div class="refsect2" title="RPC VAMPIRE KEYTAB"><a name="id308305"></a><h3>RPC VAMPIRE KEYTAB</h3><p>Dump remote SAM database to local Kerberos keytab file.
    182 </p></div><div class="refsect2" title="RPC VAMPIRE LDIF"><a name="id308315"></a><h3>RPC VAMPIRE LDIF</h3><p>Dump remote SAM database to local LDIF file or standard output.
    183 </p></div><div class="refsect2" title="RPC GETSID"><a name="id308325"></a><h3>RPC GETSID</h3><p>Fetch domain SID and store it in the local <code class="filename">secrets.tdb</code>. </p></div><div class="refsect2" title="ADS LEAVE"><a name="id308340"></a><h3>ADS LEAVE</h3><p>Make the remote host leave the domain it is part of. </p></div><div class="refsect2" title="ADS STATUS"><a name="id308350"></a><h3>ADS STATUS</h3><p>Print out status of machine account of the local machine in ADS.
     182</p></div><div class="refsect2" title="RPC VAMPIRE LDIF"><a name="id308316"></a><h3>RPC VAMPIRE LDIF</h3><p>Dump remote SAM database to local LDIF file or standard output.
     183</p></div><div class="refsect2" title="RPC GETSID"><a name="id308326"></a><h3>RPC GETSID</h3><p>Fetch domain SID and store it in the local <code class="filename">secrets.tdb</code>. </p></div><div class="refsect2" title="ADS LEAVE"><a name="id308341"></a><h3>ADS LEAVE</h3><p>Make the remote host leave the domain it is part of. </p></div><div class="refsect2" title="ADS STATUS"><a name="id308350"></a><h3>ADS STATUS</h3><p>Print out status of machine account of the local machine in ADS.
    184184Prints out quite some debug info. Aimed at developers, regular
    185 users should use <code class="literal">NET ADS TESTJOIN</code>.</p></div><div class="refsect2" title="ADS PRINTER"><a name="id308366"></a><h3>ADS PRINTER</h3><div class="refsect3" title="ADS PRINTER INFO [PRINTER] [SERVER]"><a name="id308371"></a><h4>ADS PRINTER INFO [<em class="replaceable"><code>PRINTER</code></em>] [<em class="replaceable"><code>SERVER</code></em>]</h4><p>
     185users should use <code class="literal">NET ADS TESTJOIN</code>.</p></div><div class="refsect2" title="ADS PRINTER"><a name="id308366"></a><h3>ADS PRINTER</h3><div class="refsect3" title="ADS PRINTER INFO [PRINTER] [SERVER]"><a name="id308372"></a><h4>ADS PRINTER INFO [<em class="replaceable"><code>PRINTER</code></em>] [<em class="replaceable"><code>SERVER</code></em>]</h4><p>
    186186Lookup info for <em class="replaceable"><code>PRINTER</code></em> on <em class="replaceable"><code>SERVER</code></em>. The printer name defaults to "*", the
    187 server name defaults to the local host.</p></div><div class="refsect3" title="ADS PRINTER PUBLISH PRINTER"><a name="id308394"></a><h4>ADS PRINTER PUBLISH <em class="replaceable"><code>PRINTER</code></em></h4><p>Publish specified printer using ADS.</p></div><div class="refsect3" title="ADS PRINTER REMOVE PRINTER"><a name="id308406"></a><h4>ADS PRINTER REMOVE <em class="replaceable"><code>PRINTER</code></em></h4><p>Remove specified printer from ADS directory.</p></div></div><div class="refsect2" title="ADS SEARCH EXPRESSION ATTRIBUTES..."><a name="id308419"></a><h3>ADS SEARCH <em class="replaceable"><code>EXPRESSION</code></em> <em class="replaceable"><code>ATTRIBUTES...</code></em></h3><p>Perform a raw LDAP search on a ADS server and dump the results. The
     187server name defaults to the local host.</p></div><div class="refsect3" title="ADS PRINTER PUBLISH PRINTER"><a name="id308395"></a><h4>ADS PRINTER PUBLISH <em class="replaceable"><code>PRINTER</code></em></h4><p>Publish specified printer using ADS.</p></div><div class="refsect3" title="ADS PRINTER REMOVE PRINTER"><a name="id308407"></a><h4>ADS PRINTER REMOVE <em class="replaceable"><code>PRINTER</code></em></h4><p>Remove specified printer from ADS directory.</p></div></div><div class="refsect2" title="ADS SEARCH EXPRESSION ATTRIBUTES..."><a name="id308420"></a><h3>ADS SEARCH <em class="replaceable"><code>EXPRESSION</code></em> <em class="replaceable"><code>ATTRIBUTES...</code></em></h3><p>Perform a raw LDAP search on a ADS server and dump the results. The
    188188expression is a standard LDAP search expression, and the
    189189attributes are a list of LDAP fields to show in the results.</p><p>Example: <strong class="userinput"><code>net ads search '(objectCategory=group)' sAMAccountName</code></strong>
    190 </p></div><div class="refsect2" title="ADS DN DN (attributes)"><a name="id308444"></a><h3>ADS DN <em class="replaceable"><code>DN</code></em> <em class="replaceable"><code>(attributes)</code></em></h3><p>
     190</p></div><div class="refsect2" title="ADS DN DN (attributes)"><a name="id308445"></a><h3>ADS DN <em class="replaceable"><code>DN</code></em> <em class="replaceable"><code>(attributes)</code></em></h3><p>
    191191Perform a raw LDAP search on a ADS server and dump the results. The
    192192DN standard LDAP DN, and the attributes are a list of LDAP fields
    193193to show in the result.
    194 </p><p>Example: <strong class="userinput"><code>net ads dn 'CN=administrator,CN=Users,DC=my,DC=domain' SAMAccountName</code></strong></p></div><div class="refsect2" title="ADS WORKGROUP"><a name="id308468"></a><h3>ADS WORKGROUP</h3><p>Print out workgroup name for specified kerberos realm.</p></div><div class="refsect2" title="SAM CREATEBUILTINGROUP &lt;NAME&gt;"><a name="id308478"></a><h3>SAM CREATEBUILTINGROUP &lt;NAME&gt;</h3><p>
     194</p><p>Example: <strong class="userinput"><code>net ads dn 'CN=administrator,CN=Users,DC=my,DC=domain' SAMAccountName</code></strong></p></div><div class="refsect2" title="ADS WORKGROUP"><a name="id308469"></a><h3>ADS WORKGROUP</h3><p>Print out workgroup name for specified kerberos realm.</p></div><div class="refsect2" title="SAM CREATEBUILTINGROUP &lt;NAME&gt;"><a name="id308479"></a><h3>SAM CREATEBUILTINGROUP &lt;NAME&gt;</h3><p>
    195195(Re)Create a BUILTIN group.
    196196Only a wellknown set of BUILTIN groups can be created with this command.
    … …  
    207207This command requires a running Winbindd with idmap allocation properly
    208208configured. The group gid will be allocated out of the winbindd range.
    209 </p></div><div class="refsect2" title="SAM DELETELOCALGROUP &lt;NAME&gt;"><a name="id308503"></a><h3>SAM DELETELOCALGROUP &lt;NAME&gt;</h3><p>
     209</p></div><div class="refsect2" title="SAM DELETELOCALGROUP &lt;NAME&gt;"><a name="id308504"></a><h3>SAM DELETELOCALGROUP &lt;NAME&gt;</h3><p>
    210210Delete an existing LOCAL group (also known as Alias).
    211211
    212 </p></div><div class="refsect2" title="SAM MAPUNIXGROUP &lt;NAME&gt;"><a name="id308513"></a><h3>SAM MAPUNIXGROUP &lt;NAME&gt;</h3><p>
     212</p></div><div class="refsect2" title="SAM MAPUNIXGROUP &lt;NAME&gt;"><a name="id308514"></a><h3>SAM MAPUNIXGROUP &lt;NAME&gt;</h3><p>
    213213Map an existing Unix group and make it a Domain Group, the domain group
    214214will have the same name.
    … …  
    221221Remove a member from a Local group. The group and the member must be
    222222specified by name.
    223 </p></div><div class="refsect2" title="SAM LISTMEM &lt;GROUP&gt;"><a name="id308556"></a><h3>SAM LISTMEM &lt;GROUP&gt;</h3><p>
     223</p></div><div class="refsect2" title="SAM LISTMEM &lt;GROUP&gt;"><a name="id308557"></a><h3>SAM LISTMEM &lt;GROUP&gt;</h3><p>
    224224List Local group members. The group must be specified by name.
    225 </p></div><div class="refsect2" title="SAM LIST &lt;users|groups|localgroups|builtin|workstations&gt; [verbose]"><a name="id308566"></a><h3>SAM LIST &lt;users|groups|localgroups|builtin|workstations&gt; [verbose]</h3><p>
     225</p></div><div class="refsect2" title="SAM LIST &lt;users|groups|localgroups|builtin|workstations&gt; [verbose]"><a name="id308567"></a><h3>SAM LIST &lt;users|groups|localgroups|builtin|workstations&gt; [verbose]</h3><p>
    226226List the specified set of accounts by name. If verbose is specified,
    227227the rid and description is also provided for each account.
    228 </p></div><div class="refsect2" title="SAM RIGHTS LIST"><a name="id308578"></a><h3>SAM RIGHTS LIST</h3><p>
     228</p></div><div class="refsect2" title="SAM RIGHTS LIST"><a name="id308579"></a><h3>SAM RIGHTS LIST</h3><p>
    229229List all available privileges.
    230230</p></div><div class="refsect2" title="SAM RIGHTS GRANT &lt;NAME&gt; &lt;PRIVILEGE&gt;"><a name="id308588"></a><h3>SAM RIGHTS GRANT &lt;NAME&gt; &lt;PRIVILEGE&gt;</h3><p>
    … …  
    232232</p></div><div class="refsect2" title="SAM RIGHTS REVOKE &lt;NAME&gt; &lt;PRIVILEGE&gt;"><a name="id308598"></a><h3>SAM RIGHTS REVOKE &lt;NAME&gt; &lt;PRIVILEGE&gt;</h3><p>
    233233Revoke one or more privileges from a user.
    234 </p></div><div class="refsect2" title="SAM SHOW &lt;NAME&gt;"><a name="id308607"></a><h3>SAM SHOW &lt;NAME&gt;</h3><p>
     234</p></div><div class="refsect2" title="SAM SHOW &lt;NAME&gt;"><a name="id308608"></a><h3>SAM SHOW &lt;NAME&gt;</h3><p>
    235235Show the full DOMAIN\\NAME the SID and the type for the corresponding
    236236account.
    237237</p></div><div class="refsect2" title="SAM SET HOMEDIR &lt;NAME&gt; &lt;DIRECTORY&gt;"><a name="id308618"></a><h3>SAM SET HOMEDIR &lt;NAME&gt; &lt;DIRECTORY&gt;</h3><p>
    238238Set the home directory for a user account.
    239 </p></div><div class="refsect2" title="SAM SET PROFILEPATH &lt;NAME&gt; &lt;PATH&gt;"><a name="id308627"></a><h3>SAM SET PROFILEPATH &lt;NAME&gt; &lt;PATH&gt;</h3><p>
     239</p></div><div class="refsect2" title="SAM SET PROFILEPATH &lt;NAME&gt; &lt;PATH&gt;"><a name="id308628"></a><h3>SAM SET PROFILEPATH &lt;NAME&gt; &lt;PATH&gt;</h3><p>
    240240Set the profile path for a user account.
    241241</p></div><div class="refsect2" title="SAM SET COMMENT &lt;NAME&gt; &lt;COMMENT&gt;"><a name="id308637"></a><h3>SAM SET COMMENT &lt;NAME&gt; &lt;COMMENT&gt;</h3><p>
    242242Set the comment for a user or group account.
    243 </p></div><div class="refsect2" title="SAM SET FULLNAME &lt;NAME&gt; &lt;FULL NAME&gt;"><a name="id308646"></a><h3>SAM SET FULLNAME &lt;NAME&gt; &lt;FULL NAME&gt;</h3><p>
     243</p></div><div class="refsect2" title="SAM SET FULLNAME &lt;NAME&gt; &lt;FULL NAME&gt;"><a name="id308647"></a><h3>SAM SET FULLNAME &lt;NAME&gt; &lt;FULL NAME&gt;</h3><p>
    244244Set the full name for a user account.
    245245</p></div><div class="refsect2" title="SAM SET LOGONSCRIPT &lt;NAME&gt; &lt;SCRIPT&gt;"><a name="id308656"></a><h3>SAM SET LOGONSCRIPT &lt;NAME&gt; &lt;SCRIPT&gt;</h3><p>
    … …  
    247247</p></div><div class="refsect2" title="SAM SET HOMEDRIVE &lt;NAME&gt; &lt;DRIVE&gt;"><a name="id308666"></a><h3>SAM SET HOMEDRIVE &lt;NAME&gt; &lt;DRIVE&gt;</h3><p>
    248248Set the home drive for a user account.
    249 </p></div><div class="refsect2" title="SAM SET WORKSTATIONS &lt;NAME&gt; &lt;WORKSTATIONS&gt;"><a name="id308675"></a><h3>SAM SET WORKSTATIONS &lt;NAME&gt; &lt;WORKSTATIONS&gt;</h3><p>
     249</p></div><div class="refsect2" title="SAM SET WORKSTATIONS &lt;NAME&gt; &lt;WORKSTATIONS&gt;"><a name="id308676"></a><h3>SAM SET WORKSTATIONS &lt;NAME&gt; &lt;WORKSTATIONS&gt;</h3><p>
    250250Set the workstations a user account is allowed to log in from.
    251 </p></div><div class="refsect2" title="SAM SET DISABLE &lt;NAME&gt;"><a name="id308685"></a><h3>SAM SET DISABLE &lt;NAME&gt;</h3><p>
     251</p></div><div class="refsect2" title="SAM SET DISABLE &lt;NAME&gt;"><a name="id308686"></a><h3>SAM SET DISABLE &lt;NAME&gt;</h3><p>
    252252Set the "disabled" flag for a user account.
    253 </p></div><div class="refsect2" title="SAM SET PWNOTREQ &lt;NAME&gt;"><a name="id308695"></a><h3>SAM SET PWNOTREQ &lt;NAME&gt;</h3><p>
     253</p></div><div class="refsect2" title="SAM SET PWNOTREQ &lt;NAME&gt;"><a name="id308696"></a><h3>SAM SET PWNOTREQ &lt;NAME&gt;</h3><p>
    254254Set the "password not required" flag for a user account.
    255 </p></div><div class="refsect2" title="SAM SET AUTOLOCK &lt;NAME&gt;"><a name="id308705"></a><h3>SAM SET AUTOLOCK &lt;NAME&gt;</h3><p>
     255</p></div><div class="refsect2" title="SAM SET AUTOLOCK &lt;NAME&gt;"><a name="id308706"></a><h3>SAM SET AUTOLOCK &lt;NAME&gt;</h3><p>
    256256Set the "autolock" flag for a user account.
    257257</p></div><div class="refsect2" title="SAM SET PWNOEXP &lt;NAME&gt;"><a name="id308715"></a><h3>SAM SET PWNOEXP &lt;NAME&gt;</h3><p>
    258258Set the "password do not expire" flag for a user account.
    259 </p></div><div class="refsect2" title="SAM SET PWDMUSTCHANGENOW &lt;NAME&gt; [yes|no]"><a name="id308725"></a><h3>SAM SET PWDMUSTCHANGENOW &lt;NAME&gt; [yes|no]</h3><p>
     259</p></div><div class="refsect2" title="SAM SET PWDMUSTCHANGENOW &lt;NAME&gt; [yes|no]"><a name="id308726"></a><h3>SAM SET PWDMUSTCHANGENOW &lt;NAME&gt; [yes|no]</h3><p>
    260260Set or unset the "password must change" flag for a user account.
    261 </p></div><div class="refsect2" title="SAM POLICY LIST"><a name="id308735"></a><h3>SAM POLICY LIST</h3><p>
     261</p></div><div class="refsect2" title="SAM POLICY LIST"><a name="id308736"></a><h3>SAM POLICY LIST</h3><p>
    262262List the available account policies.
    263 </p></div><div class="refsect2" title="SAM POLICY SHOW &lt;account policy&gt;"><a name="id308745"></a><h3>SAM POLICY SHOW &lt;account policy&gt;</h3><p>
     263</p></div><div class="refsect2" title="SAM POLICY SHOW &lt;account policy&gt;"><a name="id308746"></a><h3>SAM POLICY SHOW &lt;account policy&gt;</h3><p>
    264264Show the account policy value.
    265265</p></div><div class="refsect2" title="SAM POLICY SET &lt;account policy&gt; &lt;value&gt;"><a name="id308755"></a><h3>SAM POLICY SET &lt;account policy&gt; &lt;value&gt;</h3><p>
    … …  
    273273Dumps the mappings contained in the local tdb file specified.
    274274This command is useful to dump only the mappings produced by the idmap_tdb backend.
    275 </p></div><div class="refsect2" title="IDMAP RESTORE [input file]"><a name="id308789"></a><h3>IDMAP RESTORE [input file]</h3><p>
     275</p></div><div class="refsect2" title="IDMAP RESTORE [input file]"><a name="id308790"></a><h3>IDMAP RESTORE [input file]</h3><p>
    276276Restore the mappings from the specified file or stdin.
    277 </p></div><div class="refsect2" title="IDMAP SECRET &lt;DOMAIN&gt;|ALLOC &lt;secret&gt;"><a name="id308800"></a><h3>IDMAP SECRET &lt;DOMAIN&gt;|ALLOC &lt;secret&gt;</h3><p>
     277</p></div><div class="refsect2" title="IDMAP SECRET &lt;DOMAIN&gt; &lt;secret&gt;"><a name="id308800"></a><h3>IDMAP SECRET &lt;DOMAIN&gt; &lt;secret&gt;</h3><p>
    278278Store a secret for the specified domain, used primarily for domains
    279279that use idmap_ldap as a backend. In this case the secret is used
    280280as the password for the user DN used to bind to the ldap server.
    281 </p></div><div class="refsect2" title="USERSHARE"><a name="id308812"></a><h3>USERSHARE</h3><p>Starting with version 3.0.23, a Samba server now supports the ability for
     281</p></div><div class="refsect2" title="IDMAP DELETE [-f] [--db=&lt;DB&gt;] &lt;ID&gt;"><a name="id308812"></a><h3>IDMAP DELETE [-f] [--db=&lt;DB&gt;] &lt;ID&gt;</h3><p>
     282Delete a mapping sid &lt;-&gt; gid or sid &lt;-&gt; uid from the IDMAP database.
     283The mapping is given by &lt;ID&gt; which may either be a sid: S-x-..., a gid: "GID number" or a uid: "UID number".
     284Use -f to delete an invalid partial mapping &lt;ID&gt; -&gt; xx
     285</p><p>
     286  Use "smbcontrol all idmap ..." to notify running smbd instances.
     287  See the <a class="citerefentry" href="smbcontrol.1.html"><span class="citerefentry"><span class="refentrytitle">smbcontrol</span>(1)</span></a> manpage for details.
     288</p></div><div class="refsect2" title="USERSHARE"><a name="id308839"></a><h3>USERSHARE</h3><p>Starting with version 3.0.23, a Samba server now supports the ability for
    282289non-root users to add user defined shares to be exported using the "net usershare"
    283290commands.
    … …  
    308315</p><table border="0" summary="Simple list" class="simplelist"><tr><td>net usershare add sharename path [comment [acl] [guest_ok=[y|n]]] - to add or change a user defined share.</td></tr><tr><td>net usershare delete sharename - to delete a user defined share.</td></tr><tr><td>net usershare info [-l|--long] [wildcard sharename] - to print info about a user defined share.</td></tr><tr><td>net usershare list [-l|--long] [wildcard sharename] - to list user defined shares.</td></tr></table><p>
    309316
    310 </p><div class="refsect3" title="USERSHARE ADD sharename path [comment] [acl] [guest_ok=[y|n]]"><a name="id308857"></a><h4>USERSHARE ADD <em class="replaceable"><code>sharename</code></em> <em class="replaceable"><code>path</code></em> <em class="replaceable"><code>[comment]</code></em> <em class="replaceable"><code>[acl]</code></em> <em class="replaceable"><code>[guest_ok=[y|n]]</code></em></h4><p>
     317</p><div class="refsect3" title="USERSHARE ADD sharename path [comment] [acl] [guest_ok=[y|n]]"><a name="id308884"></a><h4>USERSHARE ADD <em class="replaceable"><code>sharename</code></em> <em class="replaceable"><code>path</code></em> <em class="replaceable"><code>[comment]</code></em> <em class="replaceable"><code>[acl]</code></em> <em class="replaceable"><code>[guest_ok=[y|n]]</code></em></h4><p>
    311318Add or replace a new user defined share, with name "sharename".
    312319</p><p>
    … …  
    345352at connect time so will see the change immediately, there is no need
    346353to restart smbd on adding, deleting or changing a user defined share.
    347 </div><div class="refsect3" title="USERSHARE DELETE sharename"><a name="id308914"></a><h4>USERSHARE DELETE <em class="replaceable"><code>sharename</code></em></h4><p>
     354</div><div class="refsect3" title="USERSHARE DELETE sharename"><a name="id308945"></a><h4>USERSHARE DELETE <em class="replaceable"><code>sharename</code></em></h4><p>
    348355Deletes the user defined share by name. The Samba smbd daemon
    349356immediately notices this change, although it will not disconnect
    350357any users currently connected to the deleted share.
    351 </p></div><div class="refsect3" title="USERSHARE INFO [-l|--long] [wildcard sharename]"><a name="id308927"></a><h4>USERSHARE INFO <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>[wildcard sharename]</code></em></h4><p>
     358</p></div><div class="refsect3" title="USERSHARE INFO [-l|--long] [wildcard sharename]"><a name="id308958"></a><h4>USERSHARE INFO <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>[wildcard sharename]</code></em></h4><p>
    352359Get info on user defined shares owned by the current user matching the given pattern, or all users.
    353360</p><p>
    … …  
    368375And is a list of the current settings of the user defined share that can be
    369376modified by the "net usershare add" command.
    370 </p></div><div class="refsect3" title="USERSHARE LIST [-l|--long] wildcard sharename"><a name="id308955"></a><h4>USERSHARE LIST <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>wildcard sharename</code></em></h4><p>
     377</p></div><div class="refsect3" title="USERSHARE LIST [-l|--long] wildcard sharename"><a name="id308986"></a><h4>USERSHARE LIST <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>wildcard sharename</code></em></h4><p>
    371378List all the user defined shares owned by the current user matching the given pattern, or all users.
    372379</p><p>
    … …  
    376383If the '-l' or '--long' option is also given, it includes the names of user defined
    377384shares created by other users.
    378 </p></div></div><div class="refsect2" title="CONF"><a name="id308978"></a><h3>CONF</h3><p>Starting with version 3.2.0, a Samba server can be configured by data
     385</p></div></div><div class="refsect2" title="CONF"><a name="id309009"></a><h3>CONF</h3><p>Starting with version 3.2.0, a Samba server can be configured by data
    379386stored in registry. This configuration data can be edited with the new "net
    380387conf" commands.
    … …  
    394401format.</td></tr><tr><td>net conf listshares - List the registry shares.</td></tr><tr><td>net conf drop - Delete the complete configuration from
    395402registry.</td></tr><tr><td>net conf showshare - Show the definition of a registry share.</td></tr><tr><td>net conf addshare - Create a new registry share.</td></tr><tr><td>net conf delshare - Delete a registry share.</td></tr><tr><td>net conf setparm - Store a parameter.</td></tr><tr><td>net conf getparm - Retrieve the value of a parameter.</td></tr><tr><td>net conf delparm - Delete a parameter.</td></tr><tr><td>net conf getincludes - Show the includes of a share definition.</td></tr><tr><td>net conf setincludes - Set includes for a share.</td></tr><tr><td>net conf delincludes - Delete includes from a share definition.</td></tr></table><p>
    396 </p><div class="refsect3" title="CONF LIST"><a name="id309083"></a><h4>CONF LIST</h4><p>
     403</p><div class="refsect3" title="CONF LIST"><a name="id309114"></a><h4>CONF LIST</h4><p>
    397404Print the configuration data stored in the registry in a smb.conf-like format to
    398405standard output.
    399 </p></div><div class="refsect3" title="CONF IMPORT [--test|-T] filename [section]"><a name="id309093"></a><h4>CONF IMPORT <em class="replaceable"><code>[--test|-T]</code></em> <em class="replaceable"><code>filename</code></em> <em class="replaceable"><code>[section]</code></em></h4><p>
     406</p></div><div class="refsect3" title="CONF IMPORT [--test|-T] filename [section]"><a name="id309124"></a><h4>CONF IMPORT <em class="replaceable"><code>[--test|-T]</code></em> <em class="replaceable"><code>filename</code></em> <em class="replaceable"><code>[section]</code></em></h4><p>
    400407This command imports configuration from a file in smb.conf format.
    401408If a section encountered in the input file is present in registry,
    … …  
    407414the parameter "-T" on the commandline. In test mode, no changes are made to the
    408415registry, and the resulting configuration is printed to standard output instead.
    409 </p></div><div class="refsect3" title="CONF LISTSHARES"><a name="id309117"></a><h4>CONF LISTSHARES</h4><p>
     416</p></div><div class="refsect3" title="CONF LISTSHARES"><a name="id309148"></a><h4>CONF LISTSHARES</h4><p>
    410417List the names of the shares defined in registry.
    411 </p></div><div class="refsect3" title="CONF DROP"><a name="id309127"></a><h4>CONF DROP</h4><p>
     418</p></div><div class="refsect3" title="CONF DROP"><a name="id309158"></a><h4>CONF DROP</h4><p>
    412419Delete the complete configuration data from registry.
    413 </p></div><div class="refsect3" title="CONF SHOWSHARE sharename"><a name="id309136"></a><h4>CONF SHOWSHARE <em class="replaceable"><code>sharename</code></em></h4><p>
     420</p></div><div class="refsect3" title="CONF SHOWSHARE sharename"><a name="id309167"></a><h4>CONF SHOWSHARE <em class="replaceable"><code>sharename</code></em></h4><p>
    414421Show the definition of the share or section specified. It is valid to specify
    415422"global" as sharename to retrieve the global configuration options from
    416423registry.
    417 </p></div><div class="refsect3" title="CONF ADDSHARE sharename path [writeable={y|N} [guest_ok={y|N} [comment]]]"><a name="id309150"></a><h4>CONF ADDSHARE <em class="replaceable"><code>sharename</code></em> <em class="replaceable"><code>path</code></em> [<em class="replaceable"><code>writeable={y|N}</code></em> [<em class="replaceable"><code>guest_ok={y|N}</code></em> [<em class="replaceable"><code>comment</code></em>]]] </h4><p>Create a new share definition in registry.
     424</p></div><div class="refsect3" title="CONF ADDSHARE sharename path [writeable={y|N} [guest_ok={y|N} [comment]]]"><a name="id309180"></a><h4>CONF ADDSHARE <em class="replaceable"><code>sharename</code></em> <em class="replaceable"><code>path</code></em> [<em class="replaceable"><code>writeable={y|N}</code></em> [<em class="replaceable"><code>guest_ok={y|N}</code></em> [<em class="replaceable"><code>comment</code></em>]]] </h4><p>Create a new share definition in registry.
    418425The sharename and path have to be given. The share name may
    419426<span class="emphasis"><em>not</em></span> be "global". Optionally, values for the very
    … …  
    421428The same result may be obtained by a sequence of "net conf setparm"
    422429commands.
    423 </p></div><div class="refsect3" title="CONF DELSHARE sharename"><a name="id309181"></a><h4>CONF DELSHARE <em class="replaceable"><code>sharename</code></em></h4><p>
     430</p></div><div class="refsect3" title="CONF DELSHARE sharename"><a name="id309212"></a><h4>CONF DELSHARE <em class="replaceable"><code>sharename</code></em></h4><p>
    424431Delete a share definition from registry.
    425 </p></div><div class="refsect3" title="CONF SETPARM section parameter value"><a name="id309193"></a><h4>CONF SETPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em> <em class="replaceable"><code>value</code></em></h4><p>
     432</p></div><div class="refsect3" title="CONF SETPARM section parameter value"><a name="id309224"></a><h4>CONF SETPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em> <em class="replaceable"><code>value</code></em></h4><p>
    426433Store a parameter in registry. The section may be global or a sharename.
    427434The section is created if it does not exist yet.
    428 </p></div><div class="refsect3" title="CONF GETPARM section parameter"><a name="id309212"></a><h4>CONF GETPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em></h4><p>
     435</p></div><div class="refsect3" title="CONF GETPARM section parameter"><a name="id309243"></a><h4>CONF GETPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em></h4><p>
    429436Show a parameter stored in registry.
    430 </p></div><div class="refsect3" title="CONF DELPARM section parameter"><a name="id309227"></a><h4>CONF DELPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em></h4><p>
     437</p></div><div class="refsect3" title="CONF DELPARM section parameter"><a name="id309258"></a><h4>CONF DELPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em></h4><p>
    431438Delete a parameter stored in registry.
    432 </p></div><div class="refsect3" title="CONF GETINCLUDES section"><a name="id309242"></a><h4>CONF GETINCLUDES <em class="replaceable"><code>section</code></em></h4><p>
     439</p></div><div class="refsect3" title="CONF GETINCLUDES section"><a name="id309273"></a><h4>CONF GETINCLUDES <em class="replaceable"><code>section</code></em></h4><p>
    433440Get the list of includes for the provided section (global or share).
    434441</p><p>
    … …  
    446453configuration. In the future, there will be the ability to include configuration
    447454data from other registry keys.
    448 </p></div><div class="refsect3" title="CONF SETINCLUDES section [filename]+"><a name="id309269"></a><h4>CONF SETINCLUDES <em class="replaceable"><code>section</code></em> [<em class="replaceable"><code>filename</code></em>]+</h4><p>
     455</p></div><div class="refsect3" title="CONF SETINCLUDES section [filename]+"><a name="id265639"></a><h4>CONF SETINCLUDES <em class="replaceable"><code>section</code></em> [<em class="replaceable"><code>filename</code></em>]+</h4><p>
    449456Set the list of includes for the provided section (global or share) to the given
    450457list of one or more filenames. The filenames may contain the usual smb.conf
    451458macros like %I.
    452 </p></div><div class="refsect3" title="CONF DELINCLUDES section"><a name="id309286"></a><h4>CONF DELINCLUDES <em class="replaceable"><code>section</code></em></h4><p>
     459</p></div><div class="refsect3" title="CONF DELINCLUDES section"><a name="id265657"></a><h4>CONF DELINCLUDES <em class="replaceable"><code>section</code></em></h4><p>
    453460Delete the list of includes from the provided section (global or share).
    454 </p></div></div><div class="refsect2" title="EVENTLOG"><a name="id309300"></a><h3>EVENTLOG</h3><p>Starting with version 3.4.0 net can read, dump, import and export native
     461</p></div></div><div class="refsect2" title="REGISTRY"><a name="id265671"></a><h3>REGISTRY</h3><p>
     462Manipulate Samba's registry.
     463</p><p>The registry commands are:
     464</p><table border="0" summary="Simple list" class="simplelist"><tr><td>net registry enumerate   - Enumerate registry keys and values.</td></tr><tr><td>net registry createkey   - Create a new registry key.</td></tr><tr><td>net registry deletekey   - Delete a registry key.</td></tr><tr><td>net registry getvalue    - Print a registry value.</td></tr><tr><td>net registry getvalueraw - Print a registry value (raw format).</td></tr><tr><td>net registry setvalue    - Set a new registry value.</td></tr><tr><td>net registry increment   - Increment a DWORD registry value under a lock.
     465</td></tr><tr><td>net registry deletevalue - Delete a registry value.</td></tr><tr><td>net registry getsd       - Get security descriptor.</td></tr><tr><td>net registry getsd_sdd1  - Get security descriptor in sddl format.
     466</td></tr><tr><td>net registry setsd_sdd1  - Set security descriptor from sddl format
     467string.</td></tr><tr><td>net registry import      - Import a registration entries (.reg) file.
     468</td></tr><tr><td>net registry export      - Export a registration entries (.reg) file.
     469</td></tr><tr><td>net registry convert     - Convert a registration entries (.reg) file.
     470</td></tr></table><p>
     471</p><div class="refsect3" title="REGISTRY ENUMERATE key"><a name="id309469"></a><h4>REGISTRY ENUMERATE <em class="replaceable"><code>key</code></em> </h4><p>Enumerate subkeys and values of <span class="emphasis"><em>key</em></span>
     472  </p></div><div class="refsect3" title="REGISTRY CREATEKEY key"><a name="id309485"></a><h4>REGISTRY CREATEKEY <em class="replaceable"><code>key</code></em> </h4><p>Create a new <span class="emphasis"><em>key</em></span> if not yet existing.
     473  </p></div><div class="refsect3" title="REGISTRY DELETEKEY key"><a name="id309501"></a><h4>REGISTRY DELETEKEY <em class="replaceable"><code>key</code></em> </h4><p>Delete the given <span class="emphasis"><em>key</em></span> and all of its
     474  subkeys and values from the registry.
     475  </p></div><div class="refsect3" title="REGISTRY GETVALUE key name"><a name="id309517"></a><h4>REGISTRY GETVALUE <em class="replaceable"><code>key</code></em> <em class="replaceable"><code>name</code></em></h4><p>Output type and actual value of the value <span class="emphasis"><em>name</em></span>
     476  of the given <span class="emphasis"><em>key</em></span>.
     477  </p></div><div class="refsect3" title="REGISTRY GETVALUERAW key name"><a name="id309540"></a><h4>REGISTRY GETVALUERAW <em class="replaceable"><code>key</code></em> <em class="replaceable"><code>name</code></em></h4><p>Output the actual value of the value <span class="emphasis"><em>name</em></span>
     478  of the given <span class="emphasis"><em>key</em></span>.
     479  </p></div><div class="refsect3" title="REGISTRY SETVALUE key name type value ..."><a name="id309562"></a><h4>REGISTRY SETVALUE <em class="replaceable"><code>key</code></em> <em class="replaceable"><code>name</code></em> <em class="replaceable"><code>type</code></em> <em class="replaceable"><code>value</code></em> ...</h4><p>Set the value <span class="emphasis"><em>name</em></span>
     480  of an existing <span class="emphasis"><em>key</em></span>.
     481  <span class="emphasis"><em>type</em></span> may be one of
     482  <span class="emphasis"><em>sz</em></span>, <span class="emphasis"><em>multi_sz</em></span> or
     483  <span class="emphasis"><em>dword</em></span>.
     484  In case of <span class="emphasis"><em>multi_sz</em></span> <em class="replaceable"><code>value</code></em> may
     485  be given multiple times.
     486  </p></div><div class="refsect3" title="REGISTRY INCREMENT key name [inc]"><a name="id309613"></a><h4>REGISTRY INCREMENT <em class="replaceable"><code>key</code></em> <em class="replaceable"><code>name</code></em> <em class="replaceable"><code>[inc]</code></em></h4><p>Increment the DWORD value <span class="emphasis"><em>name</em></span>
     487  of <span class="emphasis"><em>key</em></span> by <em class="replaceable"><code>inc</code></em>
     488  while holding a g_lock.
     489  <span class="emphasis"><em>inc</em></span> defaults to 1.
     490  </p></div><div class="refsect3" title="REGISTRY DELETEVALUE key name"><a name="id309646"></a><h4>REGISTRY DELETEVALUE <em class="replaceable"><code>key</code></em> <em class="replaceable"><code>name</code></em></h4><p>Delete the value <span class="emphasis"><em>name</em></span>
     491  of the given <span class="emphasis"><em>key</em></span>.
     492  </p></div><div class="refsect3" title="REGISTRY GETSD key"><a name="id309669"></a><h4>REGISTRY GETSD <em class="replaceable"><code>key</code></em></h4><p>Get the security descriptor of the given <span class="emphasis"><em>key</em></span>.
     493  </p></div><div class="refsect3" title="REGISTRY GETSD_SDDL key"><a name="id309684"></a><h4>REGISTRY GETSD_SDDL <em class="replaceable"><code>key</code></em></h4><p>Get the security descriptor of the given <span class="emphasis"><em>key</em></span> as a
     494  Security Descriptor Definition Language (SDDL) string.
     495  </p></div><div class="refsect3" title="REGISTRY SETSD_SDDL keysd"><a name="id309699"></a><h4>REGISTRY SETSD_SDDL <em class="replaceable"><code>key</code></em><em class="replaceable"><code>sd</code></em></h4><p>Set the security descriptor of the given <span class="emphasis"><em>key</em></span> from a
     496  Security Descriptor Definition Language (SDDL) string <span class="emphasis"><em>sd</em></span>.
     497  </p></div><div class="refsect3" title="REGISTRY IMPORT file[opt]"><a name="id309721"></a><h4>REGISTRY IMPORT <em class="replaceable"><code>file</code></em><em class="replaceable"><code>[opt]</code></em></h4><p>Import a registration entries (.reg) <span class="emphasis"><em>file</em></span>.
     498  </p></div><div class="refsect3" title="REGISTRY EXPORT keyfile[opt]"><a name="id309739"></a><h4>REGISTRY EXPORT <em class="replaceable"><code>key</code></em><em class="replaceable"><code>file</code></em><em class="replaceable"><code>[opt]</code></em></h4><p>Export a <span class="emphasis"><em>key</em></span> to a registration entries (.reg)
     499  <span class="emphasis"><em>file</em></span>.
     500  </p></div><div class="refsect3" title="REGISTRY CONVERT in out [[inopt] outopt]"><a name="id309764"></a><h4>REGISTRY CONVERT <em class="replaceable"><code>in</code></em> <em class="replaceable"><code>out</code></em> <em class="replaceable"><code>[[inopt] outopt]</code></em></h4><p>Convert a registration entries (.reg) file <span class="emphasis"><em>in</em></span>.
     501  </p></div></div><div class="refsect2" title="EVENTLOG"><a name="id309788"></a><h3>EVENTLOG</h3><p>Starting with version 3.4.0 net can read, dump, import and export native
    455502win32 eventlog files (usually *.evt). evt files are used by the native Windows eventviewer tools.
    456503</p><p>
    … …  
    462509tdb based representation of eventlogs.</td></tr><tr><td>net eventlog export - Export the samba internal tdb based representation
    463510of eventlogs into an eventlog *.evt file.</td></tr></table><p>
    464 </p><div class="refsect3" title="EVENTLOG DUMP filename"><a name="id309350"></a><h4>EVENTLOG DUMP <em class="replaceable"><code>filename</code></em></h4><p>
     511</p><div class="refsect3" title="EVENTLOG DUMP filename"><a name="id309839"></a><h4>EVENTLOG DUMP <em class="replaceable"><code>filename</code></em></h4><p>
    465512Prints a eventlog *.evt file to standard output.
    466 </p></div><div class="refsect3" title="EVENTLOG IMPORT filename eventlog"><a name="id309362"></a><h4>EVENTLOG IMPORT <em class="replaceable"><code>filename</code></em> <em class="replaceable"><code>eventlog</code></em></h4><p>
     513</p></div><div class="refsect3" title="EVENTLOG IMPORT filename eventlog"><a name="id309851"></a><h4>EVENTLOG IMPORT <em class="replaceable"><code>filename</code></em> <em class="replaceable"><code>eventlog</code></em></h4><p>
    467514Imports a eventlog *.evt file defined by <em class="replaceable"><code>filename</code></em> into the
    468515samba internal tdb representation of eventlog defined by <em class="replaceable"><code>eventlog</code></em>.
    … …  
    470517defined in smb.conf.
    471518See the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> manpage for details.
    472 </p></div><div class="refsect3" title="EVENTLOG EXPORT filename eventlog"><a name="id309400"></a><h4>EVENTLOG EXPORT <em class="replaceable"><code>filename</code></em> <em class="replaceable"><code>eventlog</code></em></h4><p>
     519</p></div><div class="refsect3" title="EVENTLOG EXPORT filename eventlog"><a name="id309889"></a><h4>EVENTLOG EXPORT <em class="replaceable"><code>filename</code></em> <em class="replaceable"><code>eventlog</code></em></h4><p>
    473520Exports the samba internal tdb representation of eventlog defined by <em class="replaceable"><code>eventlog</code></em>
    474521to a eventlog *.evt file defined by <em class="replaceable"><code>filename</code></em>.
    … …  
    476523defined in smb.conf.
    477524See the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> manpage for details.
    478 </p></div></div><div class="refsect2" title="DOM"><a name="id309439"></a><h3>DOM</h3><p>Starting with version 3.2.0 Samba has support for remote join and unjoin APIs, both client and server-side. Windows supports remote join capabilities since Windows 2000.
     525</p></div></div><div class="refsect2" title="DOM"><a name="id309928"></a><h3>DOM</h3><p>Starting with version 3.2.0 Samba has support for remote join and unjoin APIs, both client and server-side. Windows supports remote join capabilities since Windows 2000.
    479526</p><p>In order for Samba to be joined or unjoined remotely an account must be used that is either member of the Domain Admins group, a member of the local Administrators group or a user that is granted the SeMachineAccountPrivilege privilege.
    480527</p><p>The client side support for remote join is implemented in the net dom commands which are:
    481528</p><table border="0" summary="Simple list" class="simplelist"><tr><td>net dom join - Join a remote computer into a domain.</td></tr><tr><td>net dom unjoin - Unjoin a remote computer from a domain.</td></tr><tr><td>net dom renamecomputer - Renames a remote computer joined to a domain.</td></tr></table><p>
    482 </p><div class="refsect3" title="DOM JOIN domain=DOMAIN ou=OU account=ACCOUNT password=PASSWORD reboot"><a name="id309475"></a><h4>DOM JOIN     <em class="replaceable"><code>domain=DOMAIN</code></em> <em class="replaceable"><code>ou=OU</code></em> <em class="replaceable"><code>account=ACCOUNT</code></em> <em class="replaceable"><code>password=PASSWORD</code></em> <em class="replaceable"><code>reboot</code></em></h4><p>
     529</p><div class="refsect3" title="DOM JOIN domain=DOMAIN ou=OU account=ACCOUNT password=PASSWORD reboot"><a name="id309963"></a><h4>DOM JOIN     <em class="replaceable"><code>domain=DOMAIN</code></em> <em class="replaceable"><code>ou=OU</code></em> <em class="replaceable"><code>account=ACCOUNT</code></em> <em class="replaceable"><code>password=PASSWORD</code></em> <em class="replaceable"><code>reboot</code></em></h4><p>
    483530Joins a computer into a domain. This command supports the following additional parameters:
    484531</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="replaceable"><code>DOMAIN</code></em> can be a NetBIOS domain name (also known as short domain name) or a DNS domain name for Active Directory Domains. As in Windows, it is also possible to control which Domain Controller to use. This can be achieved by appending the DC name using the \ separator character. Example: MYDOM\MYDC. The <em class="replaceable"><code>DOMAIN</code></em> parameter cannot be NULL.</p></li><li class="listitem"><p><em class="replaceable"><code>OU</code></em> can be set to a RFC 1779 LDAP DN, like <span class="emphasis"><em>ou=mymachines,cn=Users,dc=example,dc=com</em></span> in order to create the machine account in a non-default LDAP containter. This optional parameter is only supported when joining Active Directory Domains.</p></li><li class="listitem"><p><em class="replaceable"><code>ACCOUNT</code></em> defines a domain account that will be used to join the machine to the domain. This domain account needs to have sufficient privileges to join machines.</p></li><li class="listitem"><p><em class="replaceable"><code>PASSWORD</code></em> defines the password for the domain account defined with <em class="replaceable"><code>ACCOUNT</code></em>.</p></li><li class="listitem"><p><em class="replaceable"><code>REBOOT</code></em> is an optional parameter that can be set to reboot the remote machine after successful join to the domain.</p></li></ul></div><p>
    … …  
    489536</p><p>
    490537This example would connect to a computer named XP as the local administrator using password secret, and join the computer into a domain called MYDOM using the MYDOM domain administrator account and password topsecret. After successful join, the computer would reboot.
    491 </p></div><div class="refsect3" title="DOM UNJOIN account=ACCOUNT password=PASSWORD reboot"><a name="id309567"></a><h4>DOM UNJOIN <em class="replaceable"><code>account=ACCOUNT</code></em> <em class="replaceable"><code>password=PASSWORD</code></em> <em class="replaceable"><code>reboot</code></em></h4><p>
     538</p></div><div class="refsect3" title="DOM UNJOIN account=ACCOUNT password=PASSWORD reboot"><a name="id310056"></a><h4>DOM UNJOIN <em class="replaceable"><code>account=ACCOUNT</code></em> <em class="replaceable"><code>password=PASSWORD</code></em> <em class="replaceable"><code>reboot</code></em></h4><p>
    492539Unjoins a computer from a domain. This command supports the following additional parameters:
    493540</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="replaceable"><code>ACCOUNT</code></em> defines a domain account that will be used to unjoin the machine from the domain. This domain account needs to have sufficient privileges to unjoin machines.</p></li><li class="listitem"><p><em class="replaceable"><code>PASSWORD</code></em> defines the password for the domain account defined with <em class="replaceable"><code>ACCOUNT</code></em>.</p></li><li class="listitem"><p><em class="replaceable"><code>REBOOT</code></em> is an optional parameter that can be set to reboot the remote machine after successful unjoin from the domain.</p></li></ul></div><p>
    … …  
    498545</p><p>
    499546This example would connect to a computer named XP as the local administrator using password secret, and unjoin the computer from the domain using the MYDOM domain administrator account and password topsecret. After successful unjoin, the computer would reboot.
    500 </p></div><div class="refsect3" title="DOM RENAMECOMPUTER newname=NEWNAME account=ACCOUNT password=PASSWORD reboot"><a name="id309630"></a><h4>DOM RENAMECOMPUTER <em class="replaceable"><code>newname=NEWNAME</code></em> <em class="replaceable"><code>account=ACCOUNT</code></em> <em class="replaceable"><code>password=PASSWORD</code></em> <em class="replaceable"><code>reboot</code></em></h4><p>
     547</p></div><div class="refsect3" title="DOM RENAMECOMPUTER newname=NEWNAME account=ACCOUNT password=PASSWORD reboot"><a name="id310118"></a><h4>DOM RENAMECOMPUTER <em class="replaceable"><code>newname=NEWNAME</code></em> <em class="replaceable"><code>account=ACCOUNT</code></em> <em class="replaceable"><code>password=PASSWORD</code></em> <em class="replaceable"><code>reboot</code></em></h4><p>
    501548Renames a computer that is joined to a domain. This command supports the following additional parameters:
    502549</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="replaceable"><code>NEWNAME</code></em> defines the new name of the machine in the domain.</p></li><li class="listitem"><p><em class="replaceable"><code>ACCOUNT</code></em> defines a domain account that will be used to rename the machine in the domain. This domain account needs to have sufficient privileges to rename machines.</p></li><li class="listitem"><p><em class="replaceable"><code>PASSWORD</code></em> defines the password for the domain account defined with <em class="replaceable"><code>ACCOUNT</code></em>.</p></li><li class="listitem"><p><em class="replaceable"><code>REBOOT</code></em> is an optional parameter that can be set to reboot the remote machine after successful rename in the domain.</p></li></ul></div><p>
    … …  
    507554</p><p>
    508555This example would connect to a computer named XP as the local administrator using password secret, and rename the joined computer to XPNEW using the MYDOM domain administrator account and password topsecret. After successful rename, the computer would reboot.
    509 </p></div></div><div class="refsect2" title="G_LOCK"><a name="id309704"></a><h3>G_LOCK</h3><p>Manage global locks.</p><div class="refsect3" title="G_LOCK DO lockname timeout command"><a name="id309712"></a><h4>G_LOCK DO <em class="replaceable"><code>lockname</code></em> <em class="replaceable"><code>timeout</code></em> <em class="replaceable"><code>command</code></em></h4><p>
     556</p></div></div><div class="refsect2" title="G_LOCK"><a name="id310192"></a><h3>G_LOCK</h3><p>Manage global locks.</p><div class="refsect3" title="G_LOCK DO lockname timeout command"><a name="id310201"></a><h4>G_LOCK DO <em class="replaceable"><code>lockname</code></em> <em class="replaceable"><code>timeout</code></em> <em class="replaceable"><code>command</code></em></h4><p>
    510557Execute a shell command under a global lock. This might be useful to define the
    511558order in which several shell commands will be executed. The locking information
    512559is stored in a file called <code class="filename">g_lock.tdb</code>. In setups with CTDB
    513560running, the locking information will be available on all cluster nodes.
    514 </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="replaceable"><code>LOCKNAME</code></em> defines the name of the global lock.</p></li><li class="listitem"><p><em class="replaceable"><code>TIMEOUT</code></em> defines the timeout.</p></li><li class="listitem"><p><em class="replaceable"><code>COMMAND</code></em> defines the shell command to execute.</p></li></ul></div></div><div class="refsect3" title="G_LOCK LOCKS"><a name="id309760"></a><h4>G_LOCK LOCKS</h4><p>
     561</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="replaceable"><code>LOCKNAME</code></em> defines the name of the global lock.</p></li><li class="listitem"><p><em class="replaceable"><code>TIMEOUT</code></em> defines the timeout.</p></li><li class="listitem"><p><em class="replaceable"><code>COMMAND</code></em> defines the shell command to execute.</p></li></ul></div></div><div class="refsect3" title="G_LOCK LOCKS"><a name="id310249"></a><h4>G_LOCK LOCKS</h4><p>
    515562Print a list of all currently existing locknames.
    516 </p></div><div class="refsect3" title="G_LOCK DUMP lockname"><a name="id309770"></a><h4>G_LOCK DUMP <em class="replaceable"><code>lockname</code></em></h4><p>
     563</p></div><div class="refsect3" title="G_LOCK DUMP lockname"><a name="id310259"></a><h4>G_LOCK DUMP <em class="replaceable"><code>lockname</code></em></h4><p>
    517564Dump the locking table of a certain global lock.
    518 </p></div></div><div class="refsect2" title="HELP [COMMAND]"><a name="id309783"></a><h3>HELP [COMMAND]</h3><p>Gives usage information for the specified command.</p></div></div><div class="refsect1" title="VERSION"><a name="id309794"></a><h2>VERSION</h2><p>This man page is complete for version 3 of the Samba
    519         suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id309804"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     565</p></div></div><div class="refsect2" title="HELP [COMMAND]"><a name="id310272"></a><h3>HELP [COMMAND]</h3><p>Gives usage information for the specified command.</p></div></div><div class="refsect1" title="VERSION"><a name="id310282"></a><h2>VERSION</h2><p>This man page is complete for version 3 of the Samba
     566        suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id310292"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    520567        were created by Andrew Tridgell. Samba is now developed
    521568        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/nmbd.8.html

    r599 r745  
    2323        proxy, relaying broadcast queries from clients that do
    2424        not understand how to talk the WINS protocol to a WINS
    25         server.</p></div><div class="refsect1" title="OPTIONS"><a name="id265902"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-D</span></dt><dd><p>If specified, this parameter causes
     25        server.</p></div><div class="refsect1" title="OPTIONS"><a name="id265901"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-D</span></dt><dd><p>If specified, this parameter causes
    2626                <code class="literal">nmbd</code> to operate as a daemon. That is,
    2727                it detaches itself and runs in the background, fielding
    … …  
    8989                that <code class="literal">nmbd</code> responds to name queries on. Don't
    9090                use this option unless you are an expert, in which case you
    91                 won't need help!</p></dd></dl></div></div><div class="refsect1" title="FILES"><a name="id307262"></a><h2>FILES</h2><div class="variablelist"><dl><dt><span class="term"><code class="filename">/etc/inetd.conf</code></span></dt><dd><p>If the server is to be run by the
     91                won't need help!</p></dd></dl></div></div><div class="refsect1" title="FILES"><a name="id307261"></a><h2>FILES</h2><div class="variablelist"><dl><dt><span class="term"><code class="filename">/etc/inetd.conf</code></span></dt><dd><p>If the server is to be run by the
    9292                <code class="literal">inetd</code> meta-daemon, this file
    9393                must contain suitable startup information for the
    … …  
    130130        are no longer used since Samba 2.2). This is to allow
    131131        transient problems to be diagnosed, whilst still running
    132         at a normally low log level.</p></div><div class="refsect1" title="VERSION"><a name="id307512"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     132        at a normally low log level.</p></div><div class="refsect1" title="VERSION"><a name="id307511"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    133133        the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id307521"></a><h2>SEE ALSO</h2><p>
    134134        <a class="citerefentry" href="inetd.8.html"><span class="citerefentry"><span class="refentrytitle">inetd</span>(8)</span></a>, <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>, <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>, <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>, <a class="citerefentry" href="testparm.1.html"><span class="citerefentry"><span class="refentrytitle">testparm</span>(1)</span></a>, <a class="citerefentry" href="testprns.1.html"><span class="citerefentry"><span class="refentrytitle">testprns</span>(1)</span></a>, and the Internet

  • trunk/server/docs/htmldocs/manpages/nmblookup.1.html

    r599 r745  
    11<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>nmblookup</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="nmblookup"><a name="nmblookup"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>nmblookup &#8212; NetBIOS over TCP/IP client used to lookup NetBIOS
    2         names</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">nmblookup</code> [-M] [-R] [-S] [-r] [-A] [-h] [-B &lt;broadcast address&gt;] [-U &lt;unicast address&gt;] [-d &lt;debug level&gt;] [-s &lt;smb config file&gt;] [-i &lt;NetBIOS scope&gt;] [-T] [-f] {name}</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id265700"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">nmblookup</code> is used to query NetBIOS names
     2        names</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">nmblookup</code> [-M] [-R] [-S] [-r] [-A] [-h] [-B &lt;broadcast address&gt;] [-U &lt;unicast address&gt;] [-d &lt;debug level&gt;] [-s &lt;smb config file&gt;] [-i &lt;NetBIOS scope&gt;] [-T] [-f] {name}</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id265699"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">nmblookup</code> is used to query NetBIOS names
    33        and map them to IP addresses in a network using NetBIOS over TCP/IP
    44        queries. The options allow the name queries to be directed at a
    55        particular IP broadcast area or to a particular machine. All queries
    6         are done over UDP.</p></div><div class="refsect1" title="OPTIONS"><a name="id265729"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-M</span></dt><dd><p>Searches for a master browser by looking
     6        are done over UDP.</p></div><div class="refsect1" title="OPTIONS"><a name="id265728"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-M</span></dt><dd><p>Searches for a master browser by looking
    77                up the  NetBIOS name <em class="replaceable"><code>name</code></em> with a
    88                type of <code class="constant">0x1d</code>. If <em class="replaceable"><code>
    … …  
    8989                by appending '#&lt;type&gt;' to the name. This name may also be
    9090                '*', which will return all registered names within a broadcast
    91                 area.</p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id307270"></a><h2>EXAMPLES</h2><p><code class="literal">nmblookup</code> can be used to query
     91                area.</p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id307271"></a><h2>EXAMPLES</h2><p><code class="literal">nmblookup</code> can be used to query
    9292                a WINS server (in the same way <code class="literal">nslookup</code> is
    9393                used to query DNS servers). To query a WINS server, <code class="literal">nmblookup</code>
    9494                must be called like this:</p><p><code class="literal">nmblookup -U server -R 'name'</code></p><p>For example, running :</p><p><code class="literal">nmblookup -U samba.org -R 'IRIX#1B'</code></p><p>would query the WINS server samba.org for the domain
    95                 master browser (1B name type) for the IRIX workgroup.</p></div><div class="refsect1" title="VERSION"><a name="id307314"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    96         the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id307324"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>, <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>, and <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id307355"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     95                master browser (1B name type) for the IRIX workgroup.</p></div><div class="refsect1" title="VERSION"><a name="id307315"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     96        the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id307325"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>, <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>, and <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id307356"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    9797        were created by Andrew Tridgell. Samba is now developed
    9898        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/ntlm_auth.1.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ntlm_auth</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="ntlm_auth"><a name="ntlm-auth.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ntlm_auth &#8212; tool to allow external access to Winbind's NTLM authentication function</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">ntlm_auth</code> [-d debuglevel] [-l logdir] [-s &lt;smb config file&gt;]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266364"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">ntlm_auth</code> is a helper utility that authenticates
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ntlm_auth</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="ntlm_auth"><a name="ntlm-auth.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ntlm_auth &#8212; tool to allow external access to Winbind's NTLM authentication function</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">ntlm_auth</code> [-d debuglevel] [-l logdir] [-s &lt;smb config file&gt;]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266363"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">ntlm_auth</code> is a helper utility that authenticates
    22        users using NT/LM authentication. It returns 0 if the users is authenticated
    33        successfully and 1 if access was denied. ntlm_auth uses winbind to access
    … …  
    66        <a class="ulink" href="http://www.squid-cache.org/" target="_top">Squid</a>
    77        and <a class="ulink" href="http://download.samba.org/ftp/unpacked/lorikeet/trunk/mod_ntlm_winbind/" target="_top">mod_ntlm_winbind</a>)
    8         </p></div><div class="refsect1" title="OPERATIONAL REQUIREMENTS"><a name="id266860"></a><h2>OPERATIONAL REQUIREMENTS</h2><p>
     8        </p></div><div class="refsect1" title="OPERATIONAL REQUIREMENTS"><a name="id266859"></a><h2>OPERATIONAL REQUIREMENTS</h2><p>
    99    The <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon must be operational
    1010    for many of these commands to function.</p><p>Some of these commands also require access to the directory
    … …  
    1313    this command as root or providing group access
    1414    to the <code class="filename">winbindd_privileged</code> directory.  For
    15     security reasons, this directory should not be world-accessable. </p></div><div class="refsect1" title="OPTIONS"><a name="id265696"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">--helper-protocol=PROTO</span></dt><dd><p>
     15    security reasons, this directory should not be world-accessable. </p></div><div class="refsect1" title="OPTIONS"><a name="id266899"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">--helper-protocol=PROTO</span></dt><dd><p>
    1616        Operate as a stdio-based helper.  Valid helper protocols are:
    1717        </p><div class="variablelist"><dl><dt><span class="term">squid-2.4-basic</span></dt><dd><p>
    … …  
    6060                finished supplying data to the other.  (Which in turn
    6161                could cause the helper to authenticate the
    62                 user). </p><p>Curently implemented parameters from the
     62                user). </p><p>Currently implemented parameters from the
    6363                external program to the helper are:</p><div class="variablelist"><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3>Implementors should take care to base64 encode
    6464                any data (such as usernames/passwords) that may contain malicous user data, such as
    … …  
    6666                the helper, which likewise may have been base64 encoded.</div><dl><dt><span class="term">Username</span></dt><dd><p>The username, expected to be in
    6767                Samba's <a class="link" href="smb.conf.5.html#UNIXCHARSET" target="_top">unix charset</a>.
    68                 </p><div class="example"><a name="id265921"></a><p class="title"><b>Example 1. </b></p><div class="example-contents">Username: bob</div></div><p><br class="example-break"></p><div class="example"><a name="id265926"></a><p class="title"><b>Example 2. </b></p><div class="example-contents">Username:: Ym9i</div></div><p><br class="example-break"></p></dd><dt><span class="term">NT-Domain</span></dt><dd><p>The user's domain, expected to be in
     68                </p><div class="example"><a name="id265920"></a><p class="title"><b>Example 1. </b></p><div class="example-contents">Username: bob</div></div><p><br class="example-break"></p><div class="example"><a name="id265925"></a><p class="title"><b>Example 2. </b></p><div class="example-contents">Username:: Ym9i</div></div><p><br class="example-break"></p></dd><dt><span class="term">NT-Domain</span></dt><dd><p>The user's domain, expected to be in
    6969                Samba's <a class="link" href="smb.conf.5.html#UNIXCHARSET" target="_top">unix charset</a>.
    7070                </p><div class="example"><a name="id265952"></a><p class="title"><b>Example 3. </b></p><div class="example-contents">NT-Domain: WORKGROUP</div></div><p><br class="example-break"></p><div class="example"><a name="id265957"></a><p class="title"><b>Example 4. </b></p><div class="example-contents">NT-Domain:: V09SS0dST1VQ</div></div><p><br class="example-break"></p></dd><dt><span class="term">Full-Username</span></dt><dd><p>The fully qualified username, expected to be in

  • trunk/server/docs/htmldocs/manpages/pam_winbind.8.html

    r599 r745  
    11<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>pam_winbind</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="pam_winbind"><a name="pam_winbind.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>pam_winbind &#8212; PAM module for Winbind</p></div><div class="refsect1" title="DESCRIPTION"><a name="id298152"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>
    22        pam_winbind is a PAM module that can authenticate users against the local domain by talking to the Winbind daemon.
    3         </p></div><div class="refsect1" title="SYNOPSIS"><a name="id266349"></a><h2>SYNOPSIS</h2><p>
     3        </p></div><div class="refsect1" title="SYNOPSIS"><a name="id266348"></a><h2>SYNOPSIS</h2><p>
    44                Edit the PAM system config /etc/pam.d/service and modify it as the following example shows:
    55                </p><pre class="programlisting">
    … …  
    2020                Make sure that pam_winbind is one of the first modules in the session part. It may retrieve
    2121                kerberos tickets which are needed by other modules.
    22         </p></div><div class="refsect1" title="OPTIONS"><a name="id266830"></a><h2>OPTIONS</h2><p>
     22        </p></div><div class="refsect1" title="OPTIONS"><a name="id266825"></a><h2>OPTIONS</h2><p>
    2323       
    2424                pam_winbind supports several options which can either be set in

  • trunk/server/docs/htmldocs/manpages/pdbedit.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>pdbedit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="pdbedit"><a name="pdbedit.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>pdbedit &#8212; manage the SAM database (Database of Samba Users)</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">pdbedit</code> [-a] [-b passdb-backend] [-c account-control] [-C value] [-d debuglevel] [-D drive] [-e passdb-backend] [-f fullname] [--force-initialized-passwords] [-g] [-h homedir] [-i passdb-backend] [-I domain] [-K] [-L ] [-m] [-M SID|RID] [-N description] [-P account-policy] [-p profile] [--policies-reset] [-r] [-s configfile] [-S script] [-t] [--time-format] [-u username] [-U SID|RID] [-v] [-V] [-w] [-x] [-y] [-z] [-Z]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id265862"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The pdbedit program is used to manage the users accounts
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>pdbedit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="pdbedit"><a name="pdbedit.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>pdbedit &#8212; manage the SAM database (Database of Samba Users)</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">pdbedit</code> [-a] [-b passdb-backend] [-c account-control] [-C value] [-d debuglevel] [-D drive] [-e passdb-backend] [-f fullname] [--force-initialized-passwords] [-g] [-h homedir] [-i passdb-backend] [-I domain] [-K] [-L ] [-m] [-M SID|RID] [-N description] [-P account-policy] [-p profile] [--policies-reset] [-r] [-s configfile] [-S script] [-t] [--time-format] [-u username] [-U SID|RID] [-v] [-V] [-w] [-x] [-y] [-z] [-Z]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id265860"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The pdbedit program is used to manage the users accounts
    22        stored in the sam database and can only be run by root.</p><p>The pdbedit tool uses the passdb modular interface and is
    33        independent from the kind of users database used (currently there
    … …  
    55        without changing the tool).</p><p>There are five main ways to use pdbedit: adding a user account,
    66        removing a user account, modifing a user account, listing user
    7         accounts, importing users accounts.</p></div><div class="refsect1" title="OPTIONS"><a name="id265895"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-L|--list</span></dt><dd><p>This option lists all the user accounts
     7        accounts, importing users accounts.</p></div><div class="refsect1" title="OPTIONS"><a name="id265892"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-L|--list</span></dt><dd><p>This option lists all the user accounts
    88                present in the users database.
    99                This option prints a list of user/uid pairs separated by
    … …  
    164164<code class="constant">".progname"</code> will be appended (e.g. log.smbclient,
    165165log.smbd, etc...). The log file is never removed by the client.
    166 </p></dd></dl></div></div><div class="refsect1" title="NOTES"><a name="id307998"></a><h2>NOTES</h2><p>This command may be used only by root.</p></div><div class="refsect1" title="VERSION"><a name="id308007"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    167         the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id308017"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbpasswd.5.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(5)</span></a>, <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a></p></div><div class="refsect1" title="AUTHOR"><a name="id308039"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     166</p></dd></dl></div></div><div class="refsect1" title="NOTES"><a name="id307996"></a><h2>NOTES</h2><p>This command may be used only by root.</p></div><div class="refsect1" title="VERSION"><a name="id308006"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     167        the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id308016"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbpasswd.5.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(5)</span></a>, <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a></p></div><div class="refsect1" title="AUTHOR"><a name="id308038"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    168168        were created by Andrew Tridgell. Samba is now developed
    169169        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/profiles.1.html

    r599 r745  
    11<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>profiles</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="profiles"><a name="profiles.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>profiles &#8212; A utility to report and change SIDs in registry files
    2         </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">profiles</code> [-v] [-c SID] [-n SID] {file}</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266827"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">profiles</code> is a utility that
     2        </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">profiles</code> [-v] [-c SID] [-n SID] {file}</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266825"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">profiles</code> is a utility that
    33        reports and changes SIDs in windows registry files. It currently only
    44        supports NT.
    5         </p></div><div class="refsect1" title="OPTIONS"><a name="id266854"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">file</span></dt><dd><p>Registry file to view or edit.  </p></dd><dt><span class="term">-v,--verbose</span></dt><dd><p>Increases verbosity of messages.
     5        </p></div><div class="refsect1" title="OPTIONS"><a name="id266853"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">file</span></dt><dd><p>Registry file to view or edit.  </p></dd><dt><span class="term">-v,--verbose</span></dt><dd><p>Increases verbosity of messages.
    66                </p></dd><dt><span class="term">-c SID1 -n SID2</span></dt><dd><p>Change all occurences of SID1 in <code class="filename">file</code> by SID2.
    77                </p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    88</p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id265711"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
    9         suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id265721"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     9        suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id265720"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    1010        were created by Andrew Tridgell. Samba is now developed
    1111        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/rpcclient.1.html

    r599 r745  
    11<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>rpcclient</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="rpcclient"><a name="rpcclient.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>rpcclient &#8212; tool for executing client side
    2         MS-RPC functions</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">rpcclient</code> [-A authfile] [-c &lt;command string&gt;] [-d debuglevel] [-h] [-l logdir] [-N] [-s &lt;smb config file&gt;] [-U username[%password]] [-W workgroup] [-I destinationIP] {server}</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266881"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">rpcclient</code> is a utility initially developed
     2        MS-RPC functions</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">rpcclient</code> [-A authfile] [-c &lt;command string&gt;] [-d debuglevel] [-h] [-l logdir] [-N] [-s &lt;smb config file&gt;] [-U username[%password]] [-W workgroup] [-I destinationIP] {server}</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266879"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">rpcclient</code> is a utility initially developed
    33        to test MS-RPC functionality in Samba itself.  It has undergone
    44        several stages of development and stability.  Many system administrators
    55        have now written scripts around it to manage Windows NT clients from
    6         their UNIX workstation. </p></div><div class="refsect1" title="OPTIONS"><a name="id265705"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">server</span></dt><dd><p>NetBIOS name of Server to which to connect.
     6        their UNIX workstation. </p></div><div class="refsect1" title="OPTIONS"><a name="id265704"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">server</span></dt><dd><p>NetBIOS name of Server to which to connect.
    77                The server can be  any SMB/CIFS server.  The name is
    8                 resolved using the <a class="link" href="smb.conf.5.html#NAMERESOLVEORDER" target="_top">name resolve order</a> line from <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>.</p></dd><dt><span class="term">-c|--command='command string'</span></dt><dd><p>execute semicolon separated commands (listed
    9                 below)) </p></dd><dt><span class="term">-I|--dest-ip IP-address</span></dt><dd><p><em class="replaceable"><code>IP address</code></em> is the address of the server to connect to.
     8                resolved using the <a class="link" href="smb.conf.5.html#NAMERESOLVEORDER" target="_top">name resolve order</a> line from <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>.</p></dd><dt><span class="term">-c|--command=&lt;command string&gt;</span></dt><dd><p>Execute semicolon separated commands (listed
     9                below) </p></dd><dt><span class="term">-I|--dest-ip IP-address</span></dt><dd><p><em class="replaceable"><code>IP address</code></em> is the address of the server to connect to.
    1010                It should be specified in standard "a.b.c.d" notation. </p><p>Normally the client would attempt to locate a named
    1111                SMB/CIFS server by looking it up via the NetBIOS name resolution
    … …  
    131131                must already be installed on the server (see <code class="literal">adddriver</code>)
    132132                and the <em class="parameter"><code>port</code></em>must be a valid port name (see
    133                 <code class="literal">enumports</code>.</p></dd><dt><span class="term">deldriver</span></dt><dd><p>Delete the
     133                <code class="literal">enumports</code>.</p></dd><dt><span class="term">deldriver &lt;driver&gt;</span></dt><dd><p>Delete the
    134134                specified printer driver for all architectures.  This
    135135                does not delete the actual driver files from the server,

  • trunk/server/docs/htmldocs/manpages/sharesec.1.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>sharesec</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="sharesec"><a name="sharesec.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sharesec &#8212; Set or get share ACLs</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">sharesec</code> {sharename} [-r, --remove=ACL] [-m, --modify=ACL] [-a, --add=ACL] [-R, --replace=ACLs] [-D, --delete] [-v, --view] [-M, --machine-sid] [-F, --force] [-d, --debuglevel=DEBUGLEVEL] [-s, --configfile=CONFIGFILE] [-l, --log-basename=LOGFILEBASE] [-V, --version] [-?, --help] [--usage]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id265708"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">sharesec</code> program manipulates share permissions
    2         on SMB file shares.</p></div><div class="refsect1" title="OPTIONS"><a name="id265736"></a><h2>OPTIONS</h2><p>The following options are available to the <code class="literal">sharesec</code> program.
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>sharesec</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="sharesec"><a name="sharesec.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sharesec &#8212; Set or get share ACLs</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">sharesec</code> {sharename} [-r, --remove=ACL] [-m, --modify=ACL] [-a, --add=ACL] [-R, --replace=ACLs] [-D, --delete] [-v, --view] [-M, --machine-sid] [-F, --force] [-d, --debuglevel=DEBUGLEVEL] [-s, --configfile=CONFIGFILE] [-l, --log-basename=LOGFILEBASE] [-V, --version] [-?, --help] [--usage]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id265706"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">sharesec</code> program manipulates share permissions
     2        on SMB file shares.</p></div><div class="refsect1" title="OPTIONS"><a name="id265734"></a><h2>OPTIONS</h2><p>The following options are available to the <code class="literal">sharesec</code> program.
    33        The format of ACLs is described in the section ACL FORMAT </p><div class="variablelist"><dl><dt><span class="term">-a|--add=ACL</span></dt><dd><p>Add the ACEs specified to the ACL list.
    44                </p></dd><dt><span class="term">-D|--delete</span></dt><dd><p>Delete the entire security descriptor.
    … …  
    3434<code class="constant">".progname"</code> will be appended (e.g. log.smbclient,
    3535log.smbd, etc...). The log file is never removed by the client.
    36 </p></dd></dl></div></div><div class="refsect1" title="ACL FORMAT"><a name="id307092"></a><h2>ACL FORMAT</h2><p>The format of an ACL is one or more ACL entries separated by
     36</p></dd></dl></div></div><div class="refsect1" title="ACL FORMAT"><a name="id307091"></a><h2>ACL FORMAT</h2><p>The format of an ACL is one or more ACL entries separated by
    3737        either commas or newlines.  An ACL entry is one of the following: </p><pre class="programlisting">
    3838        REVISION:&lt;revision number&gt;
    … …  
    5858                permissions</p></li><li class="listitem"><p><span class="emphasis"><em>CHANGE</em></span> - Equivalent to 'RXWD' permissions
    5959                </p></li><li class="listitem"><p><span class="emphasis"><em>FULL</em></span> - Equivalent to 'RWXDPO'
    60                 permissions</p></li></ul></div></div><div class="refsect1" title="EXIT STATUS"><a name="id307204"></a><h2>EXIT STATUS</h2><p>The <code class="literal">sharesec</code> program sets the exit status
     60                permissions</p></li></ul></div></div><div class="refsect1" title="EXIT STATUS"><a name="id307202"></a><h2>EXIT STATUS</h2><p>The <code class="literal">sharesec</code> program sets the exit status
    6161        depending on the success or otherwise of the operations performed.
    6262        The exit status may be one of the following values. </p><p>If the operation succeeded, sharesec returns and exit
    … …  
    6464        or there was an error getting or setting the ACLs, an exit status
    6565        of 1 is returned.  If there was an error parsing any command line
    66         arguments, an exit status of 2 is returned. </p></div><div class="refsect1" title="EXAMPLES"><a name="id307231"></a><h2>EXAMPLES</h2><p>Add full access for SID
     66        arguments, an exit status of 2 is returned. </p></div><div class="refsect1" title="EXAMPLES"><a name="id307230"></a><h2>EXAMPLES</h2><p>Add full access for SID
    6767        <em class="parameter"><code>S-1-5-21-1866488690-1365729215-3963860297-17724</code></em> on
    6868        <em class="parameter"><code>share</code></em>:
    … …  
    7777        ACL:S-1-1-0:ALLOWED/0/0x101f01ff
    7878        ACL:S-1-5-21-1866488690-1365729215-3963860297-17724:ALLOWED/0/FULL
    79         </pre></div><div class="refsect1" title="VERSION"><a name="id307272"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id307282"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     79        </pre></div><div class="refsect1" title="VERSION"><a name="id307271"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id307280"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    8080        were created by Andrew Tridgell. Samba is now developed
    8181        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/smb.conf.5.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smb.conf</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smb.conf"><a name="smb.conf.5"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smb.conf &#8212; The configuration file for the Samba suite</p></div><div class="refsect1" title="SYNOPSIS"><a name="id266327"></a><h2>SYNOPSIS</h2><p>
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smb.conf</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smb.conf"><a name="smb.conf.5"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smb.conf &#8212; The configuration file for the Samba suite</p></div><div class="refsect1" title="SYNOPSIS"><a name="id298153"></a><h2>SYNOPSIS</h2><p>
    22        The <code class="filename">smb.conf</code> file is a configuration  file for the Samba suite. <code class="filename">smb.conf</code> contains  runtime configuration information for the Samba programs. The
    33         <code class="filename">smb.conf</code> file is designed to be configured and administered by the
    … …  
    2727        which may be given as yes/no, 1/0 or true/false. Case is not significant in boolean values, but is preserved
    2828        in string values. Some items such as create masks are numeric.
    29         </p></div><div class="refsect1" title="SECTION DESCRIPTIONS"><a name="id266888"></a><h2>SECTION DESCRIPTIONS</h2><p>
     29        </p></div><div class="refsect1" title="SECTION DESCRIPTIONS"><a name="id266887"></a><h2>SECTION DESCRIPTIONS</h2><p>
    3030        Each section in the configuration file (except for the [global] section) describes a shared resource (known as
    3131        a <span class="quote">&#8220;<span class="quote">share</span>&#8221;</span>). The section name is the name of the shared resource and the parameters within the
    … …  
    7070        <a class="link" href="smb.conf.5.html#GUESTOK" target="_top">guest ok = yes</a>
    7171</pre><p>
    72         </p></div><div class="refsect1" title="SPECIAL SECTIONS"><a name="id265957"></a><h2>SPECIAL SECTIONS</h2><div class="refsect2" title="The [global] section"><a name="id265962"></a><h3>The [global] section</h3><p>
     72        </p></div><div class="refsect1" title="SPECIAL SECTIONS"><a name="id265955"></a><h2>SPECIAL SECTIONS</h2><div class="refsect2" title="The [global] section"><a name="id265960"></a><h3>The [global] section</h3><p>
    7373                Parameters in this section apply to the server as a whole, or are defaults for sections that do not
    7474                specifically define certain items. See the notes under PARAMETERS for more information.
    … …  
    161161                <code class="literal">printcap name = lpstat</code> to automatically obtain a list of printers. See the
    162162                <code class="literal">printcap name</code> option for more details.
    163                 </p></div></div></div><div class="refsect1" title="USERSHARES"><a name="id307273"></a><h2>USERSHARES</h2><p>Starting with Samba version 3.0.23 the capability for non-root users to add, modify, and delete
     163                </p></div></div></div><div class="refsect1" title="USERSHARES"><a name="id307272"></a><h2>USERSHARES</h2><p>Starting with Samba version 3.0.23 the capability for non-root users to add, modify, and delete
    164164        their own share definitions has been added. This capability is called <span class="emphasis"><em>usershares</em></span> and
    165165        is controlled by a set of parameters in the [global] section of the smb.conf.
    … …  
    185185        to the global
    186186        section of your <code class="filename">smb.conf</code>. Members of the group foo may then manipulate the user defined shares
    187         using the following commands.</p><div class="variablelist"><dl><dt><span class="term">net usershare add sharename path [comment] [acl] [guest_ok=[y|n]]</span></dt><dd><p>To create or modify (overwrite) a user defined share.</p></dd><dt><span class="term">net usershare delete sharename</span></dt><dd><p>To delete a user defined share.</p></dd><dt><span class="term">net usershare list wildcard-sharename</span></dt><dd><p>To list user defined shares.</p></dd><dt><span class="term">net usershare info wildcard-sharename</span></dt><dd><p>To print information about user defined shares.</p></dd></dl></div></div><div class="refsect1" title="PARAMETERS"><a name="id307466"></a><h2>PARAMETERS</h2><p>Parameters define the specific attributes of sections.</p><p>
     187        using the following commands.</p><div class="variablelist"><dl><dt><span class="term">net usershare add sharename path [comment] [acl] [guest_ok=[y|n]]</span></dt><dd><p>To create or modify (overwrite) a user defined share.</p></dd><dt><span class="term">net usershare delete sharename</span></dt><dd><p>To delete a user defined share.</p></dd><dt><span class="term">net usershare list wildcard-sharename</span></dt><dd><p>To list user defined shares.</p></dd><dt><span class="term">net usershare info wildcard-sharename</span></dt><dd><p>To print information about user defined shares.</p></dd></dl></div></div><div class="refsect1" title="PARAMETERS"><a name="id307465"></a><h2>PARAMETERS</h2><p>Parameters define the specific attributes of sections.</p><p>
    188188        Some parameters are specific to the [global] section (e.g., <span class="emphasis"><em>security</em></span>).  Some parameters
    189189        are usable in all sections (e.g., <span class="emphasis"><em>create mask</em></span>). All others are permissible only in normal
    … …  
    197197        find them! Where there are synonyms, the preferred synonym is described, others refer to the preferred
    198198        synonym.
    199         </p></div><div class="refsect1" title="VARIABLE SUBSTITUTIONS"><a name="id307505"></a><h2>VARIABLE SUBSTITUTIONS</h2><p>
     199        </p></div><div class="refsect1" title="VARIABLE SUBSTITUTIONS"><a name="id307504"></a><h2>VARIABLE SUBSTITUTIONS</h2><p>
    200200        Many of the strings that are settable in the config file can take substitutions. For example the option
    201201        <span class="quote">&#8220;<span class="quote">path = /tmp/%u</span>&#8221;</span> is interpreted as <span class="quote">&#8220;<span class="quote">path = /tmp/john</span>&#8221;</span> if the user connected with the
    … …  
    219219                    machine.  It currently recognizes Samba (<code class="constant">Samba</code>),
    220220                    the Linux CIFS file system (<code class="constant">CIFSFS</code>), OS/2, (<code class="constant">OS2</code>),
    221                     Windows for Workgroups (<code class="constant">WfWg</code>), Windows 9x/ME
     221                    Mac OS X (<code class="constant">OSX</code>), Windows for Workgroups (<code class="constant">WfWg</code>), Windows 9x/ME
    222222                    (<code class="constant">Win95</code>), Windows NT (<code class="constant">WinNT</code>),
    223223                    Windows 2000 (<code class="constant">Win2K</code>),
    … …  
    258258                </p></dd><dt><span class="term">default case = upper/lower</span></dt><dd><p>
    259259                controls what the default case is for new filenames (ie. files that don't currently exist in the filesystem).
    260                 Default <span class="emphasis"><em>lower</em></span>.  IMPORTANT NOTE: This option will be used to modify the case of
    261                 <span class="emphasis"><em>all</em></span> incoming client filenames, not just new filenames if the options <a class="link" href="smb.conf.5.html#CASESENSITIVE" target="_top">case sensitive = yes</a>, <a class="link" href="smb.conf.5.html#PRESERVECASE" target="_top">preserve case = No</a>,
    262                 <a class="link" href="smb.conf.5.html#SHORTPRESERVECASE" target="_top">short preserve case = No</a> are set.  This change is needed as part of the
    263                 optimisations for directories containing large numbers of files.
     260                Default <span class="emphasis"><em>lower</em></span>.  IMPORTANT NOTE: As part of the optimizations for directories containing
     261                large numbers of files, the following special case applies. If the options
     262                <a class="link" href="smb.conf.5.html#CASESENSITIVE" target="_top">case sensitive = yes</a>, <a class="link" href="smb.conf.5.html#PRESERVECASE" target="_top">preserve case = No</a>, and
     263                <a class="link" href="smb.conf.5.html#SHORTPRESERVECASE" target="_top">short preserve case = No</a> are set, then the case of <span class="emphasis"><em>all</em></span>
     264                incoming client filenames, not just new filenames, will be modified. See additional notes below.
    264265                </p></dd><dt><span class="term">preserve case = yes/no</span></dt><dd><p>
    265266                controls whether new files (ie. files that don't currently exist in the filesystem) are created with the case
    … …  
    306307                If the service is a guest service, a connection is made as the username given in the <code class="literal">guest account
    307308                =</code> for the service, irrespective of the supplied password.
    308                 </p></li></ol></div></div><div class="refsect1" title="REGISTRY-BASED CONFIGURATION"><a name="id308130"></a><h2>REGISTRY-BASED CONFIGURATION</h2><p>
     309                </p></li></ol></div></div><div class="refsect1" title="REGISTRY-BASED CONFIGURATION"><a name="id308128"></a><h2>REGISTRY-BASED CONFIGURATION</h2><p>
    309310                Starting with Samba version 3.2.0, the capability to
    310311                store Samba configuration in the registry is available.
    … …  
    361362                accessing the database file, circumventing the
    362363                server.
    363         </p></div><div class="refsect1" title="EXPLANATION OF EACH PARAMETER"><a name="id308284"></a><h2>EXPLANATION OF EACH PARAMETER</h2><div class="section"><div class="titlepage"></div><div class="section" title="abort shutdown script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id308293"></a>
     364        </p></div><div class="refsect1" title="EXPLANATION OF EACH PARAMETER"><a name="id308281"></a><h2>EXPLANATION OF EACH PARAMETER</h2><div class="section"><div class="titlepage"></div><div class="section" title="abort shutdown script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id308291"></a>
    364365
    365366abort shutdown script (G)
    366 </h3></div></div></div><a class="indexterm" name="id308294"></a><a name="ABORTSHUTDOWNSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This a full path name to a script called by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> that
     367</h3></div></div></div><a class="indexterm" name="id308292"></a><a name="ABORTSHUTDOWNSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This a full path name to a script called by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> that
    367368        should stop a shutdown procedure issued by the <a class="link" href="smb.conf.5.html#SHUTDOWNSCRIPT" target="_top">shutdown script</a>.</p><p>If the connected user posseses the <code class="constant">SeRemoteShutdownPrivilege</code>,
    368369        right, this command will be run as root.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>abort shutdown script</code></em> = <code class="literal">""</code>
    … …  
    370371</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>abort shutdown script</code></em> = <code class="literal">/sbin/shutdown -c</code>
    371372</em></span>
    372 </p></dd></dl></div></div><div class="section" title="access based share enum (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id308368"></a>
     373</p></dd></dl></div></div><div class="section" title="access based share enum (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id308365"></a>
    373374
    374375access based share enum (S)
    375 </h3></div></div></div><a class="indexterm" name="id308369"></a><a name="ACCESSBASEDSHAREENUM"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code> for a
     376</h3></div></div></div><a class="indexterm" name="id308366"></a><a name="ACCESSBASEDSHAREENUM"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code> for a
    376377    service, then the share hosted by the service will only be visible
    377378    to users who have read or write access to the share during share
    … …  
    382383    computing enumeration access rights.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>access based share enum</code></em> = <code class="literal">no</code>
    383384</em></span>
    384 </p></dd></dl></div></div><div class="section" title="acl check permissions (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id308412"></a>
     385</p></dd></dl></div></div><div class="section" title="acl check permissions (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id308409"></a>
    385386
    386387acl check permissions (S)
    387 </h3></div></div></div><a class="indexterm" name="id308413"></a><a name="ACLCHECKPERMISSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls what <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>does on receiving a protocol request of "open for delete"
     388</h3></div></div></div><a class="indexterm" name="id308410"></a><a name="ACLCHECKPERMISSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls what <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>does on receiving a protocol request of "open for delete"
    388389    from a Windows client. If a Windows client doesn't have permissions to delete a file then they
    389390    expect this to be denied at open time. POSIX systems normally only detect restrictions on delete by
    … …  
    405406    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>acl check permissions</code></em> = <code class="literal">True</code>
    406407</em></span>
    407 </p></dd></dl></div></div><div class="section" title="acl compatibility (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id308483"></a>
     408</p></dd></dl></div></div><div class="section" title="acl compatibility (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id308480"></a>
    408409
    409410acl compatibility (G)
    410 </h3></div></div></div><a class="indexterm" name="id308484"></a><a name="ACLCOMPATIBILITY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies what OS ACL semantics should
     411</h3></div></div></div><a class="indexterm" name="id308482"></a><a name="ACLCOMPATIBILITY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies what OS ACL semantics should
    411412        be compatible with. Possible values are <span class="emphasis"><em>winnt</em></span> for Windows NT 4,
    412413        <span class="emphasis"><em>win2k</em></span> for Windows 2000 and above and <span class="emphasis"><em>auto</em></span>.
    … …  
    417418</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>acl compatibility</code></em> = <code class="literal">win2k</code>
    418419</em></span>
    419 </p></dd></dl></div></div><div class="section" title="acl group control (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id308550"></a>
     420</p></dd></dl></div></div><div class="section" title="acl group control (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id308548"></a>
    420421
    421422acl group control (S)
    422 </h3></div></div></div><a class="indexterm" name="id308552"></a><a name="ACLGROUPCONTROL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     423</h3></div></div></div><a class="indexterm" name="id308549"></a><a name="ACLGROUPCONTROL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    423424        In a POSIX filesystem, only the owner of a file or directory and the superuser can modify the permissions
    424425        and ACLs on a file. If this parameter is set, then Samba overrides this restriction, and also allows the
    … …  
    447448        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>acl group control</code></em> = <code class="literal">no</code>
    448449</em></span>
    449 </p></dd></dl></div></div><div class="section" title="acl map full control (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id308632"></a>
     450</p></dd></dl></div></div><div class="section" title="acl map full control (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id308629"></a>
    450451
    451452acl map full control (S)
    452 </h3></div></div></div><a class="indexterm" name="id308633"></a><a name="ACLMAPFULLCONTROL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     453</h3></div></div></div><a class="indexterm" name="id308630"></a><a name="ACLMAPFULLCONTROL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    453454        This boolean parameter controls whether <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> maps a POSIX ACE entry of "rwx" (read/write/execute), the maximum
    454455        allowed POSIX permission set, into a Windows ACL of "FULL CONTROL". If this parameter is set to true any POSIX
    … …  
    458459        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>acl map full control</code></em> = <code class="literal">True</code>
    459460</em></span>
    460 </p></dd></dl></div></div><div class="section" title="add group script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id308680"></a>
     461</p></dd></dl></div></div><div class="section" title="add group script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id308677"></a>
    461462
    462463add group script (G)
    463 </h3></div></div></div><a class="indexterm" name="id308681"></a><a name="ADDGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     464</h3></div></div></div><a class="indexterm" name="id308678"></a><a name="ADDGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    464465        This is the full pathname to a script that will be run <span class="emphasis"><em>AS ROOT</em></span> by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when a new group is requested. It
    465466        will expand any <em class="parameter"><code>%g</code></em> to the group name passed. This script is only useful
    … …  
    471472</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>add group script</code></em> = <code class="literal">/usr/sbin/groupadd %g</code>
    472473</em></span>
    473 </p></dd></dl></div></div><div class="section" title="add machine script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id308750"></a>
     474</p></dd></dl></div></div><div class="section" title="add machine script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id308748"></a>
    474475
    475476add machine script (G)
    476 </h3></div></div></div><a class="indexterm" name="id308751"></a><a name="ADDMACHINESCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     477</h3></div></div></div><a class="indexterm" name="id308749"></a><a name="ADDMACHINESCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    477478        This is the full pathname to a script that will  be run by
    478479         <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when a machine is
    … …  
    485486</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>add machine script</code></em> = <code class="literal">/usr/sbin/adduser -n -g machines -c Machine -d /var/lib/nobody -s /bin/false %u</code>
    486487</em></span>
    487 </p></dd></dl></div></div><div class="section" title="add port command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id308823"></a>
     488</p></dd></dl></div></div><div class="section" title="add port command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id308820"></a>
    488489
    489490add port command (G)
    490 </h3></div></div></div><a class="indexterm" name="id308824"></a><a name="ADDPORTCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>Samba 3.0.23 introduced support for adding printer ports
     491</h3></div></div></div><a class="indexterm" name="id308821"></a><a name="ADDPORTCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>Samba 3.0.23 introduced support for adding printer ports
    491492        remotely using the Windows "Add Standard TCP/IP Port Wizard".
    492493        This option defines an external program to be executed when
    493494        smbd receives a request to add a new Port to the system.
    494         The script is passed two parameters:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="parameter"><code>port name</code></em></p></li><li class="listitem"><p><em class="parameter"><code>device URI</code></em></p></li></ul></div><p>The deviceURI is in the for of socket://&lt;hostname&gt;[:&lt;portnumber&gt;]
     495        The script is passed two parameters:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="parameter"><code>port name</code></em></p></li><li class="listitem"><p><em class="parameter"><code>device URI</code></em></p></li></ul></div><p>The deviceURI is in the format of socket://&lt;hostname&gt;[:&lt;portnumber&gt;]
    495496        or lpd://&lt;hostname&gt;/&lt;queuename&gt;.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>add port command</code></em> = <code class="literal"></code>
    496497</em></span>
    497498</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>add port command</code></em> = <code class="literal">/etc/samba/scripts/addport.sh</code>
    498499</em></span>
    499 </p></dd></dl></div></div><div class="section" title="addprinter command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id308901"></a>
     500</p></dd></dl></div></div><div class="section" title="addprinter command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id265681"></a>
    500501
    501502addprinter command (G)
    502 </h3></div></div></div><a class="indexterm" name="id308902"></a><a name="ADDPRINTERCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printing
     503</h3></div></div></div><a class="indexterm" name="id265682"></a><a name="ADDPRINTERCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printing
    503504    support for Windows NT/2000 clients in Samba 2.2, The MS Add
    504505    Printer Wizard (APW) icon is now also available in the
    … …  
    531532</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>addprinter command</code></em> = <code class="literal">/usr/bin/addprinter</code>
    532533</em></span>
    533 </p></dd></dl></div></div><div class="section" title="add share command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id309076"></a>
     534</p></dd></dl></div></div><div class="section" title="add share command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id309147"></a>
    534535
    535536add share command (G)
    536 </h3></div></div></div><a class="indexterm" name="id309077"></a><a name="ADDSHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     537</h3></div></div></div><a class="indexterm" name="id309148"></a><a name="ADDSHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    537538        Samba 2.2.0 introduced the ability to dynamically add and delete shares via the Windows NT 4.0 Server
    538539        Manager.  The <em class="parameter"><code>add share command</code></em> is used to define an external program
    … …  
    566567</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>add share command</code></em> = <code class="literal">/usr/local/bin/addshare</code>
    567568</em></span>
    568 </p></dd></dl></div></div><div class="section" title="add user script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id309253"></a>
     569</p></dd></dl></div></div><div class="section" title="add user script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id309323"></a>
    569570
    570571add user script (G)
    571 </h3></div></div></div><a class="indexterm" name="id309254"></a><a name="ADDUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     572</h3></div></div></div><a class="indexterm" name="id309324"></a><a name="ADDUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    572573        This is the full pathname to a script that will be run <span class="emphasis"><em>AS ROOT</em></span> by
    573574        <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>
    … …  
    604605</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>add user script</code></em> = <code class="literal">/usr/local/samba/bin/add_user %u</code>
    605606</em></span>
    606 </p></dd></dl></div></div><div class="section" title="add user to group script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id309441"></a>
     607</p></dd></dl></div></div><div class="section" title="add user to group script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id309511"></a>
    607608
    608609add user to group script (G)
    609 </h3></div></div></div><a class="indexterm" name="id309442"></a><a name="ADDUSERTOGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     610</h3></div></div></div><a class="indexterm" name="id309512"></a><a name="ADDUSERTOGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    610611        Full path to the script that will be called when a user is added to a group using the Windows NT domain administration
    611612        tools. It will be run by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>
    … …  
    619620</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>add user to group script</code></em> = <code class="literal">/usr/sbin/adduser %u %g</code>
    620621</em></span>
    621 </p></dd></dl></div></div><div class="section" title="administrative share (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id309524"></a>
     622</p></dd></dl></div></div><div class="section" title="administrative share (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id309595"></a>
    622623
    623624administrative share (S)
    624 </h3></div></div></div><a class="indexterm" name="id309526"></a><a name="ADMINISTRATIVESHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is set to <code class="constant">yes</code> for
     625</h3></div></div></div><a class="indexterm" name="id309596"></a><a name="ADMINISTRATIVESHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is set to <code class="constant">yes</code> for
    625626      a share, then the share will be an administrative share. The Administrative
    626627      Shares are the default network shares created by all Windows NT-based
    … …  
    629630      information about this option.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>administrative share</code></em> = <code class="literal">no</code>
    630631</em></span>
    631 </p></dd></dl></div></div><div class="section" title="admin users (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id309577"></a>
     632</p></dd></dl></div></div><div class="section" title="admin users (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id309648"></a>
    632633
    633634admin users (S)
    634 </h3></div></div></div><a class="indexterm" name="id309578"></a><a name="ADMINUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of users who will be granted
     635</h3></div></div></div><a class="indexterm" name="id309649"></a><a name="ADMINUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of users who will be granted
    635636    administrative privileges on the share. This means that they
    636637    will do all file operations as the super-user (root).</p><p>You should use this option very carefully, as any user in
    … …  
    641642</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>admin users</code></em> = <code class="literal">jason</code>
    642643</em></span>
    643 </p></dd></dl></div></div><div class="section" title="afs share (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id309646"></a>
     644</p></dd></dl></div></div><div class="section" title="afs share (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id309716"></a>
    644645
    645646afs share (S)
    646 </h3></div></div></div><a class="indexterm" name="id309647"></a><a name="AFSSHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether special AFS features are enabled
     647</h3></div></div></div><a class="indexterm" name="id309717"></a><a name="AFSSHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether special AFS features are enabled
    647648        for this share. If enabled, it assumes that the directory exported via
    648649        the <em class="parameter"><code>path</code></em> parameter is a local AFS import. The
    … …  
    651652        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>afs share</code></em> = <code class="literal">no</code>
    652653</em></span>
    653 </p></dd></dl></div></div><div class="section" title="afs username map (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id309690"></a>
     654</p></dd></dl></div></div><div class="section" title="afs username map (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id309760"></a>
    654655
    655656afs username map (G)
    656 </h3></div></div></div><a class="indexterm" name="id309691"></a><a name="AFSUSERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>If you are using the fake kaserver AFS feature, you might
     657</h3></div></div></div><a class="indexterm" name="id309762"></a><a name="AFSUSERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>If you are using the fake kaserver AFS feature, you might
    657658        want to hand-craft the usernames you are creating tokens for.
    658659        For example this is necessary if you have users from several domain
    … …  
    664665</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>afs username map</code></em> = <code class="literal">%u@afs.samba.org</code>
    665666</em></span>
    666 </p></dd></dl></div></div><div class="section" title="aio read size (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id309749"></a>
     667</p></dd></dl></div></div><div class="section" title="aio read size (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id309819"></a>
    667668
    668669aio read size (S)
    669 </h3></div></div></div><a class="indexterm" name="id309750"></a><a name="AIOREADSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>If Samba has been built with asynchronous I/O support and this
     670</h3></div></div></div><a class="indexterm" name="id309820"></a><a name="AIOREADSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>If Samba has been built with asynchronous I/O support and this
    670671    integer parameter is set to non-zero value,
    671672    Samba will read from file asynchronously when size of request is bigger
    … …  
    678679    request size</code>
    679680</em></span>
    680 </p></dd></dl></div></div><div class="section" title="aio write behind (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id309827"></a>
     681</p></dd></dl></div></div><div class="section" title="aio write behind (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id309897"></a>
    681682
    682683aio write behind (S)
    683 </h3></div></div></div><a class="indexterm" name="id309828"></a><a name="AIOWRITEBEHIND"></a><div class="variablelist"><dl><dt></dt><dd><p>If Samba has been built with asynchronous I/O support,
     684</h3></div></div></div><a class="indexterm" name="id309898"></a><a name="AIOWRITEBEHIND"></a><div class="variablelist"><dl><dt></dt><dd><p>If Samba has been built with asynchronous I/O support,
    684685        Samba will not wait until write requests are finished before returning
    685686        the result to the client for files listed in this parameter.
    … …  
    696697</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>aio write behind</code></em> = <code class="literal">/*.tmp/</code>
    697698</em></span>
    698 </p></dd></dl></div></div><div class="section" title="aio write size (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id309898"></a>
     699</p></dd></dl></div></div><div class="section" title="aio write size (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id309968"></a>
    699700
    700701aio write size (S)
    701 </h3></div></div></div><a class="indexterm" name="id309899"></a><a name="AIOWRITESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>If Samba has been built with asynchronous I/O support and this
     702</h3></div></div></div><a class="indexterm" name="id309969"></a><a name="AIOWRITESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>If Samba has been built with asynchronous I/O support and this
    702703    integer parameter is set to non-zero value,
    703704    Samba will write to file asynchronously when size of request is bigger
    … …  
    710711    request size</code>
    711712</em></span>
    712 </p></dd></dl></div></div><div class="section" title="algorithmic rid base (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id309976"></a>
     713</p></dd></dl></div></div><div class="section" title="algorithmic rid base (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id310046"></a>
    713714
    714715algorithmic rid base (G)
    715 </h3></div></div></div><a class="indexterm" name="id309977"></a><a name="ALGORITHMICRIDBASE"></a><div class="variablelist"><dl><dt></dt><dd><p>This determines how Samba will use its
     716</h3></div></div></div><a class="indexterm" name="id310047"></a><a name="ALGORITHMICRIDBASE"></a><div class="variablelist"><dl><dt></dt><dd><p>This determines how Samba will use its
    716717    algorithmic mapping from uids/gid to the RIDs needed to construct
    717718    NT Security Identifiers.
    … …  
    728729</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>algorithmic rid base</code></em> = <code class="literal">100000</code>
    729730</em></span>
    730 </p></dd></dl></div></div><div class="section" title="allocation roundup size (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id310041"></a>
     731</p></dd></dl></div></div><div class="section" title="allocation roundup size (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id310111"></a>
    731732
    732733allocation roundup size (S)
    733 </h3></div></div></div><a class="indexterm" name="id310042"></a><a name="ALLOCATIONROUNDUPSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows an administrator to tune the
     734</h3></div></div></div><a class="indexterm" name="id310112"></a><a name="ALLOCATIONROUNDUPSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows an administrator to tune the
    734735    allocation size reported to Windows clients.  The default
    735736    size of 1Mb generally results in improved Windows client
    … …  
    743744# (to disable roundups)</code>
    744745</em></span>
    745 </p></dd></dl></div></div><div class="section" title="allow trusted domains (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id310101"></a>
     746</p></dd></dl></div></div><div class="section" title="allow trusted domains (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id310171"></a>
    746747
    747748allow trusted domains (G)
    748 </h3></div></div></div><a class="indexterm" name="id310102"></a><a name="ALLOWTRUSTEDDOMAINS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     749</h3></div></div></div><a class="indexterm" name="id310172"></a><a name="ALLOWTRUSTEDDOMAINS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    749750    This option only takes effect when the <a class="link" href="smb.conf.5.html#SECURITY" target="_top">security</a> option is set to
    750751    <code class="constant">server</code>, <code class="constant">domain</code> or <code class="constant">ads</code>. 
    … …  
    761762    can make implementing a security boundary difficult.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>allow trusted domains</code></em> = <code class="literal">yes</code>
    762763</em></span>
    763 </p></dd></dl></div></div><div class="section" title="announce as (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id310166"></a>
     764</p></dd></dl></div></div><div class="section" title="announce as (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id310236"></a>
    764765
    765766announce as (G)
    766 </h3></div></div></div><a class="indexterm" name="id310167"></a><a name="ANNOUNCEAS"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies what type of server <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> will announce itself as, to a network neighborhood browse
     767</h3></div></div></div><a class="indexterm" name="id310237"></a><a name="ANNOUNCEAS"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies what type of server <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> will announce itself as, to a network neighborhood browse
    767768    list. By default this is set to Windows NT. The valid options
    768769    are : "NT Server" (which can also be written as "NT"),
    … …  
    776777</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>announce as</code></em> = <code class="literal">Win95</code>
    777778</em></span>
    778 </p></dd></dl></div></div><div class="section" title="announce version (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id310230"></a>
     779</p></dd></dl></div></div><div class="section" title="announce version (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id310300"></a>
    779780
    780781announce version (G)
    781 </h3></div></div></div><a class="indexterm" name="id310231"></a><a name="ANNOUNCEVERSION"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the major and minor version numbers
     782</h3></div></div></div><a class="indexterm" name="id310301"></a><a name="ANNOUNCEVERSION"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the major and minor version numbers
    782783    that nmbd will use when announcing itself as a server. The default
    783784    is 4.9.  Do not change this parameter unless you have a specific
    … …  
    786787</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>announce version</code></em> = <code class="literal">2.0</code>
    787788</em></span>
    788 </p></dd></dl></div></div><div class="section" title="auth methods (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id310285"></a>
     789</p></dd></dl></div></div><div class="section" title="auth methods (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id310355"></a>
    789790
    790791auth methods (G)
    791 </h3></div></div></div><a class="indexterm" name="id310286"></a><a name="AUTHMETHODS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     792</h3></div></div></div><a class="indexterm" name="id310356"></a><a name="AUTHMETHODS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    792793    This option allows the administrator to chose what authentication methods <code class="literal">smbd</code>
    793794    will use when authenticating a user. This option defaults to sensible values based on <a class="link" href="smb.conf.5.html#SECURITY" target="_top">security</a>. 
    … …  
    810811</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>auth methods</code></em> = <code class="literal">guest sam winbind</code>
    811812</em></span>
    812 </p></dd></dl></div></div><div class="section" title="available (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id310379"></a>
     813</p></dd></dl></div></div><div class="section" title="available (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id310450"></a>
    813814
    814815available (S)
    815 </h3></div></div></div><a class="indexterm" name="id310380"></a><a name="AVAILABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter lets you "turn off" a service. If
     816</h3></div></div></div><a class="indexterm" name="id310451"></a><a name="AVAILABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter lets you "turn off" a service. If
    816817        <em class="parameter"><code>available = no</code></em>, then <span class="emphasis"><em>ALL</em></span>
    817818        attempts to connect to the service will fail. Such failures are
    818819        logged.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>available</code></em> = <code class="literal">yes</code>
    819820</em></span>
    820 </p></dd></dl></div></div><div class="section" title="bind interfaces only (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id310425"></a>
     821</p></dd></dl></div></div><div class="section" title="bind interfaces only (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id310496"></a>
    821822
    822823bind interfaces only (G)
    823 </h3></div></div></div><a class="indexterm" name="id310426"></a><a name="BINDINTERFACESONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This global parameter allows the Samba admin
     824</h3></div></div></div><a class="indexterm" name="id310497"></a><a name="BINDINTERFACESONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This global parameter allows the Samba admin
    824825        to limit what interfaces on a machine will serve SMB requests. It
    825826        affects file service <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> and name service <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> in a slightly different ways.</p><p>
    … …  
    862863        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>bind interfaces only</code></em> = <code class="literal">no</code>
    863864</em></span>
    864 </p></dd></dl></div></div><div class="section" title="blocking locks (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id310722"></a>
     865</p></dd></dl></div></div><div class="section" title="blocking locks (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id310793"></a>
    865866
    866867blocking locks (S)
    867 </h3></div></div></div><a class="indexterm" name="id310724"></a><a name="BLOCKINGLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls the behavior
     868</h3></div></div></div><a class="indexterm" name="id310794"></a><a name="BLOCKINGLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls the behavior
    868869        of <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when given a request by a client
    869870        to obtain a byte range lock on a region of an open file, and the
    … …  
    876877        cannot be obtained.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>blocking locks</code></em> = <code class="literal">yes</code>
    877878</em></span>
    878 </p></dd></dl></div></div><div class="section" title="block size (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id310781"></a>
     879</p></dd></dl></div></div><div class="section" title="block size (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id310851"></a>
    879880
    880881block size (S)
    881 </h3></div></div></div><a class="indexterm" name="id310782"></a><a name="BLOCKSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls the behavior of <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when reporting disk free
     882</h3></div></div></div><a class="indexterm" name="id310852"></a><a name="BLOCKSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls the behavior of <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when reporting disk free
    882883    sizes. By default, this reports a disk block size of 1024 bytes.
    883884    </p><p>Changing this parameter may have some effect on the
    … …  
    893894</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>block size</code></em> = <code class="literal">4096</code>
    894895</em></span>
    895 </p></dd></dl></div></div><div class="section" title="browsable"><div class="titlepage"><div><div><h3 class="title"><a name="id310853"></a>
     896</p></dd></dl></div></div><div class="section" title="browsable"><div class="titlepage"><div><div><h3 class="title"><a name="id310923"></a>
    896897
    897898<a name="BROWSABLE"></a>browsable
    898 </h3></div></div></div><a class="indexterm" name="id310854"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#BROWSEABLE">browseable</a>.</p></dd></dl></div></div><div class="section" title="browseable (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id310879"></a>
     899</h3></div></div></div><a class="indexterm" name="id310924"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#BROWSEABLE">browseable</a>.</p></dd></dl></div></div><div class="section" title="browseable (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id310949"></a>
    899900
    900901browseable (S)
    901 </h3></div></div></div><a class="indexterm" name="id310880"></a><a name="BROWSEABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether this share is seen in
     902</h3></div></div></div><a class="indexterm" name="id310950"></a><a name="BROWSEABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether this share is seen in
    902903        the list of available shares in a net view and in the browse list.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>browseable</code></em> = <code class="literal">yes</code>
    903904</em></span>
    904 </p></dd></dl></div></div><div class="section" title="browse list (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id310917"></a>
     905</p></dd></dl></div></div><div class="section" title="browse list (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id310987"></a>
    905906
    906907browse list (G)
    907 </h3></div></div></div><a class="indexterm" name="id310918"></a><a name="BROWSELIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will serve a browse list to
     908</h3></div></div></div><a class="indexterm" name="id310988"></a><a name="BROWSELIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will serve a browse list to
    908909        a client doing a <code class="literal">NetServerEnum</code> call. Normally
    909910        set to <code class="constant">yes</code>. You should never need to change
    910911        this.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>browse list</code></em> = <code class="literal">yes</code>
    911912</em></span>
    912 </p></dd></dl></div></div><div class="section" title="cache directory (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id310970"></a>
     913</p></dd></dl></div></div><div class="section" title="cache directory (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311040"></a>
    913914
    914915cache directory (G)
    915 </h3></div></div></div><a class="indexterm" name="id310971"></a><a name="CACHEDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>Usually, most of the TDB files are stored in the <em class="parameter"><code>lock directory</code></em>. Since Samba 3.4.0, it is
     916</h3></div></div></div><a class="indexterm" name="id311041"></a><a name="CACHEDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>Usually, most of the TDB files are stored in the <em class="parameter"><code>lock directory</code></em>. Since Samba 3.4.0, it is
    916917        possible to differentiate between TDB files with persistent data and
    917918        TDB files with non-persistent data using the
    … …  
    924925</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>cache directory</code></em> = <code class="literal">/var/run/samba/locks/cache</code>
    925926</em></span>
    926 </p></dd></dl></div></div><div class="section" title="casesignames"><div class="titlepage"><div><div><h3 class="title"><a name="id311043"></a>
     927</p></dd></dl></div></div><div class="section" title="casesignames"><div class="titlepage"><div><div><h3 class="title"><a name="id311114"></a>
    927928
    928929<a name="CASESIGNAMES"></a>casesignames
    929 </h3></div></div></div><a class="indexterm" name="id311044"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#CASESENSITIVE">case sensitive</a>.</p></dd></dl></div></div><div class="section" title="case sensitive (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id311070"></a>
     930</h3></div></div></div><a class="indexterm" name="id311115"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#CASESENSITIVE">case sensitive</a>.</p></dd></dl></div></div><div class="section" title="case sensitive (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id311140"></a>
    930931
    931932case sensitive (S)
    932 </h3></div></div></div><a class="indexterm" name="id311071"></a><a name="CASESENSITIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>See the discussion in the section <a class="link" href="smb.conf.5.html#NAMEMANGLING" target="_top">name mangling</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>case sensitive</code></em> = <code class="literal">no</code>
    933 </em></span>
    934 </p></dd></dl></div></div><div class="section" title="change notify (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id311114"></a>
     933</h3></div></div></div><a class="indexterm" name="id311141"></a><a name="CASESENSITIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>See the discussion in the section <a class="link" href="smb.conf.5.html#NAMEMANGLING" target="_top">name mangling</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>case sensitive</code></em> = <code class="literal">no</code>
     934</em></span>
     935</p></dd></dl></div></div><div class="section" title="change notify (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id311185"></a>
    935936
    936937change notify (S)
    937 </h3></div></div></div><a class="indexterm" name="id311115"></a><a name="CHANGENOTIFY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should reply
     938</h3></div></div></div><a class="indexterm" name="id311186"></a><a name="CHANGENOTIFY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should reply
    938939        to a client's file change notify requests.
    939940        </p><p>You should never need to change this parameter</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>change notify</code></em> = <code class="literal">yes</code>
    940941</em></span>
    941 </p></dd></dl></div></div><div class="section" title="change share command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311155"></a>
     942</p></dd></dl></div></div><div class="section" title="change share command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311226"></a>
    942943
    943944change share command (G)
    944 </h3></div></div></div><a class="indexterm" name="id311156"></a><a name="CHANGESHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     945</h3></div></div></div><a class="indexterm" name="id311227"></a><a name="CHANGESHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    945946        Samba 2.2.0 introduced the ability to dynamically add and delete shares via the Windows NT 4.0 Server
    946947Manager.  The <em class="parameter"><code>change share command</code></em> is used to define an external
    … …  
    977978</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>change share command</code></em> = <code class="literal">/usr/local/bin/changeshare</code>
    978979</em></span>
    979 </p></dd></dl></div></div><div class="section" title="check password script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311325"></a>
     980</p></dd></dl></div></div><div class="section" title="check password script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311395"></a>
    980981
    981982check password script (G)
    982 </h3></div></div></div><a class="indexterm" name="id311326"></a><a name="CHECKPASSWORDSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>The name of a program that can be used to check password
     983</h3></div></div></div><a class="indexterm" name="id311396"></a><a name="CHECKPASSWORDSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>The name of a program that can be used to check password
    983984    complexity. The password is sent to the program's standard input.</p><p>The program must return 0 on a good password, or any other value
    984985    if the password is bad.
    … …  
    989990</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>check password script</code></em> = <code class="literal">/usr/local/sbin/crackcheck</code>
    990991</em></span>
    991 </p></dd></dl></div></div><div class="section" title="client lanman auth (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311393"></a>
     992</p></dd></dl></div></div><div class="section" title="client lanman auth (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311463"></a>
    992993
    993994client lanman auth (G)
    994 </h3></div></div></div><a class="indexterm" name="id311394"></a><a name="CLIENTLANMANAUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not <a class="citerefentry" href="smbclient.8.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(8)</span></a> and other samba client
     995</h3></div></div></div><a class="indexterm" name="id311464"></a><a name="CLIENTLANMANAUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not <a class="citerefentry" href="smbclient.8.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(8)</span></a> and other samba client
    995996    tools will attempt to authenticate itself to servers using the
    996997    weaker LANMAN password hash. If disabled, only server which support NT
    … …  
    10031004    attempted.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client lanman auth</code></em> = <code class="literal">no</code>
    10041005</em></span>
    1005 </p></dd></dl></div></div><div class="section" title="client ldap sasl wrapping (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311462"></a>
     1006</p></dd></dl></div></div><div class="section" title="client ldap sasl wrapping (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311533"></a>
    10061007
    10071008client ldap sasl wrapping (G)
    1008 </h3></div></div></div><a class="indexterm" name="id311464"></a><a name="CLIENTLDAPSASLWRAPPING"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1009</h3></div></div></div><a class="indexterm" name="id311534"></a><a name="CLIENTLDAPSASLWRAPPING"></a><div class="variablelist"><dl><dt></dt><dd><p>
    10091010        The <a class="link" href="smb.conf.5.html#CLIENTLDAPSASLWRAPPING" target="_top">client ldap sasl wrapping</a> defines whether
    10101011        ldap traffic will be signed or signed and encrypted (sealed).
    … …  
    10341035        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client ldap sasl wrapping</code></em> = <code class="literal">plain</code>
    10351036</em></span>
    1036 </p></dd></dl></div></div><div class="section" title="client ntlmv2 auth (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311568"></a>
     1037</p></dd></dl></div></div><div class="section" title="client ntlmv2 auth (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311638"></a>
    10371038
    10381039client ntlmv2 auth (G)
    1039 </h3></div></div></div><a class="indexterm" name="id311569"></a><a name="CLIENTNTLMV2AUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not <a class="citerefentry" href="smbclient.8.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(8)</span></a> will attempt to
     1040</h3></div></div></div><a class="indexterm" name="id311640"></a><a name="CLIENTNTLMV2AUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not <a class="citerefentry" href="smbclient.8.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(8)</span></a> will attempt to
    10401041    authenticate itself to servers using the NTLMv2 encrypted password
    10411042    response.</p><p>If enabled, only an NTLMv2 and LMv2 response (both much more
    1042     secure than earlier versions) will be sent.  Many servers
     1043    secure than earlier versions) will be sent.  Older servers
    10431044    (including NT4 &lt; SP4, Win9x and Samba 2.2) are not compatible with
    1044     NTLMv2.  </p><p>Similarly, if enabled, NTLMv1, <code class="literal">client lanman auth</code> and <code class="literal">client plaintext auth</code>
     1045    NTLMv2 when not in an NTLMv2 supporting domain</p><p>Similarly, if enabled, NTLMv1, <code class="literal">client lanman auth</code> and <code class="literal">client plaintext auth</code>
    10451046    authentication will be disabled.  This also disables share-level
    10461047    authentication. </p><p>If disabled, an NTLM response (and possibly a LANMAN response)
    1047     will be sent by the client, depending on the value of <code class="literal">client lanman auth</code>.  </p><p>Note that some sites (particularly
    1048     those following 'best practice' security polices) only allow NTLMv2
    1049         responses, and not the weaker LM or NTLM.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client ntlmv2 auth</code></em> = <code class="literal">no</code>
    1050 </em></span>
    1051 </p></dd></dl></div></div><div class="section" title="client plaintext auth (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311648"></a>
     1048    will be sent by the client, depending on the value of <code class="literal">client lanman auth</code>.  </p><p>Note that Windows Vista and later versions already use
     1049    NTLMv2 by default, and some sites (particularly those following
     1050    'best practice' security polices) only allow NTLMv2 responses, and
     1051    not the weaker LM or NTLM.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client ntlmv2 auth</code></em> = <code class="literal">yes</code>
     1052</em></span>
     1053</p></dd></dl></div></div><div class="section" title="client plaintext auth (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311719"></a>
    10521054
    10531055client plaintext auth (G)
    1054 </h3></div></div></div><a class="indexterm" name="id311649"></a><a name="CLIENTPLAINTEXTAUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies whether a client should send a plaintext
     1056</h3></div></div></div><a class="indexterm" name="id311720"></a><a name="CLIENTPLAINTEXTAUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies whether a client should send a plaintext
    10551057                password if the server does not support encrypted passwords.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client plaintext auth</code></em> = <code class="literal">no</code>
    10561058</em></span>
    1057 </p></dd></dl></div></div><div class="section" title="client schannel (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311686"></a>
     1059</p></dd></dl></div></div><div class="section" title="client schannel (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311757"></a>
    10581060
    10591061client schannel (G)
    1060 </h3></div></div></div><a class="indexterm" name="id311687"></a><a name="CLIENTSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1062</h3></div></div></div><a class="indexterm" name="id311758"></a><a name="CLIENTSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    10611063    This controls whether the client offers or even demands the use of the netlogon schannel.
    10621064    <a class="link" href="smb.conf.5.html#CLIENTSCHANNEL" target="_top">client schannel = no</a> does not offer the schannel,
    … …  
    10681070</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>client schannel</code></em> = <code class="literal">yes</code>
    10691071</em></span>
    1070 </p></dd></dl></div></div><div class="section" title="client signing (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311761"></a>
     1072</p></dd></dl></div></div><div class="section" title="client signing (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311832"></a>
    10711073
    10721074client signing (G)
    1073 </h3></div></div></div><a class="indexterm" name="id311762"></a><a name="CLIENTSIGNING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether the client is allowed or required to use SMB signing. Possible values
     1075</h3></div></div></div><a class="indexterm" name="id311833"></a><a name="CLIENTSIGNING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether the client is allowed or required to use SMB signing. Possible values
    10741076    are <span class="emphasis"><em>auto</em></span>, <span class="emphasis"><em>mandatory</em></span>
    10751077    and <span class="emphasis"><em>disabled</em></span>.
    … …  
    10791081</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client signing</code></em> = <code class="literal">auto</code>
    10801082</em></span>
    1081 </p></dd></dl></div></div><div class="section" title="client use spnego (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311813"></a>
     1083</p></dd></dl></div></div><div class="section" title="client use spnego principal (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311884"></a>
     1084
     1085client use spnego principal (G)
     1086</h3></div></div></div><a class="indexterm" name="id311885"></a><a name="CLIENTUSESPNEGOPRINCIPAL"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not
     1087    <a class="citerefentry" href="smbclient.8.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(8)</span></a> and other samba components
     1088    acting as a client will attempt to use the server-supplied
     1089    principal sometimes given in the SPNEGO exchange.</p><p>If enabled, Samba can attempt to use Kerberos to contact
     1090    servers known only by IP address.  Kerberos relies on names, so
     1091    ordinarily cannot function in this situation. </p><p>If disabled, Samba will use the name used to look up the
     1092    server when asking the KDC for a ticket.  This avoids situations
     1093    where a server may impersonate another, soliciting authentication
     1094    as one principal while being known on the network as another.
     1095    </p><p>Note that Windows XP SP2 and later versions already follow
     1096    this behaviour, and Windows Vista and later servers no longer
     1097    supply this 'rfc4178 hint' principal on the server side.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client use spnego principal</code></em> = <code class="literal">no</code>
     1098</em></span>
     1099</p></dd></dl></div></div><div class="section" title="client use spnego (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311945"></a>
    10821100
    10831101client use spnego (G)
    1084 </h3></div></div></div><a class="indexterm" name="id311814"></a><a name="CLIENTUSESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p> This variable controls whether Samba clients will try
     1102</h3></div></div></div><a class="indexterm" name="id311946"></a><a name="CLIENTUSESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p> This variable controls whether Samba clients will try
    10851103    to use Simple and Protected NEGOciation (as specified by rfc2478) with
    10861104    supporting servers (including WindowsXP, Windows2000 and Samba
    … …  
    10881106    mechanism.  This enables Kerberos authentication in particular.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client use spnego</code></em> = <code class="literal">yes</code>
    10891107</em></span>
    1090 </p></dd></dl></div></div><div class="section" title="cluster addresses (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311852"></a>
     1108</p></dd></dl></div></div><div class="section" title="cluster addresses (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311984"></a>
    10911109
    10921110cluster addresses (G)
    1093 </h3></div></div></div><a class="indexterm" name="id311853"></a><a name="CLUSTERADDRESSES"></a><div class="variablelist"><dl><dt></dt><dd><p>With this parameter you can add additional addresses
     1111</h3></div></div></div><a class="indexterm" name="id311985"></a><a name="CLUSTERADDRESSES"></a><div class="variablelist"><dl><dt></dt><dd><p>With this parameter you can add additional addresses
    10941112        nmbd will register with a WINS server. These addresses are not
    10951113        necessarily present on all nodes simultaneously, but they will
    … …  
    11001118</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>cluster addresses</code></em> = <code class="literal">10.0.0.1 10.0.0.2 10.0.0.3</code>
    11011119</em></span>
    1102 </p></dd></dl></div></div><div class="section" title="clustering (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id311906"></a>
     1120</p></dd></dl></div></div><div class="section" title="clustering (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id312038"></a>
    11031121
    11041122clustering (G)
    1105 </h3></div></div></div><a class="indexterm" name="id311907"></a><a name="CLUSTERING"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should contact
     1123</h3></div></div></div><a class="indexterm" name="id312039"></a><a name="CLUSTERING"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should contact
    11061124        ctdb for accessing its tdb files and use ctdb as a backend
    11071125        for its messaging backend.
    … …  
    11101128        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>clustering</code></em> = <code class="literal">no</code>
    11111129</em></span>
    1112 </p></dd></dl></div></div><div class="section" title="comment (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id311953"></a>
     1130</p></dd></dl></div></div><div class="section" title="comment (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id312085"></a>
    11131131
    11141132comment (S)
    1115 </h3></div></div></div><a class="indexterm" name="id311954"></a><a name="COMMENT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a text field that is seen next to a share
     1133</h3></div></div></div><a class="indexterm" name="id312086"></a><a name="COMMENT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a text field that is seen next to a share
    11161134        when a client does a queries the server, either via the network
    11171135        neighborhood or via <code class="literal">net view</code> to list what shares
    … …  
    11221140</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>comment</code></em> = <code class="literal">Fred's Files</code>
    11231141</em></span>
    1124 </p></dd></dl></div></div><div class="section" title="config backend (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id312024"></a>
     1142</p></dd></dl></div></div><div class="section" title="config backend (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id312156"></a>
    11251143
    11261144config backend (G)
    1127 </h3></div></div></div><a class="indexterm" name="id312025"></a><a name="CONFIGBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1145</h3></div></div></div><a class="indexterm" name="id312157"></a><a name="CONFIGBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    11281146                This controls the backend for storing the configuration.
    11291147                Possible values are <span class="emphasis"><em>file</em></span> (the default)
    … …  
    11431161</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>config backend</code></em> = <code class="literal">registry</code>
    11441162</em></span>
    1145 </p></dd></dl></div></div><div class="section" title="config file (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id312108"></a>
     1163</p></dd></dl></div></div><div class="section" title="config file (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id312239"></a>
    11461164
    11471165config file (G)
    1148 </h3></div></div></div><a class="indexterm" name="id312109"></a><a name="CONFIGFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the config file
     1166</h3></div></div></div><a class="indexterm" name="id312240"></a><a name="CONFIGFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the config file
    11491167        to use, instead of the default (usually <code class="filename">smb.conf</code>).
    11501168        There is a chicken and egg problem here as this option is set
    … …  
    11561174        clients).</p><p><span class="emphasis"><em>No default</em></span></p><p>Example: <span class="emphasis"><em><em class="parameter"><code>config file</code></em> = <code class="literal">/usr/local/samba/lib/smb.conf.%m</code>
    11571175</em></span>
    1158 </p></dd></dl></div></div><div class="section" title="copy (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id312168"></a>
     1176</p></dd></dl></div></div><div class="section" title="copy (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id312300"></a>
    11591177
    11601178copy (S)
    1161 </h3></div></div></div><a class="indexterm" name="id312169"></a><a name="COPY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows you to "clone" service
     1179</h3></div></div></div><a class="indexterm" name="id312301"></a><a name="COPY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows you to "clone" service
    11621180        entries. The specified service is simply duplicated under the
    11631181        current service's name. Any parameters specified in the current
    … …  
    11691187</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>copy</code></em> = <code class="literal">otherservice</code>
    11701188</em></span>
    1171 </p></dd></dl></div></div><div class="section" title="create krb5 conf (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id312227"></a>
     1189</p></dd></dl></div></div><div class="section" title="create krb5 conf (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id312359"></a>
    11721190
    11731191create krb5 conf (G)
    1174 </h3></div></div></div><a class="indexterm" name="id312228"></a><a name="CREATEKRB5CONF"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1192</h3></div></div></div><a class="indexterm" name="id312360"></a><a name="CREATEKRB5CONF"></a><div class="variablelist"><dl><dt></dt><dd><p>
    11751193        Setting this paramter to <code class="literal">no</code> prevents
    11761194        winbind from creating custom krb5.conf files. Winbind normally does
    … …  
    11851203        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>create krb5 conf</code></em> = <code class="literal">yes</code>
    11861204</em></span>
    1187 </p></dd></dl></div></div><div class="section" title="create mode"><div class="titlepage"><div><div><h3 class="title"><a name="id312276"></a>
     1205</p></dd></dl></div></div><div class="section" title="create mode"><div class="titlepage"><div><div><h3 class="title"><a name="id312408"></a>
    11881206
    11891207<a name="CREATEMODE"></a>create mode
    1190 </h3></div></div></div><a class="indexterm" name="id312278"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#CREATEMASK">create mask</a>.</p></dd></dl></div></div><div class="section" title="create mask (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id312303"></a>
     1208</h3></div></div></div><a class="indexterm" name="id312409"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#CREATEMASK">create mask</a>.</p></dd></dl></div></div><div class="section" title="create mask (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id312435"></a>
    11911209
    11921210create mask (S)
    1193 </h3></div></div></div><a class="indexterm" name="id312304"></a><a name="CREATEMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1211</h3></div></div></div><a class="indexterm" name="id312436"></a><a name="CREATEMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
    11941212        When a file is created, the necessary permissions are calculated according to the mapping from DOS modes to
    11951213        UNIX permissions, and the resulting UNIX mode is then bit-wise 'AND'ed with this parameter. This parameter may
    … …  
    12121230</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>create mask</code></em> = <code class="literal">0775</code>
    12131231</em></span>
    1214 </p></dd></dl></div></div><div class="section" title="csc policy (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id312411"></a>
     1232</p></dd></dl></div></div><div class="section" title="csc policy (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id312543"></a>
    12151233
    12161234csc policy (S)
    1217 </h3></div></div></div><a class="indexterm" name="id312412"></a><a name="CSCPOLICY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1235</h3></div></div></div><a class="indexterm" name="id312544"></a><a name="CSCPOLICY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12181236        This stands for <span class="emphasis"><em>client-side caching policy</em></span>, and specifies how clients capable of offline
    12191237        caching will cache the files in the share. The valid values are: manual, documents, programs, disable.
    … …  
    12271245</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>csc policy</code></em> = <code class="literal">programs</code>
    12281246</em></span>
    1229 </p></dd></dl></div></div><div class="section" title="ctdbd socket (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id312483"></a>
     1247</p></dd></dl></div></div><div class="section" title="ctdbd socket (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id312615"></a>
    12301248
    12311249ctdbd socket (G)
    1232 </h3></div></div></div><a class="indexterm" name="id312484"></a><a name="CTDBDSOCKET"></a><div class="variablelist"><dl><dt></dt><dd><p>If you set <code class="literal">clustering=yes</code>,
     1250</h3></div></div></div><a class="indexterm" name="id312616"></a><a name="CTDBDSOCKET"></a><div class="variablelist"><dl><dt></dt><dd><p>If you set <code class="literal">clustering=yes</code>,
    12331251        you need to tell Samba where ctdbd listens on its unix domain
    12341252        socket. The default path as of ctdb 1.0 is /tmp/ctdb.socket which
    … …  
    12381256</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ctdbd socket</code></em> = <code class="literal">/tmp/ctdb.socket</code>
    12391257</em></span>
    1240 </p></dd></dl></div></div><div class="section" title="ctdb timeout (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id312542"></a>
     1258</p></dd></dl></div></div><div class="section" title="ctdb locktime warn threshold (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id312674"></a>
     1259
     1260ctdb locktime warn threshold (G)
     1261</h3></div></div></div><a class="indexterm" name="id312675"></a><a name="CTDBLOCKTIMEWARNTHRESHOLD"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1262        In a cluster environment using Samba and ctdb it is critical
     1263        that locks on central ctdb-hosted databases like locking.tdb
     1264        are not held for long. With the current Samba architecture
     1265        it happens that Samba takes a lock and while holding that
     1266        lock makes file system calls into the shared cluster file
     1267        system. This option makes Samba warn if it detects that it
     1268        has held locks for the specified number of milliseconds. If
     1269        this happens, <span class="emphasis"><em>smbd</em></span> will emit a debug level 0
     1270        message into its logs and potentially into syslog. The most likely
     1271        reason for such a log message is that an operation of the cluster
     1272        file system Samba exports is taking longer than expected.
     1273        The messages are meant as a debugging aid for potential
     1274        cluster problems.
     1275        </p><p>The default value of 0 disables this logging.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ctdb locktime warn threshold</code></em> = <code class="literal">0</code>
     1276</em></span>
     1277</p></dd></dl></div></div><div class="section" title="ctdb timeout (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id312723"></a>
    12411278
    12421279ctdb timeout (G)
    1243 </h3></div></div></div><a class="indexterm" name="id312543"></a><a name="CTDBTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a timeout in seconds for the
     1280</h3></div></div></div><a class="indexterm" name="id312724"></a><a name="CTDBTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a timeout in seconds for the
    12441281          connection between Samba and ctdb. It is only valid if you
    12451282          have compiled Samba with clustering and if you have
    … …  
    12671304        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ctdb timeout</code></em> = <code class="literal">0</code>
    12681305</em></span>
    1269 </p></dd></dl></div></div><div class="section" title="cups connection timeout (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id312614"></a>
     1306</p></dd></dl></div></div><div class="section" title="cups connection timeout (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id312791"></a>
    12701307
    12711308cups connection timeout (G)
    1272 </h3></div></div></div><a class="indexterm" name="id312616"></a><a name="CUPSCONNECTIONTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1309</h3></div></div></div><a class="indexterm" name="id312792"></a><a name="CUPSCONNECTIONTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12731310    This parameter is only applicable if <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing</a> is set to <code class="constant">cups</code>.
    12741311    </p><p>
    … …  
    12801317</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>cups connection timeout</code></em> = <code class="literal">60</code>
    12811318</em></span>
    1282 </p></dd></dl></div></div><div class="section" title="cups encrypt (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id312682"></a>
     1319</p></dd></dl></div></div><div class="section" title="cups encrypt (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id312859"></a>
    12831320
    12841321cups encrypt (G)
    1285 </h3></div></div></div><a class="indexterm" name="id312684"></a><a name="CUPSENCRYPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1322</h3></div></div></div><a class="indexterm" name="id312860"></a><a name="CUPSENCRYPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12861323        This parameter is only applicable if <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing</a>
    12871324        is set to <code class="constant">cups</code> and if you use CUPS newer than
    … …  
    12961333        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>cups encrypt</code></em> = <code class="literal">"no"</code>
    12971334</em></span>
    1298 </p></dd></dl></div></div><div class="section" title="cups options (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id312745"></a>
     1335</p></dd></dl></div></div><div class="section" title="cups options (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id312922"></a>
    12991336
    13001337cups options (S)
    1301 </h3></div></div></div><a class="indexterm" name="id312746"></a><a name="CUPSOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1338</h3></div></div></div><a class="indexterm" name="id312923"></a><a name="CUPSOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    13021339    This parameter is only applicable if <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing</a> is
    13031340    set to <code class="constant">cups</code>.  Its value is a free form string of options
    … …  
    13211358</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>cups options</code></em> = <code class="literal">"raw media=a4"</code>
    13221359</em></span>
    1323 </p></dd></dl></div></div><div class="section" title="cups server (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id312835"></a>
     1360</p></dd></dl></div></div><div class="section" title="cups server (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313011"></a>
    13241361
    13251362cups server (G)
    1326 </h3></div></div></div><a class="indexterm" name="id312836"></a><a name="CUPSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1363</h3></div></div></div><a class="indexterm" name="id313012"></a><a name="CUPSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    13271364    This parameter is only applicable if <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing</a> is set to <code class="constant">cups</code>.
    13281365    </p><p>
    … …  
    13381375</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>cups server</code></em> = <code class="literal">mycupsserver:1631</code>
    13391376</em></span>
    1340 </p></dd></dl></div></div><div class="section" title="deadtime (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id312927"></a>
     1377</p></dd></dl></div></div><div class="section" title="deadtime (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313104"></a>
    13411378
    13421379deadtime (G)
    1343 </h3></div></div></div><a class="indexterm" name="id312928"></a><a name="DEADTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a decimal integer)
     1380</h3></div></div></div><a class="indexterm" name="id313105"></a><a name="DEADTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a decimal integer)
    13441381    represents the number of minutes of inactivity before a connection
    13451382    is considered dead, and it is disconnected. The deadtime only takes
    … …  
    13531390</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>deadtime</code></em> = <code class="literal">15</code>
    13541391</em></span>
    1355 </p></dd></dl></div></div><div class="section" title="debug class (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id312998"></a>
     1392</p></dd></dl></div></div><div class="section" title="debug class (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313174"></a>
    13561393
    13571394debug class (G)
    1358 </h3></div></div></div><a class="indexterm" name="id312999"></a><a name="DEBUGCLASS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1395</h3></div></div></div><a class="indexterm" name="id313175"></a><a name="DEBUGCLASS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    13591396    With this boolean parameter enabled, the debug class (DBGC_CLASS)
    13601397    will be displayed in the debug header.
    … …  
    13641401    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug class</code></em> = <code class="literal">no</code>
    13651402</em></span>
    1366 </p></dd></dl></div></div><div class="section" title="debug hires timestamp (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313048"></a>
     1403</p></dd></dl></div></div><div class="section" title="debug hires timestamp (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313224"></a>
    13671404
    13681405debug hires timestamp (G)
    1369 </h3></div></div></div><a class="indexterm" name="id313049"></a><a name="DEBUGHIRESTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1406</h3></div></div></div><a class="indexterm" name="id313225"></a><a name="DEBUGHIRESTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    13701407    Sometimes the timestamps in the log messages are needed with a resolution of higher that seconds, this
    13711408    boolean parameter adds microsecond resolution to the timestamp  message header when turned on.
    … …  
    13741411    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug hires timestamp</code></em> = <code class="literal">yes</code>
    13751412</em></span>
    1376 </p></dd></dl></div></div><div class="section" title="debug pid (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313097"></a>
     1413</p></dd></dl></div></div><div class="section" title="debug pid (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313273"></a>
    13771414
    13781415debug pid (G)
    1379 </h3></div></div></div><a class="indexterm" name="id313098"></a><a name="DEBUGPID"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1416</h3></div></div></div><a class="indexterm" name="id313274"></a><a name="DEBUGPID"></a><div class="variablelist"><dl><dt></dt><dd><p>
    13801417    When using only one log file for more then one forked <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>-process there may be hard to follow which process outputs which
    13811418    message. This boolean parameter is adds the process-id to the timestamp message headers in the
    … …  
    13851422    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug pid</code></em> = <code class="literal">no</code>
    13861423</em></span>
    1387 </p></dd></dl></div></div><div class="section" title="debug prefix timestamp (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313154"></a>
     1424</p></dd></dl></div></div><div class="section" title="debug prefix timestamp (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313330"></a>
    13881425
    13891426debug prefix timestamp (G)
    1390 </h3></div></div></div><a class="indexterm" name="id313155"></a><a name="DEBUGPREFIXTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1427</h3></div></div></div><a class="indexterm" name="id313332"></a><a name="DEBUGPREFIXTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    13911428    With this option enabled, the timestamp message header is prefixed to the debug message without the
    13921429    filename and function information that is included with the <a class="link" href="smb.conf.5.html#DEBUGTIMESTAMP" target="_top">debug timestamp</a>
    … …  
    13961433    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug prefix timestamp</code></em> = <code class="literal">no</code>
    13971434</em></span>
    1398 </p></dd></dl></div></div><div class="section" title="timestamp logs"><div class="titlepage"><div><div><h3 class="title"><a name="id313211"></a>
     1435</p></dd></dl></div></div><div class="section" title="timestamp logs"><div class="titlepage"><div><div><h3 class="title"><a name="id313387"></a>
    13991436
    14001437<a name="TIMESTAMPLOGS"></a>timestamp logs
    1401 </h3></div></div></div><a class="indexterm" name="id313212"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#DEBUGTIMESTAMP">debug timestamp</a>.</p></dd></dl></div></div><div class="section" title="debug timestamp (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313237"></a>
     1438</h3></div></div></div><a class="indexterm" name="id313388"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#DEBUGTIMESTAMP">debug timestamp</a>.</p></dd></dl></div></div><div class="section" title="debug timestamp (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313414"></a>
    14021439
    14031440debug timestamp (G)
    1404 </h3></div></div></div><a class="indexterm" name="id313238"></a><a name="DEBUGTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1441</h3></div></div></div><a class="indexterm" name="id313415"></a><a name="DEBUGTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    14051442    Samba debug log messages are timestamped by default. If you are running at a high
    14061443    <a class="link" href="smb.conf.5.html#DEBUGLEVEL" target="_top">debug level</a> these timestamps can be distracting. This
    … …  
    14081445        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug timestamp</code></em> = <code class="literal">yes</code>
    14091446</em></span>
    1410 </p></dd></dl></div></div><div class="section" title="debug uid (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313283"></a>
     1447</p></dd></dl></div></div><div class="section" title="debug uid (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313460"></a>
    14111448
    14121449debug uid (G)
    1413 </h3></div></div></div><a class="indexterm" name="id313284"></a><a name="DEBUGUID"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1450</h3></div></div></div><a class="indexterm" name="id313461"></a><a name="DEBUGUID"></a><div class="variablelist"><dl><dt></dt><dd><p>
    14141451    Samba is sometimes run as root and sometime run as the connected user, this boolean parameter inserts the
    14151452    current euid, egid, uid and gid to the timestamp message headers in the log file if turned on.
    … …  
    14181455    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug uid</code></em> = <code class="literal">no</code>
    14191456</em></span>
    1420 </p></dd></dl></div></div><div class="section" title="dedicated keytab file (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313332"></a>
     1457</p></dd></dl></div></div><div class="section" title="dedicated keytab file (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313509"></a>
    14211458
    14221459dedicated keytab file (G)
    1423 </h3></div></div></div><a class="indexterm" name="id313334"></a><a name="DEDICATEDKEYTABFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1460</h3></div></div></div><a class="indexterm" name="id313510"></a><a name="DEDICATEDKEYTABFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    14241461          Specifies the path to the kerberos keytab file when
    14251462          <a class="link" href="smb.conf.5.html#KERBEROSMETHOD" target="_top">kerberos method</a> is set to "dedicated
    … …  
    14291466</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>dedicated keytab file</code></em> = <code class="literal">/usr/local/etc/krb5.keytab</code>
    14301467</em></span>
    1431 </p></dd></dl></div></div><div class="section" title="default case (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id313392"></a>
     1468</p></dd></dl></div></div><div class="section" title="default case (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id313568"></a>
    14321469
    14331470default case (S)
    1434 </h3></div></div></div><a class="indexterm" name="id313393"></a><a name="DEFAULTCASE"></a><div class="variablelist"><dl><dt></dt><dd><p>See the section on <a class="link" href="smb.conf.5.html#NAMEMANGLING" target="_top">name mangling</a>.
     1471</h3></div></div></div><a class="indexterm" name="id313569"></a><a name="DEFAULTCASE"></a><div class="variablelist"><dl><dt></dt><dd><p>See the section on <a class="link" href="smb.conf.5.html#NAMEMANGLING" target="_top">name mangling</a>.
    14351472        Also note the <a class="link" href="smb.conf.5.html#SHORTPRESERVECASE" target="_top">short preserve case</a> parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>default case</code></em> = <code class="literal">lower</code>
    14361473</em></span>
    1437 </p></dd></dl></div></div><div class="section" title="default devmode (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id313443"></a>
     1474</p></dd></dl></div></div><div class="section" title="default devmode (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id313619"></a>
    14381475
    14391476default devmode (S)
    1440 </h3></div></div></div><a class="indexterm" name="id313444"></a><a name="DEFAULTDEVMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only applicable to <a class="link" href="smb.conf.5.html#PRINTABLE" target="_top">printable</a> services.
     1477</h3></div></div></div><a class="indexterm" name="id313620"></a><a name="DEFAULTDEVMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only applicable to <a class="link" href="smb.conf.5.html#PRINTABLE" target="_top">printable</a> services.
    14411478    When smbd is serving Printer Drivers to Windows NT/2k/XP clients, each printer on the Samba
    14421479    server has a Device Mode which defines things such as paper size and
    … …  
    14611498</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>default devmode</code></em> = <code class="literal">yes</code>
    14621499</em></span>
    1463 </p></dd></dl></div></div><div class="section" title="default"><div class="titlepage"><div><div><h3 class="title"><a name="id313517"></a>
     1500</p></dd></dl></div></div><div class="section" title="default"><div class="titlepage"><div><div><h3 class="title"><a name="id313694"></a>
    14641501
    14651502<a name="DEFAULT"></a>default
    1466 </h3></div></div></div><a class="indexterm" name="id313518"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#DEFAULTSERVICE">default service</a>.</p></dd></dl></div></div><div class="section" title="default service (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313544"></a>
     1503</h3></div></div></div><a class="indexterm" name="id313695"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#DEFAULTSERVICE">default service</a>.</p></dd></dl></div></div><div class="section" title="default service (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313720"></a>
    14671504
    14681505default service (G)
    1469 </h3></div></div></div><a class="indexterm" name="id313545"></a><a name="DEFAULTSERVICE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the name of a service
     1506</h3></div></div></div><a class="indexterm" name="id313721"></a><a name="DEFAULTSERVICE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the name of a service
    14701507        which will be connected to if the service actually requested cannot
    14711508        be found. Note that the square brackets are <span class="emphasis"><em>NOT</em></span>
    … …  
    14811518</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>default service</code></em> = <code class="literal">pub</code>
    14821519</em></span>
    1483 </p></dd></dl></div></div><div class="section" title="defer sharing violations (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313637"></a>
     1520</p></dd></dl></div></div><div class="section" title="defer sharing violations (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313813"></a>
    14841521
    14851522defer sharing violations (G)
    1486 </h3></div></div></div><a class="indexterm" name="id313638"></a><a name="DEFERSHARINGVIOLATIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1523</h3></div></div></div><a class="indexterm" name="id313814"></a><a name="DEFERSHARINGVIOLATIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    14871524        Windows allows specifying how a file will be shared with
    14881525        other processes when it is opened. Sharing violations occur when
    … …  
    14971534        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>defer sharing violations</code></em> = <code class="literal">True</code>
    14981535</em></span>
    1499 </p></dd></dl></div></div><div class="section" title="delete group script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313686"></a>
     1536</p></dd></dl></div></div><div class="section" title="delete group script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313862"></a>
    15001537
    15011538delete group script (G)
    1502 </h3></div></div></div><a class="indexterm" name="id313687"></a><a name="DELETEGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the full pathname to a script that will
     1539</h3></div></div></div><a class="indexterm" name="id313863"></a><a name="DELETEGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the full pathname to a script that will
    15031540        be run <span class="emphasis"><em>AS ROOT</em></span> <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when a group is requested to be deleted.
    15041541        It will expand any <em class="parameter"><code>%g</code></em> to the group name passed. 
    … …  
    15061543        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>delete group script</code></em> = <code class="literal"></code>
    15071544</em></span>
    1508 </p></dd></dl></div></div><div class="section" title="deleteprinter command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313740"></a>
     1545</p></dd></dl></div></div><div class="section" title="deleteprinter command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313916"></a>
    15091546
    15101547deleteprinter command (G)
    1511 </h3></div></div></div><a class="indexterm" name="id313741"></a><a name="DELETEPRINTERCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printer
     1548</h3></div></div></div><a class="indexterm" name="id313917"></a><a name="DELETEPRINTERCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printer
    15121549    support for Windows NT/2000 clients in Samba 2.2, it is now
    15131550    possible to delete a printer at run time by issuing the
    … …  
    15271564</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>deleteprinter command</code></em> = <code class="literal">/usr/bin/removeprinter</code>
    15281565</em></span>
    1529 </p></dd></dl></div></div><div class="section" title="delete readonly (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id313856"></a>
     1566</p></dd></dl></div></div><div class="section" title="delete readonly (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id314032"></a>
    15301567
    15311568delete readonly (S)
    1532 </h3></div></div></div><a class="indexterm" name="id313857"></a><a name="DELETEREADONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows readonly files to be deleted. 
     1569</h3></div></div></div><a class="indexterm" name="id314033"></a><a name="DELETEREADONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows readonly files to be deleted. 
    15331570        This is not normal DOS semantics, but is allowed by UNIX.</p><p>This option may be useful for running applications such
    15341571        as rcs, where UNIX file ownership prevents changing file
    15351572        permissions, and DOS semantics prevent deletion of a read only file.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>delete readonly</code></em> = <code class="literal">no</code>
    15361573</em></span>
    1537 </p></dd></dl></div></div><div class="section" title="delete share command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id313898"></a>
     1574</p></dd></dl></div></div><div class="section" title="delete share command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id314075"></a>
    15381575
    15391576delete share command (G)
    1540 </h3></div></div></div><a class="indexterm" name="id313900"></a><a name="DELETESHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1577</h3></div></div></div><a class="indexterm" name="id314076"></a><a name="DELETESHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    15411578        Samba 2.2.0 introduced the ability to dynamically add and delete shares via the Windows NT 4.0 Server
    15421579        Manager.  The <em class="parameter"><code>delete share command</code></em> is used to define an external
    … …  
    15641601</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>delete share command</code></em> = <code class="literal">/usr/local/bin/delshare</code>
    15651602</em></span>
    1566 </p></dd></dl></div></div><div class="section" title="delete user from group script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id314042"></a>
     1603</p></dd></dl></div></div><div class="section" title="delete user from group script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id314218"></a>
    15671604
    15681605delete user from group script (G)
    1569 </h3></div></div></div><a class="indexterm" name="id314043"></a><a name="DELETEUSERFROMGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>Full path to the script that will be called when
     1606</h3></div></div></div><a class="indexterm" name="id314219"></a><a name="DELETEUSERFROMGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>Full path to the script that will be called when
    15701607        a user is removed from a group using the Windows NT domain administration
    15711608        tools. It will be run by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> <span class="emphasis"><em>AS ROOT</em></span>.
    … …  
    15761613</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>delete user from group script</code></em> = <code class="literal">/usr/sbin/deluser %u %g</code>
    15771614</em></span>
    1578 </p></dd></dl></div></div><div class="section" title="delete user script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id314116"></a>
     1615</p></dd></dl></div></div><div class="section" title="delete user script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id314292"></a>
    15791616
    15801617delete user script (G)
    1581 </h3></div></div></div><a class="indexterm" name="id314117"></a><a name="DELETEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the full pathname to a script that will
     1618</h3></div></div></div><a class="indexterm" name="id314293"></a><a name="DELETEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the full pathname to a script that will
    15821619        be run by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when managing users
    15831620        with remote RPC (NT) tools.
    … …  
    15881625</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>delete user script</code></em> = <code class="literal">/usr/local/samba/bin/del_user %u</code>
    15891626</em></span>
    1590 </p></dd></dl></div></div><div class="section" title="delete veto files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id314188"></a>
     1627</p></dd></dl></div></div><div class="section" title="delete veto files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id314364"></a>
    15911628
    15921629delete veto files (S)
    1593 </h3></div></div></div><a class="indexterm" name="id314189"></a><a name="DELETEVETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used when Samba is attempting to
     1630</h3></div></div></div><a class="indexterm" name="id314366"></a><a name="DELETEVETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used when Samba is attempting to
    15941631        delete a directory that contains one or more vetoed directories
    15951632        (see the <a class="link" href="smb.conf.5.html#VETOFILES" target="_top">veto files</a>
    … …  
    16051642        is deleted (so long as the user has permissions to do so).</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>delete veto files</code></em> = <code class="literal">no</code>
    16061643</em></span>
    1607 </p></dd></dl></div></div><div class="section" title="dfree cache time (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id314264"></a>
     1644</p></dd></dl></div></div><div class="section" title="dfree cache time (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id314440"></a>
    16081645
    16091646dfree cache time (S)
    1610 </h3></div></div></div><a class="indexterm" name="id314265"></a><a name="DFREECACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1647</h3></div></div></div><a class="indexterm" name="id314441"></a><a name="DFREECACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    16111648        The <em class="parameter"><code>dfree cache time</code></em> should only be used on systems where a problem
    16121649        occurs with the internal disk space calculations. This has been known to happen with Ultrix, but may occur
    … …  
    16211658        </p><p><span class="emphasis"><em>No default</em></span></p><p>Example: <span class="emphasis"><em><em class="parameter"><code>dfree cache time</code></em> = <code class="literal">dfree cache time = 60</code>
    16221659</em></span>
    1623 </p></dd></dl></div></div><div class="section" title="dfree command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id314329"></a>
     1660</p></dd></dl></div></div><div class="section" title="dfree command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id314506"></a>
    16241661
    16251662dfree command (S)
    1626 </h3></div></div></div><a class="indexterm" name="id314330"></a><a name="DFREECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1663</h3></div></div></div><a class="indexterm" name="id314507"></a><a name="DFREECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    16271664        The <em class="parameter"><code>dfree command</code></em> setting should only be used on systems where a
    16281665        problem occurs with the internal disk space calculations. This has been known to happen with Ultrix, but may
    … …  
    16621699        </p><p><span class="emphasis"><em>No default</em></span></p><p>Example: <span class="emphasis"><em><em class="parameter"><code>dfree command</code></em> = <code class="literal">/usr/local/samba/bin/dfree</code>
    16631700</em></span>
    1664 </p></dd></dl></div></div><div class="section" title="directory mode"><div class="titlepage"><div><div><h3 class="title"><a name="id314435"></a>
     1701</p></dd></dl></div></div><div class="section" title="directory mode"><div class="titlepage"><div><div><h3 class="title"><a name="id314612"></a>
    16651702
    16661703<a name="DIRECTORYMODE"></a>directory mode
    1667 </h3></div></div></div><a class="indexterm" name="id314436"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#DIRECTORYMASK">directory mask</a>.</p></dd></dl></div></div><div class="section" title="directory mask (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id314462"></a>
     1704</h3></div></div></div><a class="indexterm" name="id314613"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#DIRECTORYMASK">directory mask</a>.</p></dd></dl></div></div><div class="section" title="directory mask (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id314638"></a>
    16681705
    16691706directory mask (S)
    1670 </h3></div></div></div><a class="indexterm" name="id314463"></a><a name="DIRECTORYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is the octal modes which are
     1707</h3></div></div></div><a class="indexterm" name="id314639"></a><a name="DIRECTORYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is the octal modes which are
    16711708    used when converting DOS modes to UNIX modes when creating UNIX
    16721709    directories.</p><p>When a directory is created, the necessary permissions are
    … …  
    16861723</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>directory mask</code></em> = <code class="literal">0775</code>
    16871724</em></span>
    1688 </p></dd></dl></div></div><div class="section" title="directory name cache size (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id314556"></a>
     1725</p></dd></dl></div></div><div class="section" title="directory name cache size (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id314732"></a>
    16891726
    16901727directory name cache size (S)
    1691 </h3></div></div></div><a class="indexterm" name="id314557"></a><a name="DIRECTORYNAMECACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1728</h3></div></div></div><a class="indexterm" name="id314733"></a><a name="DIRECTORYNAMECACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    16921729        This parameter specifies the the size of the directory name cache.
    16931730        It will be needed to turn this off for *BSD systems.
    16941731        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>directory name cache size</code></em> = <code class="literal">100</code>
    16951732</em></span>
    1696 </p></dd></dl></div></div><div class="section" title="directory security mask (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id314594"></a>
     1733</p></dd></dl></div></div><div class="section" title="directory security mask (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id314770"></a>
    16971734
    16981735directory security mask (S)
    1699 </h3></div></div></div><a class="indexterm" name="id314595"></a><a name="DIRECTORYSECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls what UNIX permission bits
     1736</h3></div></div></div><a class="indexterm" name="id314771"></a><a name="DIRECTORYSECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls what UNIX permission bits
    17001737    will be set when a Windows NT client is manipulating the UNIX
    17011738    permission on a directory using the native NT security dialog
    … …  
    17171754</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>directory security mask</code></em> = <code class="literal">0700</code>
    17181755</em></span>
    1719 </p></dd></dl></div></div><div class="section" title="disable netbios (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id314682"></a>
     1756</p></dd></dl></div></div><div class="section" title="disable netbios (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id314858"></a>
    17201757
    17211758disable netbios (G)
    1722 </h3></div></div></div><a class="indexterm" name="id314683"></a><a name="DISABLENETBIOS"></a><div class="variablelist"><dl><dt></dt><dd><p>Enabling this parameter will disable netbios support
     1759</h3></div></div></div><a class="indexterm" name="id314859"></a><a name="DISABLENETBIOS"></a><div class="variablelist"><dl><dt></dt><dd><p>Enabling this parameter will disable netbios support
    17231760    in Samba. Netbios is the only available form of browsing in
    17241761    all windows versions except for 2000 and XP. </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Clients that only support netbios won't be able to
    … …  
    17261763        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>disable netbios</code></em> = <code class="literal">no</code>
    17271764</em></span>
    1728 </p></dd></dl></div></div><div class="section" title="disable spoolss (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id314725"></a>
     1765</p></dd></dl></div></div><div class="section" title="disable spoolss (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id314902"></a>
    17291766
    17301767disable spoolss (G)
    1731 </h3></div></div></div><a class="indexterm" name="id314726"></a><a name="DISABLESPOOLSS"></a><div class="variablelist"><dl><dt></dt><dd><p>Enabling this parameter will disable Samba's support
     1768</h3></div></div></div><a class="indexterm" name="id314903"></a><a name="DISABLESPOOLSS"></a><div class="variablelist"><dl><dt></dt><dd><p>Enabling this parameter will disable Samba's support
    17321769    for the SPOOLSS set of MS-RPC's and will yield identical behavior
    17331770    as Samba 2.0.x.  Windows NT/2000 clients will downgrade to using
    … …  
    17411778</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>disable spoolss</code></em> = <code class="literal">no</code>
    17421779</em></span>
    1743 </p></dd></dl></div></div><div class="section" title="display charset (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id314770"></a>
     1780</p></dd></dl></div></div><div class="section" title="display charset (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id314947"></a>
    17441781
    17451782display charset (G)
    1746 </h3></div></div></div><a class="indexterm" name="id314772"></a><a name="DISPLAYCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1783</h3></div></div></div><a class="indexterm" name="id314948"></a><a name="DISPLAYCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>
    17471784        Specifies the charset that samba will use to print messages to stdout and stderr.
    17481785        The default value is "LOCALE", which means automatically set, depending on the
    … …  
    17531790</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>display charset</code></em> = <code class="literal">UTF8</code>
    17541791</em></span>
    1755 </p></dd></dl></div></div><div class="section" title="dmapi support (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id314832"></a>
     1792</p></dd></dl></div></div><div class="section" title="dmapi support (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id315009"></a>
    17561793
    17571794dmapi support (S)
    1758 </h3></div></div></div><a class="indexterm" name="id314834"></a><a name="DMAPISUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should use DMAPI to
     1795</h3></div></div></div><a class="indexterm" name="id315010"></a><a name="DMAPISUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should use DMAPI to
    17591796        determine whether a file is offline or not. This would typically
    17601797        be used in conjunction with a hierarchical storage system that
    … …  
    17711808        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dmapi support</code></em> = <code class="literal">no</code>
    17721809</em></span>
    1773 </p></dd></dl></div></div><div class="section" title="dns proxy (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id314885"></a>
     1810</p></dd></dl></div></div><div class="section" title="dns proxy (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id315062"></a>
    17741811
    17751812dns proxy (G)
    1776 </h3></div></div></div><a class="indexterm" name="id314886"></a><a name="DNSPROXY"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies that <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> when acting as a WINS server and
     1813</h3></div></div></div><a class="indexterm" name="id315063"></a><a name="DNSPROXY"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies that <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> when acting as a WINS server and
    17771814        finding that a NetBIOS name has not been registered, should treat the
    17781815        NetBIOS name word-for-word as a DNS name and do a lookup with the DNS server
    … …  
    17831820        action.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dns proxy</code></em> = <code class="literal">yes</code>
    17841821</em></span>
    1785 </p></dd></dl></div></div><div class="section" title="domain logons (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id314945"></a>
     1822</p></dd></dl></div></div><div class="section" title="domain logons (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id315121"></a>
    17861823
    17871824domain logons (G)
    1788 </h3></div></div></div><a class="indexterm" name="id314946"></a><a name="DOMAINLOGONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1825</h3></div></div></div><a class="indexterm" name="id315122"></a><a name="DOMAINLOGONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    17891826        If set to <code class="constant">yes</code>, the Samba server will
    17901827        provide the netlogon service for Windows 9X network logons for the
    … …  
    17961833        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>domain logons</code></em> = <code class="literal">no</code>
    17971834</em></span>
    1798 </p></dd></dl></div></div><div class="section" title="domain master (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id314995"></a>
     1835</p></dd></dl></div></div><div class="section" title="domain master (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id315171"></a>
    17991836
    18001837domain master (G)
    1801 </h3></div></div></div><a class="indexterm" name="id314996"></a><a name="DOMAINMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1838</h3></div></div></div><a class="indexterm" name="id315172"></a><a name="DOMAINMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    18021839        Tell <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> to enable
    18031840        WAN-wide browse list collation. Setting this option causes <code class="literal">nmbd</code> to claim a
    … …  
    18251862        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>domain master</code></em> = <code class="literal">auto</code>
    18261863</em></span>
    1827 </p></dd></dl></div></div><div class="section" title="dont descend (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id315162"></a>
     1864</p></dd></dl></div></div><div class="section" title="dont descend (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id315338"></a>
    18281865
    18291866dont descend (S)
    1830 </h3></div></div></div><a class="indexterm" name="id315163"></a><a name="DONTDESCEND"></a><div class="variablelist"><dl><dt></dt><dd><p>There are certain directories on some systems
     1867</h3></div></div></div><a class="indexterm" name="id315339"></a><a name="DONTDESCEND"></a><div class="variablelist"><dl><dt></dt><dd><p>There are certain directories on some systems
    18311868        (e.g., the <code class="filename">/proc</code> tree under Linux) that are either not
    18321869        of interest to clients or are infinitely deep (recursive). This
    … …  
    18391876</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>dont descend</code></em> = <code class="literal">/proc,/dev</code>
    18401877</em></span>
    1841 </p></dd></dl></div></div><div class="section" title="dos charset (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id315236"></a>
     1878</p></dd></dl></div></div><div class="section" title="dos charset (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id315412"></a>
    18421879
    18431880dos charset (G)
    1844 </h3></div></div></div><a class="indexterm" name="id315237"></a><a name="DOSCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>DOS SMB clients assume the server has
     1881</h3></div></div></div><a class="indexterm" name="id315413"></a><a name="DOSCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>DOS SMB clients assume the server has
    18451882        the same charset as they do. This option specifies which
    18461883        charset Samba should talk to DOS clients.
    18471884        </p><p>The default depends on which charsets you have installed.
    18481885        Samba tries to use charset 850 but falls back to ASCII in
    1849         case it is not available. Run <a class="citerefentry" href="testparm.1.html"><span class="citerefentry"><span class="refentrytitle">testparm</span>(1)</span></a> to check the default on your system.</p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="dos filemode (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id315274"></a>
     1886        case it is not available. Run <a class="citerefentry" href="testparm.1.html"><span class="citerefentry"><span class="refentrytitle">testparm</span>(1)</span></a> to check the default on your system.</p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="dos filemode (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id315450"></a>
    18501887
    18511888dos filemode (S)
    1852 </h3></div></div></div><a class="indexterm" name="id315275"></a><a name="DOSFILEMODE"></a><div class="variablelist"><dl><dt></dt><dd><p> The default behavior in Samba is to provide
     1889</h3></div></div></div><a class="indexterm" name="id315452"></a><a name="DOSFILEMODE"></a><div class="variablelist"><dl><dt></dt><dd><p> The default behavior in Samba is to provide
    18531890        UNIX-like behavior where only the owner of a file/directory is
    18541891        able to change the permissions on it.  However, this behavior
    … …  
    18671904        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dos filemode</code></em> = <code class="literal">no</code>
    18681905</em></span>
    1869 </p></dd></dl></div></div><div class="section" title="dos filetime resolution (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id315325"></a>
     1906</p></dd></dl></div></div><div class="section" title="dos filetime resolution (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id315494"></a>
    18701907
    18711908dos filetime resolution (S)
    1872 </h3></div></div></div><a class="indexterm" name="id315326"></a><a name="DOSFILETIMERESOLUTION"></a><div class="variablelist"><dl><dt></dt><dd><p>Under the DOS and Windows FAT filesystem, the finest
     1909</h3></div></div></div><a class="indexterm" name="id315495"></a><a name="DOSFILETIMERESOLUTION"></a><div class="variablelist"><dl><dt></dt><dd><p>Under the DOS and Windows FAT filesystem, the finest
    18731910        granularity on time resolution is two seconds. Setting this parameter
    18741911        for a share causes Samba to round the reported time down to the
    … …  
    18851922        happy.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dos filetime resolution</code></em> = <code class="literal">no</code>
    18861923</em></span>
    1887 </p></dd></dl></div></div><div class="section" title="dos filetimes (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id315380"></a>
     1924</p></dd></dl></div></div><div class="section" title="dos filetimes (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id315550"></a>
    18881925
    18891926dos filetimes (S)
    1890 </h3></div></div></div><a class="indexterm" name="id315381"></a><a name="DOSFILETIMES"></a><div class="variablelist"><dl><dt></dt><dd><p>Under DOS and Windows, if a user can write to a
     1927</h3></div></div></div><a class="indexterm" name="id315551"></a><a name="DOSFILETIMES"></a><div class="variablelist"><dl><dt></dt><dd><p>Under DOS and Windows, if a user can write to a
    18911928        file they can change the timestamp on it. Under POSIX semantics,
    18921929        only the owner of the file or root may change the timestamp. By
    … …  
    19011938        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dos filetimes</code></em> = <code class="literal">yes</code>
    19021939</em></span>
    1903 </p></dd></dl></div></div><div class="section" title="ea support (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id315428"></a>
     1940</p></dd></dl></div></div><div class="section" title="ea support (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id315597"></a>
    19041941
    19051942ea support (S)
    1906 </h3></div></div></div><a class="indexterm" name="id315429"></a><a name="EASUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will allow clients to attempt to store OS/2 style Extended
     1943</h3></div></div></div><a class="indexterm" name="id315598"></a><a name="EASUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will allow clients to attempt to store OS/2 style Extended
    19071944    attributes on a share. In order to enable this parameter the underlying filesystem exported by
    19081945    the share must support extended attributes (such as provided on XFS and EXT3 on Linux, with the
    … …  
    19111948                extended attributes must be compiled into the Linux kernel.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ea support</code></em> = <code class="literal">no</code>
    19121949</em></span>
    1913 </p></dd></dl></div></div><div class="section" title="enable asu support (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id315476"></a>
     1950</p></dd></dl></div></div><div class="section" title="enable asu support (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id315646"></a>
    19141951
    19151952enable asu support (G)
    1916 </h3></div></div></div><a class="indexterm" name="id315477"></a><a name="ENABLEASUSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>Hosts running the "Advanced Server for Unix (ASU)" product
     1953</h3></div></div></div><a class="indexterm" name="id315647"></a><a name="ENABLEASUSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>Hosts running the "Advanced Server for Unix (ASU)" product
    19171954    require some special accomodations such as creating a builtin [ADMIN$]
    19181955    share that only supports IPC connections.  The has been the default
    … …  
    19221959    an [ADMIN$] file share in smb.conf.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>enable asu support</code></em> = <code class="literal">no</code>
    19231960</em></span>
    1924 </p></dd></dl></div></div><div class="section" title="enable core files (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id315517"></a>
     1961</p></dd></dl></div></div><div class="section" title="enable core files (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id315687"></a>
    19251962
    19261963enable core files (G)
    1927 </h3></div></div></div><a class="indexterm" name="id315518"></a><a name="ENABLECOREFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether core dumps should be written
     1964</h3></div></div></div><a class="indexterm" name="id315688"></a><a name="ENABLECOREFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether core dumps should be written
    19281965        on internal exits. Normally set to <code class="constant">yes</code>.
    19291966        You should never need to change this.
    … …  
    19321969</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>enable core files</code></em> = <code class="literal">no</code>
    19331970</em></span>
    1934 </p></dd></dl></div></div><div class="section" title="enable privileges (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id315574"></a>
     1971</p></dd></dl></div></div><div class="section" title="enable privileges (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id315743"></a>
    19351972
    19361973enable privileges (G)
    1937 </h3></div></div></div><a class="indexterm" name="id315575"></a><a name="ENABLEPRIVILEGES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1974</h3></div></div></div><a class="indexterm" name="id315744"></a><a name="ENABLEPRIVILEGES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    19381975        This parameter controls whether or not smbd will honor privileges assigned to specific SIDs via either
    19391976         <code class="literal">net rpc rights</code> or one of the Windows user and group manager tools.  This parameter is
    … …  
    19481985        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>enable privileges</code></em> = <code class="literal">yes</code>
    19491986</em></span>
    1950 </p></dd></dl></div></div><div class="section" title="enable spoolss (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id315628"></a>
     1987</p></dd></dl></div></div><div class="section" title="enable spoolss (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id315797"></a>
    19511988
    19521989enable spoolss (G)
    1953 </h3></div></div></div><a class="indexterm" name="id315629"></a><a name="ENABLESPOOLSS"></a><div class="variablelist"><dl><dt></dt><dd><p>Inverted synonym for <a class="link" href="smb.conf.5.html#DISABLESPOOLSS" target="_top">disable spoolss</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>enable spoolss</code></em> = <code class="literal">yes</code>
    1954 </em></span>
    1955 </p></dd></dl></div></div><div class="section" title="encrypt passwords (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id315673"></a>
     1990</h3></div></div></div><a class="indexterm" name="id315798"></a><a name="ENABLESPOOLSS"></a><div class="variablelist"><dl><dt></dt><dd><p>Inverted synonym for <a class="link" href="smb.conf.5.html#DISABLESPOOLSS" target="_top">disable spoolss</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>enable spoolss</code></em> = <code class="literal">yes</code>
     1991</em></span>
     1992</p></dd></dl></div></div><div class="section" title="encrypt passwords (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id315842"></a>
    19561993
    19571994encrypt passwords (G)
    1958 </h3></div></div></div><a class="indexterm" name="id315674"></a><a name="ENCRYPTPASSWORDS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean controls whether encrypted passwords
     1995</h3></div></div></div><a class="indexterm" name="id315843"></a><a name="ENCRYPTPASSWORDS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean controls whether encrypted passwords
    19591996    will be negotiated with the client. Note that Windows NT 4.0 SP3 and
    19601997    above and also Windows 98 will by default expect encrypted passwords
    … …  
    19792016        server.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>encrypt passwords</code></em> = <code class="literal">yes</code>
    19802017</em></span>
    1981 </p></dd></dl></div></div><div class="section" title="enhanced browsing (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id315837"></a>
     2018</p></dd></dl></div></div><div class="section" title="enhanced browsing (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id315940"></a>
    19822019
    19832020enhanced browsing (G)
    1984 </h3></div></div></div><a class="indexterm" name="id315838"></a><a name="ENHANCEDBROWSING"></a><div class="variablelist"><dl><dt></dt><dd><p>This option enables a couple of enhancements to
     2021</h3></div></div></div><a class="indexterm" name="id315941"></a><a name="ENHANCEDBROWSING"></a><div class="variablelist"><dl><dt></dt><dd><p>This option enables a couple of enhancements to
    19852022        cross-subnet browse propagation that have been added in Samba
    19862023        but which are not standard in Microsoft implementations. 
    … …  
    19952032        cross-subnet browse propagation much more reliable.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>enhanced browsing</code></em> = <code class="literal">yes</code>
    19962033</em></span>
    1997 </p></dd></dl></div></div><div class="section" title="enumports command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id315891"></a>
     2034</p></dd></dl></div></div><div class="section" title="enumports command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id315998"></a>
    19982035
    19992036enumports command (G)
    2000 </h3></div></div></div><a class="indexterm" name="id315892"></a><a name="ENUMPORTSCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>The concept of a "port" is fairly foreign
     2037</h3></div></div></div><a class="indexterm" name="id315999"></a><a name="ENUMPORTSCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>The concept of a "port" is fairly foreign
    20012038    to UNIX hosts.  Under Windows NT/2000 print servers, a port
    20022039    is associated with a port monitor and generally takes the form of
    … …  
    20152052</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>enumports command</code></em> = <code class="literal">/usr/bin/listports</code>
    20162053</em></span>
    2017 </p></dd></dl></div></div><div class="section" title="eventlog list (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id315971"></a>
     2054</p></dd></dl></div></div><div class="section" title="eventlog list (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id316079"></a>
    20182055
    20192056eventlog list (G)
    2020 </h3></div></div></div><a class="indexterm" name="id315972"></a><a name="EVENTLOGLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of log names that Samba will
     2057</h3></div></div></div><a class="indexterm" name="id316080"></a><a name="EVENTLOGLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of log names that Samba will
    20212058    report to the Microsoft EventViewer utility.  The listed
    20222059    eventlogs will be associated with tdb file on disk in the
    … …  
    20312068</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>eventlog list</code></em> = <code class="literal">Security Application Syslog Apache</code>
    20322069</em></span>
    2033 </p></dd></dl></div></div><div class="section" title="fake directory create times (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316046"></a>
     2070</p></dd></dl></div></div><div class="section" title="fake directory create times (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316154"></a>
    20342071
    20352072fake directory create times (S)
    2036 </h3></div></div></div><a class="indexterm" name="id316047"></a><a name="FAKEDIRECTORYCREATETIMES"></a><div class="variablelist"><dl><dt></dt><dd><p>NTFS and Windows VFAT file systems keep a create
     2073</h3></div></div></div><a class="indexterm" name="id316155"></a><a name="FAKEDIRECTORYCREATETIMES"></a><div class="variablelist"><dl><dt></dt><dd><p>NTFS and Windows VFAT file systems keep a create
    20372074        time for all files and directories. This is not the same as the
    20382075        ctime - status change time - that Unix keeps, so Samba by default
    … …  
    20562093        will proceed as expected.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>fake directory create times</code></em> = <code class="literal">no</code>
    20572094</em></span>
    2058 </p></dd></dl></div></div><div class="section" title="fake oplocks (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316106"></a>
     2095</p></dd></dl></div></div><div class="section" title="fake oplocks (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316213"></a>
    20592096
    20602097fake oplocks (S)
    2061 </h3></div></div></div><a class="indexterm" name="id316107"></a><a name="FAKEOPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>Oplocks are the way that SMB clients get permission
     2098</h3></div></div></div><a class="indexterm" name="id316214"></a><a name="FAKEOPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>Oplocks are the way that SMB clients get permission
    20622099        from a server to locally cache file operations. If a server grants
    20632100        an oplock (opportunistic lock) then the client is free to assume
    … …  
    20752112        this option carefully!</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>fake oplocks</code></em> = <code class="literal">no</code>
    20762113</em></span>
    2077 </p></dd></dl></div></div><div class="section" title="follow symlinks (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316188"></a>
     2114</p></dd></dl></div></div><div class="section" title="follow symlinks (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316296"></a>
    20782115
    20792116follow symlinks (S)
    2080 </h3></div></div></div><a class="indexterm" name="id316189"></a><a name="FOLLOWSYMLINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2117</h3></div></div></div><a class="indexterm" name="id316297"></a><a name="FOLLOWSYMLINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    20812118        This parameter allows the Samba administrator to stop <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>       from following symbolic links in a particular share. Setting this
    20822119        parameter to <code class="constant">no</code> prevents any file or directory that is a symbolic link from being
    … …  
    20882125        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>follow symlinks</code></em> = <code class="literal">yes</code>
    20892126</em></span>
    2090 </p></dd></dl></div></div><div class="section" title="force create mode (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316258"></a>
     2127</p></dd></dl></div></div><div class="section" title="force create mode (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316366"></a>
    20912128
    20922129force create mode (S)
    2093 </h3></div></div></div><a class="indexterm" name="id316259"></a><a name="FORCECREATEMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a set of UNIX mode bit
     2130</h3></div></div></div><a class="indexterm" name="id316367"></a><a name="FORCECREATEMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a set of UNIX mode bit
    20942131    permissions that will <span class="emphasis"><em>always</em></span> be set on a
    20952132    file created by Samba. This is done by bitwise 'OR'ing these bits onto
    … …  
    21032140</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force create mode</code></em> = <code class="literal">0755</code>
    21042141</em></span>
    2105 </p></dd></dl></div></div><div class="section" title="force directory mode (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316334"></a>
     2142</p></dd></dl></div></div><div class="section" title="force directory mode (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316442"></a>
    21062143
    21072144force directory mode (S)
    2108 </h3></div></div></div><a class="indexterm" name="id316335"></a><a name="FORCEDIRECTORYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a set of UNIX mode bit
     2145</h3></div></div></div><a class="indexterm" name="id316443"></a><a name="FORCEDIRECTORYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a set of UNIX mode bit
    21092146    permissions that will <span class="emphasis"><em>always</em></span> be set on a directory
    21102147    created by Samba. This is done by bitwise 'OR'ing these bits onto the
    … …  
    21192156</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force directory mode</code></em> = <code class="literal">0755</code>
    21202157</em></span>
    2121 </p></dd></dl></div></div><div class="section" title="force directory security mode (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316409"></a>
     2158</p></dd></dl></div></div><div class="section" title="force directory security mode (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316517"></a>
    21222159
    21232160force directory security mode (S)
    2124 </h3></div></div></div><a class="indexterm" name="id316410"></a><a name="FORCEDIRECTORYSECURITYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2161</h3></div></div></div><a class="indexterm" name="id316518"></a><a name="FORCEDIRECTORYSECURITYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    21252162        This parameter controls what UNIX permission bits can be modified when a Windows NT client is manipulating
    21262163        the UNIX permission on a directory using the native NT security dialog box.
    … …  
    21432180</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force directory security mode</code></em> = <code class="literal">700</code>
    21442181</em></span>
    2145 </p></dd></dl></div></div><div class="section" title="group"><div class="titlepage"><div><div><h3 class="title"><a name="id316502"></a>
     2182</p></dd></dl></div></div><div class="section" title="group"><div class="titlepage"><div><div><h3 class="title"><a name="id316610"></a>
    21462183
    21472184<a name="GROUP"></a>group
    2148 </h3></div></div></div><a class="indexterm" name="id316503"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#FORCEGROUP">force group</a>.</p></dd></dl></div></div><div class="section" title="force group (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316534"></a>
     2185</h3></div></div></div><a class="indexterm" name="id316611"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#FORCEGROUP">force group</a>.</p></dd></dl></div></div><div class="section" title="force group (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316642"></a>
    21492186
    21502187force group (S)
    2151 </h3></div></div></div><a class="indexterm" name="id316535"></a><a name="FORCEGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies a UNIX group name that will be
     2188</h3></div></div></div><a class="indexterm" name="id316643"></a><a name="FORCEGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies a UNIX group name that will be
    21522189    assigned as the default primary group for all users connecting
    21532190    to this service. This is useful for sharing files by ensuring
    … …  
    21732210</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force group</code></em> = <code class="literal">agroup</code>
    21742211</em></span>
    2175 </p></dd></dl></div></div><div class="section" title="force printername (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316636"></a>
     2212</p></dd></dl></div></div><div class="section" title="force printername (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316744"></a>
    21762213
    21772214force printername (S)
    2178 </h3></div></div></div><a class="indexterm" name="id316637"></a><a name="FORCEPRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>When printing from Windows NT (or later),
     2215</h3></div></div></div><a class="indexterm" name="id316746"></a><a name="FORCEPRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>When printing from Windows NT (or later),
    21792216    each printer in <code class="filename">smb.conf</code> has two
    21802217    associated names which can be used by the client.  The first
    … …  
    21992236    folder.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>force printername</code></em> = <code class="literal">no</code>
    22002237</em></span>
    2201 </p></dd></dl></div></div><div class="section" title="force security mode (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316716"></a>
     2238</p></dd></dl></div></div><div class="section" title="force security mode (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316824"></a>
    22022239
    22032240force security mode (S)
    2204 </h3></div></div></div><a class="indexterm" name="id316717"></a><a name="FORCESECURITYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2241</h3></div></div></div><a class="indexterm" name="id316825"></a><a name="FORCESECURITYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    22052242        This parameter controls what UNIX permission bits can be modified when a Windows NT client is manipulating
    22062243    the UNIX permission on a file using the native NT security dialog box.
    … …  
    22222259</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force security mode</code></em> = <code class="literal">700</code>
    22232260</em></span>
    2224 </p></dd></dl></div></div><div class="section" title="force unknown acl user (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316807"></a>
     2261</p></dd></dl></div></div><div class="section" title="force unknown acl user (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316915"></a>
    22252262
    22262263force unknown acl user (S)
    2227 </h3></div></div></div><a class="indexterm" name="id316808"></a><a name="FORCEUNKNOWNACLUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2264</h3></div></div></div><a class="indexterm" name="id316916"></a><a name="FORCEUNKNOWNACLUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    22282265    If this parameter is set, a Windows NT ACL that contains an unknown SID (security descriptor, or
    22292266    representation of a user or group id) as the owner or group owner of the file will be silently
    … …  
    22392276    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>force unknown acl user</code></em> = <code class="literal">no</code>
    22402277</em></span>
    2241 </p></dd></dl></div></div><div class="section" title="force user (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316861"></a>
     2278</p></dd></dl></div></div><div class="section" title="force user (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316969"></a>
    22422279
    22432280force user (S)
    2244 </h3></div></div></div><a class="indexterm" name="id316862"></a><a name="FORCEUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies a UNIX user name that will be
     2281</h3></div></div></div><a class="indexterm" name="id316970"></a><a name="FORCEUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies a UNIX user name that will be
    22452282    assigned as the default user for all users connecting to this service.
    22462283    This is useful for sharing files. You should also use it carefully
    … …  
    22562293</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force user</code></em> = <code class="literal">auser</code>
    22572294</em></span>
    2258 </p></dd></dl></div></div><div class="section" title="fstype (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id316931"></a>
     2295</p></dd></dl></div></div><div class="section" title="fstype (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id317039"></a>
    22592296
    22602297fstype (S)
    2261 </h3></div></div></div><a class="indexterm" name="id316932"></a><a name="FSTYPE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2298</h3></div></div></div><a class="indexterm" name="id317040"></a><a name="FSTYPE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    22622299        This parameter allows the administrator to configure the string that specifies the type of filesystem a share
    22632300        is using that is reported by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>
    … …  
    22692306</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>fstype</code></em> = <code class="literal">Samba</code>
    22702307</em></span>
    2271 </p></dd></dl></div></div><div class="section" title="get quota command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id317010"></a>
     2308</p></dd></dl></div></div><div class="section" title="get quota command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id317118"></a>
    22722309
    22732310get quota command (G)
    2274 </h3></div></div></div><a class="indexterm" name="id317011"></a><a name="GETQUOTACOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>The <code class="literal">get quota command</code> should only be used
     2311</h3></div></div></div><a class="indexterm" name="id317119"></a><a name="GETQUOTACOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>The <code class="literal">get quota command</code> should only be used
    22752312        whenever there is no operating system API available from the OS that
    22762313        samba can use.</p><p>This option is only available you have compiled Samba with the
    … …  
    22852322</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>get quota command</code></em> = <code class="literal">/usr/local/sbin/query_quota</code>
    22862323</em></span>
    2287 </p></dd></dl></div></div><div class="section" title="getwd cache (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id317186"></a>
     2324</p></dd></dl></div></div><div class="section" title="getwd cache (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id317294"></a>
    22882325
    22892326getwd cache (G)
    2290 </h3></div></div></div><a class="indexterm" name="id317187"></a><a name="GETWDCACHE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a tuning option. When this is enabled a
     2327</h3></div></div></div><a class="indexterm" name="id317295"></a><a name="GETWDCACHE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a tuning option. When this is enabled a
    22912328    caching algorithm will be used to reduce the time taken for getwd()
    22922329    calls. This can have a significant impact on performance, especially
    22932330    when the <a class="link" href="smb.conf.5.html#WIDESMBCONFOPTIONS" target="_top">wide smbconfoptions</a> parameter is set to <code class="constant">no</code>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>getwd cache</code></em> = <code class="literal">yes</code>
    22942331</em></span>
    2295 </p></dd></dl></div></div><div class="section" title="guest account (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id317244"></a>
     2332</p></dd></dl></div></div><div class="section" title="guest account (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id317352"></a>
    22962333
    22972334guest account (G)
    2298 </h3></div></div></div><a class="indexterm" name="id317245"></a><a name="GUESTACCOUNT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a username which will be used for access
     2335</h3></div></div></div><a class="indexterm" name="id317353"></a><a name="GUESTACCOUNT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a username which will be used for access
    22992336    to services which are specified as <a class="link" href="smb.conf.5.html#GUESTOK" target="_top">guest ok</a> (see below). Whatever privileges this
    23002337    user has will be available to any client connecting to the guest service.
    … …  
    23142351</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>guest account</code></em> = <code class="literal">ftp</code>
    23152352</em></span>
    2316 </p></dd></dl></div></div><div class="section" title="public"><div class="titlepage"><div><div><h3 class="title"><a name="id317343"></a>
     2353</p></dd></dl></div></div><div class="section" title="public"><div class="titlepage"><div><div><h3 class="title"><a name="id317451"></a>
    23172354
    23182355<a name="PUBLIC"></a>public
    2319 </h3></div></div></div><a class="indexterm" name="id317344"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#GUESTOK">guest ok</a>.</p></dd></dl></div></div><div class="section" title="guest ok (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id317374"></a>
     2356</h3></div></div></div><a class="indexterm" name="id317452"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#GUESTOK">guest ok</a>.</p></dd></dl></div></div><div class="section" title="guest ok (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id317482"></a>
    23202357
    23212358guest ok (S)
    2322 </h3></div></div></div><a class="indexterm" name="id317375"></a><a name="GUESTOK"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code> for
     2359</h3></div></div></div><a class="indexterm" name="id317483"></a><a name="GUESTOK"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code> for
    23232360    a service, then no password is required to connect to the service.
    2324     Privileges will be those of the <a class="link" href="smb.conf.5.html#GUESTACCOUNT" target="_top">guest account</a>.</p><p>This paramater nullifies the benifits of setting
     2361    Privileges will be those of the <a class="link" href="smb.conf.5.html#GUESTACCOUNT" target="_top">guest account</a>.</p><p>This parameter nullifies the benefits of setting
    23252362    <a class="link" href="smb.conf.5.html#RESTRICTANONYMOUS" target="_top">restrict anonymous = 2</a>
    23262363        </p><p>See the section below on <a class="link" href="smb.conf.5.html#SECURITY" target="_top">security</a> for more information about this option.
    23272364        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>guest ok</code></em> = <code class="literal">no</code>
    23282365</em></span>
    2329 </p></dd></dl></div></div><div class="section" title="only guest"><div class="titlepage"><div><div><h3 class="title"><a name="id317459"></a>
     2366</p></dd></dl></div></div><div class="section" title="only guest"><div class="titlepage"><div><div><h3 class="title"><a name="id317567"></a>
    23302367
    23312368<a name="ONLYGUEST"></a>only guest
    2332 </h3></div></div></div><a class="indexterm" name="id317460"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#GUESTONLY">guest only</a>.</p></dd></dl></div></div><div class="section" title="guest only (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id317492"></a>
     2369</h3></div></div></div><a class="indexterm" name="id317568"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#GUESTONLY">guest only</a>.</p></dd></dl></div></div><div class="section" title="guest only (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id317600"></a>
    23332370
    23342371guest only (S)
    2335 </h3></div></div></div><a class="indexterm" name="id317493"></a><a name="GUESTONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code> for
     2372</h3></div></div></div><a class="indexterm" name="id317601"></a><a name="GUESTONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code> for
    23362373    a service, then only guest connections to the service are permitted.
    23372374    This parameter will have no effect if <a class="link" href="smb.conf.5.html#GUESTOK" target="_top">guest ok</a> is not set for the service.</p><p>See the section below on <a class="link" href="smb.conf.5.html#SECURITY" target="_top">security</a> for more information about this option.
    23382375        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>guest only</code></em> = <code class="literal">no</code>
    23392376</em></span>
    2340 </p></dd></dl></div></div><div class="section" title="hide dot files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id317561"></a>
     2377</p></dd></dl></div></div><div class="section" title="hide dot files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id317669"></a>
    23412378
    23422379hide dot files (S)
    2343 </h3></div></div></div><a class="indexterm" name="id317562"></a><a name="HIDEDOTFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls whether
     2380</h3></div></div></div><a class="indexterm" name="id317670"></a><a name="HIDEDOTFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls whether
    23442381        files starting with a dot appear as hidden files.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>hide dot files</code></em> = <code class="literal">yes</code>
    23452382</em></span>
    2346 </p></dd></dl></div></div><div class="section" title="hide files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id317602"></a>
     2383</p></dd></dl></div></div><div class="section" title="hide files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id317710"></a>
    23472384
    23482385hide files (S)
    2349 </h3></div></div></div><a class="indexterm" name="id317603"></a><a name="HIDEFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of files or directories that are not
     2386</h3></div></div></div><a class="indexterm" name="id317711"></a><a name="HIDEFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of files or directories that are not
    23502387        visible but are accessible.  The DOS 'hidden' attribute is applied
    23512388        to any files or directories that match.</p><p>Each entry in the list must be separated by a '/',
    … …  
    23692406# no file are hidden</code>
    23702407</em></span>
    2371 </p></dd></dl></div></div><div class="section" title="hide special files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id317681"></a>
     2408</p></dd></dl></div></div><div class="section" title="hide special files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id317789"></a>
    23722409
    23732410hide special files (S)
    2374 </h3></div></div></div><a class="indexterm" name="id317682"></a><a name="HIDESPECIALFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2411</h3></div></div></div><a class="indexterm" name="id317790"></a><a name="HIDESPECIALFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    23752412        This parameter prevents clients from seeing special files such as sockets, devices and
    23762413        fifo's in directory listings.
    23772414        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>hide special files</code></em> = <code class="literal">no</code>
    23782415</em></span>
    2379 </p></dd></dl></div></div><div class="section" title="hide unreadable (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id317722"></a>
     2416</p></dd></dl></div></div><div class="section" title="hide unreadable (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id317830"></a>
    23802417
    23812418hide unreadable (S)
    2382 </h3></div></div></div><a class="indexterm" name="id317723"></a><a name="HIDEUNREADABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter prevents clients from seeing the
     2419</h3></div></div></div><a class="indexterm" name="id317831"></a><a name="HIDEUNREADABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter prevents clients from seeing the
    23832420                existance of files that cannot be read. Defaults to off.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>hide unreadable</code></em> = <code class="literal">no</code>
    23842421</em></span>
    2385 </p></dd></dl></div></div><div class="section" title="hide unwriteable files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id317764"></a>
     2422</p></dd></dl></div></div><div class="section" title="hide unwriteable files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id317872"></a>
    23862423
    23872424hide unwriteable files (S)
    2388 </h3></div></div></div><a class="indexterm" name="id317765"></a><a name="HIDEUNWRITEABLEFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2425</h3></div></div></div><a class="indexterm" name="id317873"></a><a name="HIDEUNWRITEABLEFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    23892426    This parameter prevents clients from seeing the existance of files that cannot be written to.
    23902427    Defaults to off. Note that unwriteable directories are shown as usual.
    23912428    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>hide unwriteable files</code></em> = <code class="literal">no</code>
    23922429</em></span>
    2393 </p></dd></dl></div></div><div class="section" title="homedir map (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id317805"></a>
     2430</p></dd></dl></div></div><div class="section" title="homedir map (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id317914"></a>
    23942431
    23952432homedir map (G)
    2396 </h3></div></div></div><a class="indexterm" name="id317806"></a><a name="HOMEDIRMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2433</h3></div></div></div><a class="indexterm" name="id317915"></a><a name="HOMEDIRMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    23972434        If <a class="link" href="smb.conf.5.html#NISHOMEDIR" target="_top">nis homedir</a> is <code class="constant">yes</code>, and <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> is also acting         as a Win95/98 <em class="parameter"><code>logon server</code></em>
    23982435        then this parameter specifies the NIS (or YP) map from which the server for the user's  home directory should be extracted. 
    … …  
    24092446</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>homedir map</code></em> = <code class="literal">amd.homedir</code>
    24102447</em></span>
    2411 </p></dd></dl></div></div><div class="section" title="host msdfs (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id317912"></a>
     2448</p></dd></dl></div></div><div class="section" title="host msdfs (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id318020"></a>
    24122449
    24132450host msdfs (G)
    2414 </h3></div></div></div><a class="indexterm" name="id317913"></a><a name="HOSTMSDFS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2451</h3></div></div></div><a class="indexterm" name="id318021"></a><a name="HOSTMSDFS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    24152452        If set to <code class="constant">yes</code>, Samba will act as a Dfs server, and allow Dfs-aware clients to browse
    24162453        Dfs trees hosted on the server.
    … …  
    24202457        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>host msdfs</code></em> = <code class="literal">yes</code>
    24212458</em></span>
    2422 </p></dd></dl></div></div><div class="section" title="hostname lookups (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id317974"></a>
     2459</p></dd></dl></div></div><div class="section" title="hostname lookups (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id318082"></a>
    24232460
    24242461hostname lookups (G)
    2425 </h3></div></div></div><a class="indexterm" name="id317975"></a><a name="HOSTNAMELOOKUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies whether samba should use (expensive)
     2462</h3></div></div></div><a class="indexterm" name="id318083"></a><a name="HOSTNAMELOOKUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies whether samba should use (expensive)
    24262463    hostname lookups or use the ip addresses instead. An example place
    24272464    where hostname lookups are currently used is when checking
    … …  
    24312468</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>hostname lookups</code></em> = <code class="literal">yes</code>
    24322469</em></span>
    2433 </p></dd></dl></div></div><div class="section" title="allow hosts"><div class="titlepage"><div><div><h3 class="title"><a name="id318045"></a>
     2470</p></dd></dl></div></div><div class="section" title="allow hosts"><div class="titlepage"><div><div><h3 class="title"><a name="id318153"></a>
    24342471
    24352472<a name="ALLOWHOSTS"></a>allow hosts
    2436 </h3></div></div></div><a class="indexterm" name="id318046"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#HOSTSALLOW">hosts allow</a>.</p></dd></dl></div></div><div class="section" title="hosts allow (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id318077"></a>
     2473</h3></div></div></div><a class="indexterm" name="id318154"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#HOSTSALLOW">hosts allow</a>.</p></dd></dl></div></div><div class="section" title="hosts allow (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id318185"></a>
    24372474
    24382475hosts allow (S)
    2439 </h3></div></div></div><a class="indexterm" name="id318078"></a><a name="HOSTSALLOW"></a><div class="variablelist"><dl><dt></dt><dd><p>A synonym for this parameter is <a class="link" href="smb.conf.5.html#ALLOWHOSTS" target="_top">allow hosts</a>.</p><p>This parameter is a comma, space, or tab delimited
     2476</h3></div></div></div><a class="indexterm" name="id318186"></a><a name="HOSTSALLOW"></a><div class="variablelist"><dl><dt></dt><dd><p>A synonym for this parameter is <a class="link" href="smb.conf.5.html#ALLOWHOSTS" target="_top">allow hosts</a>.</p><p>This parameter is a comma, space, or tab delimited
    24402477    set of hosts which are permitted to access a service.</p><p>If specified in the [global] section then it will
    24412478    apply to all services, regardless of whether the individual
    … …  
    24572494</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>hosts allow</code></em> = <code class="literal">150.203.5. myhost.mynet.edu.au</code>
    24582495</em></span>
    2459 </p></dd></dl></div></div><div class="section" title="deny hosts"><div class="titlepage"><div><div><h3 class="title"><a name="id318265"></a>
     2496</p></dd></dl></div></div><div class="section" title="deny hosts"><div class="titlepage"><div><div><h3 class="title"><a name="id318373"></a>
    24602497
    24612498<a name="DENYHOSTS"></a>deny hosts
    2462 </h3></div></div></div><a class="indexterm" name="id318266"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#HOSTSDENY">hosts deny</a>.</p></dd></dl></div></div><div class="section" title="hosts deny (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id318296"></a>
     2499</h3></div></div></div><a class="indexterm" name="id318374"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#HOSTSDENY">hosts deny</a>.</p></dd></dl></div></div><div class="section" title="hosts deny (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id318404"></a>
    24632500
    24642501hosts deny (S)
    2465 </h3></div></div></div><a class="indexterm" name="id318297"></a><a name="HOSTSDENY"></a><div class="variablelist"><dl><dt></dt><dd><p>The opposite of <em class="parameter"><code>hosts allow</code></em>
     2502</h3></div></div></div><a class="indexterm" name="id318405"></a><a name="HOSTSDENY"></a><div class="variablelist"><dl><dt></dt><dd><p>The opposite of <em class="parameter"><code>hosts allow</code></em>
    24662503    - hosts listed here are <span class="emphasis"><em>NOT</em></span> permitted access to
    24672504    services unless the specific services have their own lists to override
    … …  
    24772514</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>hosts deny</code></em> = <code class="literal">150.203.4. badhost.mynet.edu.au</code>
    24782515</em></span>
    2479 </p></dd></dl></div></div><div class="section" title="idmap alloc backend (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id318393"></a>
    2480 
    2481 idmap alloc backend (G)
    2482 </h3></div></div></div><a class="indexterm" name="id318394"></a><a name="IDMAPALLOCBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    2483         The idmap alloc backend provides a plugin interface for Winbind to use
    2484         when allocating Unix uids/gids for Windows SIDs. This option refers
    2485         to the name of the idmap module which will provide the id allocation
    2486         functionality. Please refer to the man page for each idmap plugin to
    2487         determine whether or not the module implements the allocation feature.
    2488         The most common plugins are the tdb (<a class="citerefentry" href="idmap_tdb.8.html"><span class="citerefentry"><span class="refentrytitle">idmap_tdb</span>(8)</span></a>)
    2489         and ldap (<a class="citerefentry" href="idmap_ldap.8.html"><span class="citerefentry"><span class="refentrytitle">idmap_ldap</span>(8)</span></a>) libraries.
    2490         </p><p>
    2491         This parameter defaults to the value <a class="link" href="smb.conf.5.html#IDMAPBACKEND" target="_top">idmap  backend</a> was set to, so by default winbind will allocate Unix IDs
    2492         from the default backend. You will only need to set this parameter
    2493         explicitly if you have an external source for Unix IDs, like a central
    2494         database service somewhere in your company.
    2495         </p><p>
    2496         Also refer to the <a class="link" href="smb.conf.5.html#IDMAPALLOCCONFIG" target="_top">idmap alloc config</a> option.
    2497         </p><p><span class="emphasis"><em>No default</em></span></p><p>Example: <span class="emphasis"><em><em class="parameter"><code>idmap alloc backend</code></em> = <code class="literal">tdb</code>
    2498 </em></span>
    2499 </p></dd></dl></div></div><div class="section" title="idmap alloc config (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id318490"></a>
     2516</p></dd></dl></div></div><div class="section" title="idmap alloc config (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id318502"></a>
    25002517
    25012518idmap alloc config (G)
    2502 </h3></div></div></div><a class="indexterm" name="id318491"></a><a name="IDMAPALLOCCONFIG"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2519</h3></div></div></div><a class="indexterm" name="id318503"></a><a name="IDMAPALLOCCONFIG"></a><div class="variablelist"><dl><dt></dt><dd><p>
    25032520        The idmap alloc config prefix provides a means of managing settings
    25042521        for the backend defined by the <a class="link" href="smb.conf.5.html#IDMAPALLOCBACKEND" target="_top">idmap alloc backend</a>
    25052522        parameter.  Refer to the man page for each idmap plugin regarding
    25062523        specific configuration details.
    2507         </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="idmap backend (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id318530"></a>
     2524        </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="idmap backend (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id318542"></a>
    25082525
    25092526idmap backend (G)
    2510 </h3></div></div></div><a class="indexterm" name="id318532"></a><a name="IDMAPBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2527</h3></div></div></div><a class="indexterm" name="id318543"></a><a name="IDMAPBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    25112528        The idmap backend provides a plugin interface for Winbind to use
    25122529        varying backends to store SID/uid/gid mapping tables.
    … …  
    25292546        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>idmap backend</code></em> = <code class="literal">tdb</code>
    25302547</em></span>
    2531 </p></dd></dl></div></div><div class="section" title="idmap cache time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id318694"></a>
     2548</p></dd></dl></div></div><div class="section" title="idmap cache time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id318707"></a>
    25322549
    25332550idmap cache time (G)
    2534 </h3></div></div></div><a class="indexterm" name="id318695"></a><a name="IDMAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of seconds that Winbind's
     2551</h3></div></div></div><a class="indexterm" name="id318708"></a><a name="IDMAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of seconds that Winbind's
    25352552        idmap interface will cache positive SID/uid/gid query results.
    25362553        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>idmap cache time</code></em> = <code class="literal">604800 (one week)</code>
    25372554</em></span>
    2538 </p></dd></dl></div></div><div class="section" title="idmap config (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id318736"></a>
     2555</p></dd></dl></div></div><div class="section" title="idmap config (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id318748"></a>
    25392556
    25402557idmap config (G)
    2541 </h3></div></div></div><a class="indexterm" name="id318737"></a><a name="IDMAPCONFIG"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2558</h3></div></div></div><a class="indexterm" name="id318749"></a><a name="IDMAPCONFIG"></a><div class="variablelist"><dl><dt></dt><dd><p>
    25422559        The idmap config prefix provides a means of managing each trusted
    25432560        domain separately. The idmap config prefix should be followed by the
    … …  
    25712588        idmap config CORP : backend  = ad
    25722589        idmap config CORP : range = 1000-999999
    2573         </pre><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="winbind gid"><div class="titlepage"><div><div><h3 class="title"><a name="id318858"></a>
     2590        </pre><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="winbind gid"><div class="titlepage"><div><div><h3 class="title"><a name="id318868"></a>
    25742591
    25752592<a name="WINBINDGID"></a>winbind gid
    2576 </h3></div></div></div><a class="indexterm" name="id318859"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#IDMAPGID">idmap gid</a>.</p></dd></dl></div></div><div class="section" title="idmap gid (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id318889"></a>
     2593</h3></div></div></div><a class="indexterm" name="id318869"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#IDMAPGID">idmap gid</a>.</p></dd></dl></div></div><div class="section" title="idmap gid (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id318899"></a>
    25772594
    25782595idmap gid (G)
    2579 </h3></div></div></div><a class="indexterm" name="id318890"></a><a name="IDMAPGID"></a><div class="variablelist"><dl><dt></dt><dd><p>The idmap gid parameter specifies the range of group ids
     2596</h3></div></div></div><a class="indexterm" name="id318900"></a><a name="IDMAPGID"></a><div class="variablelist"><dl><dt></dt><dd><p>The idmap gid parameter specifies the range of group ids
    25802597        that are allocated for the purpose of mapping UNX groups to NT group
    25812598        SIDs. This range of group ids should have no
    … …  
    25872604</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>idmap gid</code></em> = <code class="literal">10000-20000</code>
    25882605</em></span>
    2589 </p></dd></dl></div></div><div class="section" title="idmap negative cache time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id318972"></a>
     2606</p></dd></dl></div></div><div class="section" title="idmap negative cache time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id318983"></a>
    25902607
    25912608idmap negative cache time (G)
    2592 </h3></div></div></div><a class="indexterm" name="id318973"></a><a name="IDMAPNEGATIVECACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of seconds that Winbind's
     2609</h3></div></div></div><a class="indexterm" name="id318984"></a><a name="IDMAPNEGATIVECACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of seconds that Winbind's
    25932610        idmap interface will cache negative SID/uid/gid query results.
    25942611        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>idmap negative cache time</code></em> = <code class="literal">120</code>
    25952612</em></span>
    2596 </p></dd></dl></div></div><div class="section" title="winbind uid"><div class="titlepage"><div><div><h3 class="title"><a name="id319015"></a>
     2613</p></dd></dl></div></div><div class="section" title="winbind uid"><div class="titlepage"><div><div><h3 class="title"><a name="id319026"></a>
    25972614
    25982615<a name="WINBINDUID"></a>winbind uid
    2599 </h3></div></div></div><a class="indexterm" name="id319016"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#IDMAPUID">idmap uid</a>.</p></dd></dl></div></div><div class="section" title="idmap uid (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id319046"></a>
     2616</h3></div></div></div><a class="indexterm" name="id319027"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#IDMAPUID">idmap uid</a>.</p></dd></dl></div></div><div class="section" title="idmap uid (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id319057"></a>
    26002617
    26012618idmap uid (G)
    2602 </h3></div></div></div><a class="indexterm" name="id319047"></a><a name="IDMAPUID"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2619</h3></div></div></div><a class="indexterm" name="id319058"></a><a name="IDMAPUID"></a><div class="variablelist"><dl><dt></dt><dd><p>
    26032620        The idmap uid parameter specifies the range of user ids that are
    26042621        allocated for use in mapping UNIX users to NT user SIDs. This
    … …  
    26102627</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>idmap uid</code></em> = <code class="literal">10000-20000</code>
    26112628</em></span>
    2612 </p></dd></dl></div></div><div class="section" title="include (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id319129"></a>
     2629</p></dd></dl></div></div><div class="section" title="include (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id319139"></a>
    26132630
    26142631include (G)
    2615 </h3></div></div></div><a class="indexterm" name="id319130"></a><a name="INCLUDE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2632</h3></div></div></div><a class="indexterm" name="id319140"></a><a name="INCLUDE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    26162633        This allows you to include one config file inside another.  The file is included literally, as though typed
    26172634        in place.
    … …  
    26312648</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>include</code></em> = <code class="literal">/usr/local/samba/lib/admin_smb.conf</code>
    26322649</em></span>
    2633 </p></dd></dl></div></div><div class="section" title="inherit acls (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id319225"></a>
     2650</p></dd></dl></div></div><div class="section" title="inherit acls (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id319236"></a>
    26342651
    26352652inherit acls (S)
    2636 </h3></div></div></div><a class="indexterm" name="id319226"></a><a name="INHERITACLS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter can be used to ensure that if default acls
     2653</h3></div></div></div><a class="indexterm" name="id319237"></a><a name="INHERITACLS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter can be used to ensure that if default acls
    26372654    exist on parent directories, they are always honored when creating a
    26382655    new file or subdirectory in these parent directories. The default
    … …  
    26472664</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>inherit acls</code></em> = <code class="literal">no</code>
    26482665</em></span>
    2649 </p></dd></dl></div></div><div class="section" title="inherit owner (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id319271"></a>
     2666</p></dd></dl></div></div><div class="section" title="inherit owner (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id319282"></a>
    26502667
    26512668inherit owner (S)
    2652 </h3></div></div></div><a class="indexterm" name="id319272"></a><a name="INHERITOWNER"></a><div class="variablelist"><dl><dt></dt><dd><p>The ownership of new files and directories
     2669</h3></div></div></div><a class="indexterm" name="id319283"></a><a name="INHERITOWNER"></a><div class="variablelist"><dl><dt></dt><dd><p>The ownership of new files and directories
    26532670        is normally governed by effective uid of the connected user.
    26542671        This option allows the Samba administrator to specify that
    … …  
    26592676        roaming profile directory are actually owner by the user.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>inherit owner</code></em> = <code class="literal">no</code>
    26602677</em></span>
    2661 </p></dd></dl></div></div><div class="section" title="inherit permissions (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id319319"></a>
     2678</p></dd></dl></div></div><div class="section" title="inherit permissions (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id319330"></a>
    26622679
    26632680inherit permissions (S)
    2664 </h3></div></div></div><a class="indexterm" name="id319320"></a><a name="INHERITPERMISSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2681</h3></div></div></div><a class="indexterm" name="id319331"></a><a name="INHERITPERMISSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    26652682        The permissions on new files and directories are normally governed by <a class="link" href="smb.conf.5.html#CREATEMASK" target="_top">create mask</a>,
    26662683        <a class="link" href="smb.conf.5.html#DIRECTORYMASK" target="_top">directory mask</a>, <a class="link" href="smb.conf.5.html#FORCECREATEMODE" target="_top">force create mode</a> and <a class="link" href="smb.conf.5.html#FORCEDIRECTORYMODE" target="_top">force directory mode</a> but the boolean inherit permissions parameter overrides this.
    … …  
    26742691    share to be used flexibly by each user.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>inherit permissions</code></em> = <code class="literal">no</code>
    26752692</em></span>
    2676 </p></dd></dl></div></div><div class="section" title="init logon delayed hosts (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id319457"></a>
     2693</p></dd></dl></div></div><div class="section" title="init logon delayed hosts (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id319468"></a>
    26772694
    26782695init logon delayed hosts (G)
    2679 </h3></div></div></div><a class="indexterm" name="id319458"></a><a name="INITLOGONDELAYEDHOSTS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2696</h3></div></div></div><a class="indexterm" name="id319469"></a><a name="INITLOGONDELAYEDHOSTS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    26802697        This parameter takes a list of host names, addresses or networks for
    26812698        which the initial samlogon reply should be delayed (so other DCs get
    … …  
    26882705</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>init logon delayed hosts</code></em> = <code class="literal">150.203.5. myhost.mynet.de</code>
    26892706</em></span>
    2690 </p></dd></dl></div></div><div class="section" title="init logon delay (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id319531"></a>
     2707</p></dd></dl></div></div><div class="section" title="init logon delay (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id319541"></a>
    26912708
    26922709init logon delay (G)
    2693 </h3></div></div></div><a class="indexterm" name="id319532"></a><a name="INITLOGONDELAY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2710</h3></div></div></div><a class="indexterm" name="id319542"></a><a name="INITLOGONDELAY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    26942711        This parameter specifies a delay in milliseconds for the hosts configured
    26952712        for delayed initial samlogon with
    … …  
    26972714        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>init logon delay</code></em> = <code class="literal">100</code>
    26982715</em></span>
    2699 </p></dd></dl></div></div><div class="section" title="interfaces (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id319582"></a>
     2716</p></dd></dl></div></div><div class="section" title="interfaces (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id319594"></a>
    27002717
    27012718interfaces (G)
    2702 </h3></div></div></div><a class="indexterm" name="id319583"></a><a name="INTERFACES"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to override the default
     2719</h3></div></div></div><a class="indexterm" name="id319595"></a><a name="INTERFACES"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to override the default
    27032720        network interfaces list that Samba will use for browsing, name
    27042721        registration and other NetBIOS over TCP/IP (NBT) traffic. By default Samba will query
    … …  
    27242741</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>interfaces</code></em> = <code class="literal">eth0 192.168.2.10/24 192.168.3.10/255.255.255.0</code>
    27252742</em></span>
    2726 </p></dd></dl></div></div><div class="section" title="invalid users (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id319688"></a>
     2743</p></dd></dl></div></div><div class="section" title="invalid users (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id319699"></a>
    27272744
    27282745invalid users (S)
    2729 </h3></div></div></div><a class="indexterm" name="id319689"></a><a name="INVALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of users that should not be allowed
     2746</h3></div></div></div><a class="indexterm" name="id319700"></a><a name="INVALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of users that should not be allowed
    27302747    to login to this service. This is really a <span class="emphasis"><em>paranoid</em></span>
    27312748    check to absolutely ensure an improper setting does not breach
    … …  
    27472764</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>invalid users</code></em> = <code class="literal">root fred admin @wheel</code>
    27482765</em></span>
    2749 </p></dd></dl></div></div><div class="section" title="iprint server (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id319789"></a>
     2766</p></dd></dl></div></div><div class="section" title="iprint server (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id319800"></a>
    27502767
    27512768iprint server (G)
    2752 </h3></div></div></div><a class="indexterm" name="id319790"></a><a name="IPRINTSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2769</h3></div></div></div><a class="indexterm" name="id319801"></a><a name="IPRINTSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    27532770    This parameter is only applicable if <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing</a> is set to <code class="constant">iprint</code>.
    27542771    </p><p>
    … …  
    27592776</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>iprint server</code></em> = <code class="literal">MYCUPSSERVER</code>
    27602777</em></span>
    2761 </p></dd></dl></div></div><div class="section" title="keepalive (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id319872"></a>
     2778</p></dd></dl></div></div><div class="section" title="keepalive (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id319882"></a>
    27622779
    27632780keepalive (G)
    2764 </h3></div></div></div><a class="indexterm" name="id319873"></a><a name="KEEPALIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (an integer) represents
     2781</h3></div></div></div><a class="indexterm" name="id319884"></a><a name="KEEPALIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (an integer) represents
    27652782    the number of seconds between <em class="parameter"><code>keepalive</code></em>
    27662783    packets. If this parameter is zero, no keepalive packets will be
    … …  
    27722789</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>keepalive</code></em> = <code class="literal">600</code>
    27732790</em></span>
    2774 </p></dd></dl></div></div><div class="section" title="kerberos method (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id319953"></a>
     2791</p></dd></dl></div></div><div class="section" title="kerberos method (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id319964"></a>
    27752792
    27762793kerberos method (G)
    2777 </h3></div></div></div><a class="indexterm" name="id319954"></a><a name="KERBEROSMETHOD"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2794</h3></div></div></div><a class="indexterm" name="id319965"></a><a name="KERBEROSMETHOD"></a><div class="variablelist"><dl><dt></dt><dd><p>
    27782795        Controls how kerberos tickets are verified.
    27792796        </p><p>Valid options are:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>secrets only - use only the secrets.tdb for
    … …  
    27922809        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>kerberos method</code></em> = <code class="literal">secrets only</code>
    27932810</em></span>
    2794 </p></dd></dl></div></div><div class="section" title="kernel change notify (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id320042"></a>
     2811</p></dd></dl></div></div><div class="section" title="kernel change notify (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id320053"></a>
    27952812
    27962813kernel change notify (S)
    2797 </h3></div></div></div><a class="indexterm" name="id320044"></a><a name="KERNELCHANGENOTIFY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should ask the
     2814</h3></div></div></div><a class="indexterm" name="id320054"></a><a name="KERNELCHANGENOTIFY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should ask the
    27982815        kernel for change notifications in directories so that
    27992816        SMB clients can refresh whenever the data on the server changes.
    … …  
    28022819        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>kernel change notify</code></em> = <code class="literal">yes</code>
    28032820</em></span>
    2804 </p></dd></dl></div></div><div class="section" title="kernel oplocks (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320089"></a>
     2821</p></dd></dl></div></div><div class="section" title="kernel oplocks (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320099"></a>
    28052822
    28062823kernel oplocks (G)
    2807 </h3></div></div></div><a class="indexterm" name="id320090"></a><a name="KERNELOPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>For UNIXes that support kernel based <a class="link" href="smb.conf.5.html#OPLOCKS" target="_top">oplocks</a>
     2824</h3></div></div></div><a class="indexterm" name="id320100"></a><a name="KERNELOPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>For UNIXes that support kernel based <a class="link" href="smb.conf.5.html#OPLOCKS" target="_top">oplocks</a>
    28082825        (currently only IRIX and the Linux 2.4 kernel), this parameter
    28092826        allows the use of them to be turned on or off.</p><p>Kernel oplocks support allows Samba <em class="parameter"><code>oplocks
    … …  
    28152832        You should never need to touch this parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>kernel oplocks</code></em> = <code class="literal">yes</code>
    28162833</em></span>
    2817 </p></dd></dl></div></div><div class="section" title="lanman auth (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320171"></a>
     2834</p></dd></dl></div></div><div class="section" title="lanman auth (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320181"></a>
    28182835
    28192836lanman auth (G)
    2820 </h3></div></div></div><a class="indexterm" name="id320172"></a><a name="LANMANAUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will attempt to
     2837</h3></div></div></div><a class="indexterm" name="id320182"></a><a name="LANMANAUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will attempt to
    28212838    authenticate users or permit password changes
    28222839    using the LANMAN password hash. If disabled, only clients which support NT
    … …  
    28402857    special configuration to use it.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>lanman auth</code></em> = <code class="literal">no</code>
    28412858</em></span>
    2842 </p></dd></dl></div></div><div class="section" title="large readwrite (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320265"></a>
     2859</p></dd></dl></div></div><div class="section" title="large readwrite (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320276"></a>
    28432860
    28442861large readwrite (G)
    2845 </h3></div></div></div><a class="indexterm" name="id320266"></a><a name="LARGEREADWRITE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not
     2862</h3></div></div></div><a class="indexterm" name="id320277"></a><a name="LARGEREADWRITE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not
    28462863    <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> supports the new 64k
    28472864    streaming read and write variant SMB requests introduced with
    … …  
    28522869        tested as some other Samba code paths.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>large readwrite</code></em> = <code class="literal">yes</code>
    28532870</em></span>
    2854 </p></dd></dl></div></div><div class="section" title="ldap admin dn (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320321"></a>
     2871</p></dd></dl></div></div><div class="section" title="ldap admin dn (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320328"></a>
    28552872
    28562873ldap admin dn (G)
    2857 </h3></div></div></div><a class="indexterm" name="id320322"></a><a name="LDAPADMINDN"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2874</h3></div></div></div><a class="indexterm" name="id320329"></a><a name="LDAPADMINDN"></a><div class="variablelist"><dl><dt></dt><dd><p>
    28582875        The <a class="link" href="smb.conf.5.html#LDAPADMINDN" target="_top">ldap admin dn</a> defines the Distinguished  Name (DN) name used by Samba to contact
    28592876        the ldap server when retreiving  user account information. The <a class="link" href="smb.conf.5.html#LDAPADMINDN" target="_top">ldap admin dn</a> is used
    … …  
    28632880        </p><p>
    28642881        The <a class="link" href="smb.conf.5.html#LDAPADMINDN" target="_top">ldap admin dn</a> requires a fully specified DN. The <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap  suffix</a> is not appended to the <a class="link" href="smb.conf.5.html#LDAPADMINDN" target="_top">ldap admin dn</a>.
    2865         </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="ldap connection timeout (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320424"></a>
     2882        </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="ldap connection timeout (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320431"></a>
    28662883
    28672884ldap connection timeout (G)
    2868 </h3></div></div></div><a class="indexterm" name="id320425"></a><a name="LDAPCONNECTIONTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2885</h3></div></div></div><a class="indexterm" name="id320432"></a><a name="LDAPCONNECTIONTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    28692886        This parameter tells the LDAP library calls which timeout in seconds
    28702887        they should honor during initial connection establishments to LDAP servers.
    … …  
    28782895        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap connection timeout</code></em> = <code class="literal">2</code>
    28792896</em></span>
    2880 </p></dd></dl></div></div><div class="section" title="ldap debug level (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320482"></a>
     2897</p></dd></dl></div></div><div class="section" title="ldap debug level (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320489"></a>
    28812898
    28822899ldap debug level (G)
    2883 </h3></div></div></div><a class="indexterm" name="id320483"></a><a name="LDAPDEBUGLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2900</h3></div></div></div><a class="indexterm" name="id320490"></a><a name="LDAPDEBUGLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    28842901                This parameter controls the debug level of the LDAP library
    28852902                calls. In the case of OpenLDAP, it is the same
    … …  
    28982915</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap debug level</code></em> = <code class="literal">1</code>
    28992916</em></span>
    2900 </p></dd></dl></div></div><div class="section" title="ldap debug threshold (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320566"></a>
     2917</p></dd></dl></div></div><div class="section" title="ldap debug threshold (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320573"></a>
    29012918
    29022919ldap debug threshold (G)
    2903 </h3></div></div></div><a class="indexterm" name="id320567"></a><a name="LDAPDEBUGTHRESHOLD"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2920</h3></div></div></div><a class="indexterm" name="id320574"></a><a name="LDAPDEBUGTHRESHOLD"></a><div class="variablelist"><dl><dt></dt><dd><p>
    29042921                This parameter controls the Samba debug level at which
    29052922                the ldap library debug output is
    … …  
    29102927</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap debug threshold</code></em> = <code class="literal">5</code>
    29112928</em></span>
    2912 </p></dd></dl></div></div><div class="section" title="ldap delete dn (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320630"></a>
     2929</p></dd></dl></div></div><div class="section" title="ldap delete dn (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320638"></a>
    29132930
    29142931ldap delete dn (G)
    2915 </h3></div></div></div><a class="indexterm" name="id320632"></a><a name="LDAPDELETEDN"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter specifies whether a delete
     2932</h3></div></div></div><a class="indexterm" name="id320639"></a><a name="LDAPDELETEDN"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter specifies whether a delete
    29162933        operation in the ldapsam deletes the complete entry or only the attributes
    29172934        specific to Samba.
    29182935        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap delete dn</code></em> = <code class="literal">no</code>
    29192936</em></span>
    2920 </p></dd></dl></div></div><div class="section" title="ldap deref (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320672"></a>
     2937</p></dd></dl></div></div><div class="section" title="ldap deref (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320680"></a>
    29212938
    29222939ldap deref (G)
    2923 </h3></div></div></div><a class="indexterm" name="id320674"></a><a name="LDAPDEREF"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls whether Samba should tell the LDAP library
     2940</h3></div></div></div><a class="indexterm" name="id320681"></a><a name="LDAPDEREF"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls whether Samba should tell the LDAP library
    29242941        to use a certain alias dereferencing method. The default is
    29252942        <span class="emphasis"><em>auto</em></span>, which means that the default setting of the
    … …  
    29322949</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap deref</code></em> = <code class="literal">searching</code>
    29332950</em></span>
    2934 </p></dd></dl></div></div><div class="section" title="ldap follow referral (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320750"></a>
     2951</p></dd></dl></div></div><div class="section" title="ldap follow referral (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320757"></a>
    29352952
    29362953ldap follow referral (G)
    2937 </h3></div></div></div><a class="indexterm" name="id320751"></a><a name="LDAPFOLLOWREFERRAL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls whether to follow LDAP referrals or not when
     2954</h3></div></div></div><a class="indexterm" name="id320758"></a><a name="LDAPFOLLOWREFERRAL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls whether to follow LDAP referrals or not when
    29382955        searching for entries in the LDAP database. Possible values are
    29392956        <span class="emphasis"><em>on</em></span> to enable following referrals,
    … …  
    29462963</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap follow referral</code></em> = <code class="literal">off</code>
    29472964</em></span>
    2948 </p></dd></dl></div></div><div class="section" title="ldap group suffix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320821"></a>
     2965</p></dd></dl></div></div><div class="section" title="ldap group suffix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320828"></a>
    29492966
    29502967ldap group suffix (G)
    2951 </h3></div></div></div><a class="indexterm" name="id320822"></a><a name="LDAPGROUPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the suffix that is
     2968</h3></div></div></div><a class="indexterm" name="id320829"></a><a name="LDAPGROUPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the suffix that is
    29522969        used for groups when these are added to the LDAP directory.
    29532970        If this parameter is unset, the value of <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap suffix</a> will be used instead.  The suffix string is pre-pended to the
    … …  
    29562973</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap group suffix</code></em> = <code class="literal">ou=Groups</code>
    29572974</em></span>
    2958 </p></dd></dl></div></div><div class="section" title="ldap idmap suffix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320901"></a>
     2975</p></dd></dl></div></div><div class="section" title="ldap idmap suffix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320908"></a>
    29592976
    29602977ldap idmap suffix (G)
    2961 </h3></div></div></div><a class="indexterm" name="id320902"></a><a name="LDAPIDMAPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2978</h3></div></div></div><a class="indexterm" name="id320909"></a><a name="LDAPIDMAPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
    29622979        This parameters specifies the suffix that is used when storing idmap mappings. If this parameter
    29632980        is unset, the value of <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap suffix</a> will be used instead.  The suffix
    … …  
    29672984</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap idmap suffix</code></em> = <code class="literal">ou=Idmap</code>
    29682985</em></span>
    2969 </p></dd></dl></div></div><div class="section" title="ldap machine suffix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320980"></a>
     2986</p></dd></dl></div></div><div class="section" title="ldap machine suffix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id320987"></a>
    29702987
    29712988ldap machine suffix (G)
    2972 </h3></div></div></div><a class="indexterm" name="id320981"></a><a name="LDAPMACHINESUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2989</h3></div></div></div><a class="indexterm" name="id320988"></a><a name="LDAPMACHINESUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
    29732990        It specifies where machines should be added to the ldap tree.  If this parameter is unset, the value of
    29742991        <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap suffix</a> will be used instead.  The suffix string is pre-pended to the
    … …  
    29782995</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap machine suffix</code></em> = <code class="literal">ou=Computers</code>
    29792996</em></span>
    2980 </p></dd></dl></div></div><div class="section" title="ldap page size (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id321059"></a>
     2997</p></dd></dl></div></div><div class="section" title="ldap page size (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id321066"></a>
    29812998
    29822999ldap page size (G)
    2983 </h3></div></div></div><a class="indexterm" name="id321060"></a><a name="LDAPPAGESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3000</h3></div></div></div><a class="indexterm" name="id321067"></a><a name="LDAPPAGESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    29843001        This parameter specifies the number of entries per page.
    29853002        </p><p>If the LDAP server supports paged results, clients can
    … …  
    29903007</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap page size</code></em> = <code class="literal">512</code>
    29913008</em></span>
    2992 </p></dd></dl></div></div><div class="section" title="ldap passwd sync (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id321122"></a>
     3009</p></dd></dl></div></div><div class="section" title="ldap passwd sync (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id321129"></a>
    29933010
    29943011ldap passwd sync (G)
    2995 </h3></div></div></div><a class="indexterm" name="id321123"></a><a name="LDAPPASSWDSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3012</h3></div></div></div><a class="indexterm" name="id321130"></a><a name="LDAPPASSWDSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    29963013        This option is used to define whether or not Samba should sync the LDAP password with the NT
    29973014        and LM hashes for normal accounts (NOT for workstation, server or domain trusts) on a password
    … …  
    30043021                        the LDAP password and let the LDAP server do the rest.</p></li></ul></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap passwd sync</code></em> = <code class="literal">no</code>
    30053022</em></span>
    3006 </p></dd></dl></div></div><div class="section" title="ldap replication sleep (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id321217"></a>
     3023</p></dd></dl></div></div><div class="section" title="ldap replication sleep (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id321224"></a>
    30073024
    30083025ldap replication sleep (G)
    3009 </h3></div></div></div><a class="indexterm" name="id321218"></a><a name="LDAPREPLICATIONSLEEP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3026</h3></div></div></div><a class="indexterm" name="id321226"></a><a name="LDAPREPLICATIONSLEEP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    30103027        When Samba is asked to write to a read-only LDAP replica, we are redirected to talk to the read-write master server.
    30113028        This server then replicates our changes back to the 'local' server, however the replication might take some seconds,
    … …  
    30203037        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap replication sleep</code></em> = <code class="literal">1000</code>
    30213038</em></span>
    3022 </p></dd></dl></div></div><div class="section" title="ldapsam:editposix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id321273"></a>
     3039</p></dd></dl></div></div><div class="section" title="ldapsam:editposix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id321280"></a>
    30233040
    30243041ldapsam:editposix (G)
    3025 </h3></div></div></div><a class="indexterm" name="id321274"></a><a name="LDAPSAM:EDITPOSIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3042</h3></div></div></div><a class="indexterm" name="id321281"></a><a name="LDAPSAM:EDITPOSIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
    30263043        Editposix is an option that leverages ldapsam:trusted to make it simpler to manage a domain controller
    30273044        eliminating the need to set up custom scripts to add and manage the posix users and groups. This option
    … …  
    31013118        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldapsam:editposix</code></em> = <code class="literal">no</code>
    31023119</em></span>
    3103 </p></dd></dl></div></div><div class="section" title="ldapsam:trusted (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id321384"></a>
     3120</p></dd></dl></div></div><div class="section" title="ldapsam:trusted (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id321385"></a>
    31043121
    31053122ldapsam:trusted (G)
    3106 </h3></div></div></div><a class="indexterm" name="id321385"></a><a name="LDAPSAM:TRUSTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3123</h3></div></div></div><a class="indexterm" name="id321386"></a><a name="LDAPSAM:TRUSTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
    31073124        By default, Samba as a Domain Controller with an LDAP backend needs to use the Unix-style NSS subsystem to
    31083125        access user and group information. Due to the way Unix stores user information in /etc/passwd and /etc/group
    … …  
    31223139        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldapsam:trusted</code></em> = <code class="literal">no</code>
    31233140</em></span>
    3124 </p></dd></dl></div></div><div class="section" title="ldap ssl ads (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id321459"></a>
     3141</p></dd></dl></div></div><div class="section" title="ldap ssl ads (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id321460"></a>
    31253142
    31263143ldap ssl ads (G)
    3127 </h3></div></div></div><a class="indexterm" name="id321460"></a><a name="LDAPSSLADS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used to define whether or not Samba should
     3144</h3></div></div></div><a class="indexterm" name="id321461"></a><a name="LDAPSSLADS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used to define whether or not Samba should
    31283145        use SSL when connecting to the ldap server using
    31293146        <span class="emphasis"><em>ads</em></span> methods.
    … …  
    31353152        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap ssl ads</code></em> = <code class="literal">no</code>
    31363153</em></span>
    3137 </p></dd></dl></div></div><div class="section" title="ldap ssl (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id321541"></a>
     3154</p></dd></dl></div></div><div class="section" title="ldap ssl (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id321542"></a>
    31383155
    31393156ldap ssl (G)
    3140 </h3></div></div></div><a class="indexterm" name="id321542"></a><a name="LDAPSSL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used to define whether or not Samba should
     3157</h3></div></div></div><a class="indexterm" name="id321543"></a><a name="LDAPSSL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used to define whether or not Samba should
    31413158        use SSL when connecting to the ldap server
    31423159        This is <span class="emphasis"><em>NOT</em></span> related to
    … …  
    31633180        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap ssl</code></em> = <code class="literal">start tls</code>
    31643181</em></span>
    3165 </p></dd></dl></div></div><div class="section" title="ldap suffix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id321725"></a>
     3182</p></dd></dl></div></div><div class="section" title="ldap suffix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id321726"></a>
    31663183
    31673184ldap suffix (G)
    3168 </h3></div></div></div><a class="indexterm" name="id321726"></a><a name="LDAPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the base for all ldap suffixes and for storing the sambaDomain object.</p><p>
     3185</h3></div></div></div><a class="indexterm" name="id321727"></a><a name="LDAPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the base for all ldap suffixes and for storing the sambaDomain object.</p><p>
    31693186        The ldap suffix will be appended to the values specified for the <a class="link" href="smb.conf.5.html#LDAPUSERSUFFIX" target="_top">ldap user suffix</a>,
    31703187         <a class="link" href="smb.conf.5.html#LDAPGROUPSUFFIX" target="_top">ldap group suffix</a>, <a class="link" href="smb.conf.5.html#LDAPMACHINESUFFIX" target="_top">ldap machine suffix</a>, and the
    … …  
    31753192</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap suffix</code></em> = <code class="literal">dc=samba,dc=org</code>
    31763193</em></span>
    3177 </p></dd></dl></div></div><div class="section" title="ldap timeout (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id321841"></a>
     3194</p></dd></dl></div></div><div class="section" title="ldap timeout (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id321842"></a>
    31783195
    31793196ldap timeout (G)
    3180 </h3></div></div></div><a class="indexterm" name="id321842"></a><a name="LDAPTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3197</h3></div></div></div><a class="indexterm" name="id321843"></a><a name="LDAPTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    31813198        This parameter defines the number of seconds that Samba should use as timeout for LDAP operations.
    31823199        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap timeout</code></em> = <code class="literal">15</code>
    31833200</em></span>
    3184 </p></dd></dl></div></div><div class="section" title="ldap user suffix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id321881"></a>
     3201</p></dd></dl></div></div><div class="section" title="ldap user suffix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id321882"></a>
    31853202
    31863203ldap user suffix (G)
    3187 </h3></div></div></div><a class="indexterm" name="id321882"></a><a name="LDAPUSERSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3204</h3></div></div></div><a class="indexterm" name="id321883"></a><a name="LDAPUSERSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
    31883205        This parameter specifies where users are added to the tree. If this parameter is unset,
    31893206        the value of <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap suffix</a> will be used instead.  The suffix
    … …  
    31933210</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap user suffix</code></em> = <code class="literal">ou=people</code>
    31943211</em></span>
    3195 </p></dd></dl></div></div><div class="section" title="level2 oplocks (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id321960"></a>
     3212</p></dd></dl></div></div><div class="section" title="level2 oplocks (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id321961"></a>
    31963213
    31973214level2 oplocks (S)
    … …  
    32193236
    32203237lm announce (G)
    3221 </h3></div></div></div><a class="indexterm" name="id322057"></a><a name="LMANNOUNCE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines if <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> will produce Lanman announce
     3238</h3></div></div></div><a class="indexterm" name="id322058"></a><a name="LMANNOUNCE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines if <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> will produce Lanman announce
    32223239        broadcasts that are needed by OS/2 clients in order for them to see
    32233240        the Samba server in their browse list. This parameter can have three
    … …  
    32353252</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lm announce</code></em> = <code class="literal">yes</code>
    32363253</em></span>
    3237 </p></dd></dl></div></div><div class="section" title="lm interval (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id322171"></a>
     3254</p></dd></dl></div></div><div class="section" title="lm interval (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id322172"></a>
    32383255
    32393256lm interval (G)
    3240 </h3></div></div></div><a class="indexterm" name="id322172"></a><a name="LMINTERVAL"></a><div class="variablelist"><dl><dt></dt><dd><p>If Samba is set to produce Lanman announce
     3257</h3></div></div></div><a class="indexterm" name="id322173"></a><a name="LMINTERVAL"></a><div class="variablelist"><dl><dt></dt><dd><p>If Samba is set to produce Lanman announce
    32413258        broadcasts needed by OS/2 clients (see the
    32423259                <a class="link" href="smb.conf.5.html#LMANNOUNCE" target="_top">lm announce</a> parameter) then this
    … …  
    32483265</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lm interval</code></em> = <code class="literal">120</code>
    32493266</em></span>
    3250 </p></dd></dl></div></div><div class="section" title="load printers (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id322252"></a>
     3267</p></dd></dl></div></div><div class="section" title="load printers (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id322253"></a>
    32513268
    32523269load printers (G)
    3253 </h3></div></div></div><a class="indexterm" name="id322253"></a><a name="LOADPRINTERS"></a><div class="variablelist"><dl><dt></dt><dd><p>A boolean variable that controls whether all
     3270</h3></div></div></div><a class="indexterm" name="id322254"></a><a name="LOADPRINTERS"></a><div class="variablelist"><dl><dt></dt><dd><p>A boolean variable that controls whether all
    32543271    printers in the printcap will be loaded for browsing by default.
    32553272    See the <a class="link" href="smb.conf.5.html#PRINTERS" target="_top">printers</a> section for
    32563273    more details.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>load printers</code></em> = <code class="literal">yes</code>
    32573274</em></span>
    3258 </p></dd></dl></div></div><div class="section" title="local master (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id322306"></a>
     3275</p></dd></dl></div></div><div class="section" title="local master (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id322307"></a>
    32593276
    32603277local master (G)
    3261 </h3></div></div></div><a class="indexterm" name="id322307"></a><a name="LOCALMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> to try and become a local master browser
     3278</h3></div></div></div><a class="indexterm" name="id322308"></a><a name="LOCALMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> to try and become a local master browser
    32623279        on a subnet. If set to <code class="constant">no</code> then <code class="literal">
    32633280        nmbd</code> will not attempt to become a local master browser
    … …  
    32693286master browser.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>local master</code></em> = <code class="literal">yes</code>
    32703287</em></span>
    3271 </p></dd></dl></div></div><div class="section" title="lock dir"><div class="titlepage"><div><div><h3 class="title"><a name="id322402"></a>
     3288</p></dd></dl></div></div><div class="section" title="lock dir"><div class="titlepage"><div><div><h3 class="title"><a name="id322403"></a>
    32723289
    32733290<a name="LOCKDIR"></a>lock dir
    3274 </h3></div></div></div><a class="indexterm" name="id322403"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#LOCKDIRECTORY">lock directory</a>.</p></dd></dl></div></div><div class="section" title="lock directory (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id322434"></a>
     3291</h3></div></div></div><a class="indexterm" name="id322404"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#LOCKDIRECTORY">lock directory</a>.</p></dd></dl></div></div><div class="section" title="lock directory (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id322434"></a>
    32753292
    32763293lock directory (G)
    3277 </h3></div></div></div><a class="indexterm" name="id322435"></a><a name="LOCKDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the directory where lock
     3294</h3></div></div></div><a class="indexterm" name="id322436"></a><a name="LOCKDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the directory where lock
    32783295        files will be placed.  The lock files are used to implement the
    32793296        <a class="link" href="smb.conf.5.html#MAXCONNECTIONS" target="_top">max connections</a> option.
    … …  
    32853302</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lock directory</code></em> = <code class="literal">/var/run/samba/locks</code>
    32863303</em></span>
    3287 </p></dd></dl></div></div><div class="section" title="locking (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id322508"></a>
     3304</p></dd></dl></div></div><div class="section" title="locking (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id322509"></a>
    32883305
    32893306locking (S)
    3290 </h3></div></div></div><a class="indexterm" name="id322509"></a><a name="LOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether or not locking will be
     3307</h3></div></div></div><a class="indexterm" name="id322510"></a><a name="LOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether or not locking will be
    32913308        performed by the server in response to lock requests from the
    32923309        client.</p><p>If <code class="literal">locking = no</code>, all lock and unlock
    … …  
    32983315        is not really recommended even in this case.</p><p>Be careful about disabling locking either globally or in a
    32993316        specific service, as lack of locking may result in data corruption.
    3300         You should never need to set this parameter.</p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="lock spin count (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id322577"></a>
     3317        You should never need to set this parameter.</p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="lock spin count (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id322578"></a>
    33013318
    33023319lock spin count (G)
    3303 </h3></div></div></div><a class="indexterm" name="id322578"></a><a name="LOCKSPINCOUNT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter has been made inoperative in Samba 3.0.24.
     3320</h3></div></div></div><a class="indexterm" name="id322579"></a><a name="LOCKSPINCOUNT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter has been made inoperative in Samba 3.0.24.
    33043321        The functionality it contolled is now controlled by the parameter
    33053322        <a class="link" href="smb.conf.5.html#LOCKSPINTIME" target="_top">lock spin time</a>.
    33063323        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>lock spin count</code></em> = <code class="literal">0</code>
    33073324</em></span>
    3308 </p></dd></dl></div></div><div class="section" title="lock spin time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id322630"></a>
     3325</p></dd></dl></div></div><div class="section" title="lock spin time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id322631"></a>
    33093326
    33103327lock spin time (G)
    3311 </h3></div></div></div><a class="indexterm" name="id322631"></a><a name="LOCKSPINTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The time in milliseconds that smbd should
     3328</h3></div></div></div><a class="indexterm" name="id322632"></a><a name="LOCKSPINTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The time in milliseconds that smbd should
    33123329        keep waiting to see if a failed lock request can
    33133330        be granted. This parameter has changed in default
    … …  
    33173334        to change the value of this parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>lock spin time</code></em> = <code class="literal">200</code>
    33183335</em></span>
    3319 </p></dd></dl></div></div><div class="section" title="log file (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id322684"></a>
     3336</p></dd></dl></div></div><div class="section" title="log file (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id322685"></a>
    33203337
    33213338log file (G)
    3322 </h3></div></div></div><a class="indexterm" name="id322685"></a><a name="LOGFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3339</h3></div></div></div><a class="indexterm" name="id322686"></a><a name="LOGFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    33233340    This option allows you to override the name of the Samba log file (also known as the debug file).
    33243341    </p><p>
    … …  
    33263343    </p><p><span class="emphasis"><em>No default</em></span></p><p>Example: <span class="emphasis"><em><em class="parameter"><code>log file</code></em> = <code class="literal">/usr/local/samba/var/log.%m</code>
    33273344</em></span>
    3328 </p></dd></dl></div></div><div class="section" title="debuglevel"><div class="titlepage"><div><div><h3 class="title"><a name="id322734"></a>
     3345</p></dd></dl></div></div><div class="section" title="debuglevel"><div class="titlepage"><div><div><h3 class="title"><a name="id322735"></a>
    33293346
    33303347<a name="DEBUGLEVEL"></a>debuglevel
    3331 </h3></div></div></div><a class="indexterm" name="id322735"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#LOGLEVEL">log level</a>.</p></dd></dl></div></div><div class="section" title="log level (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id322764"></a>
     3348</h3></div></div></div><a class="indexterm" name="id322736"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#LOGLEVEL">log level</a>.</p></dd></dl></div></div><div class="section" title="log level (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id322766"></a>
    33323349
    33333350log level (G)
    3334 </h3></div></div></div><a class="indexterm" name="id322766"></a><a name="LOGLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3351</h3></div></div></div><a class="indexterm" name="id322767"></a><a name="LOGLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    33353352    The value of the parameter (a astring) allows the debug level (logging level) to be specified in the
    33363353    <code class="filename">smb.conf</code> file.
    … …  
    33433360</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>log level</code></em> = <code class="literal">3 passdb:5 auth:10 winbind:2</code>
    33443361</em></span>
    3345 </p></dd></dl></div></div><div class="section" title="logon drive (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id322993"></a>
     3362</p></dd></dl></div></div><div class="section" title="logon drive (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id322995"></a>
    33463363
    33473364logon drive (G)
    3348 </h3></div></div></div><a class="indexterm" name="id322994"></a><a name="LOGONDRIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3365</h3></div></div></div><a class="indexterm" name="id322996"></a><a name="LOGONDRIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    33493366        This parameter specifies the local path to which the home directory will be
    33503367        connected (see <a class="link" href="smb.conf.5.html#LOGONHOME" target="_top">logon home</a>) and is only used by NT
    … …  
    33563373</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>logon drive</code></em> = <code class="literal">h:</code>
    33573374</em></span>
    3358 </p></dd></dl></div></div><div class="section" title="logon home (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id323066"></a>
     3375</p></dd></dl></div></div><div class="section" title="logon home (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id323068"></a>
    33593376
    33603377logon home (G)
    3361 </h3></div></div></div><a class="indexterm" name="id323067"></a><a name="LOGONHOME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3378</h3></div></div></div><a class="indexterm" name="id323069"></a><a name="LOGONHOME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    33623379        This parameter specifies the home directory location when a Win95/98 or NT Workstation logs into a Samba PDC. 
    33633380        It allows you to do
    … …  
    33903407</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>logon home</code></em> = <code class="literal">\\remote_smb_server\%U</code>
    33913408</em></span>
    3392 </p></dd></dl></div></div><div class="section" title="logon path (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id323220"></a>
     3409</p></dd></dl></div></div><div class="section" title="logon path (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id323221"></a>
    33933410
    33943411logon path (G)
    3395 </h3></div></div></div><a class="indexterm" name="id323221"></a><a name="LOGONPATH"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3412</h3></div></div></div><a class="indexterm" name="id323222"></a><a name="LOGONPATH"></a><div class="variablelist"><dl><dt></dt><dd><p>
    33963413        This parameter specifies the directory where roaming profiles (Desktop, NTuser.dat, etc) are
    33973414        stored.  Contrary to previous versions of these manual pages, it has nothing to do with Win 9X roaming
    … …  
    34373454        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>logon path</code></em> = <code class="literal">\\%N\%U\profile</code>
    34383455</em></span>
    3439 </p></dd></dl></div></div><div class="section" title="logon script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id323366"></a>
     3456</p></dd></dl></div></div><div class="section" title="logon script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id323372"></a>
    34403457
    34413458logon script (G)
    3442 </h3></div></div></div><a class="indexterm" name="id323367"></a><a name="LOGONSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3459</h3></div></div></div><a class="indexterm" name="id323373"></a><a name="LOGONSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    34433460        This parameter specifies the batch file (<code class="filename">.bat</code>) or NT command file
    34443461        (<code class="filename">.cmd</code>) to be downloaded and run on a machine when a user successfully logs in.  The file
    … …  
    34713488</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>logon script</code></em> = <code class="literal">scripts\%U.bat</code>
    34723489</em></span>
    3473 </p></dd></dl></div></div><div class="section" title="lppause command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id323524"></a>
     3490</p></dd></dl></div></div><div class="section" title="log writeable files on exit (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id323529"></a>
     3491
     3492log writeable files on exit (G)
     3493</h3></div></div></div><a class="indexterm" name="id323530"></a><a name="LOGWRITEABLEFILESONEXIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3494        When the network connection between a CIFS client and Samba
     3495        dies, Samba has no option but to simply shut down the server
     3496        side of the network connection. If this happens, there is a
     3497        risk of data corruption because the Windows client did not
     3498        complete all write operations that the Windows application
     3499        requested. Setting this option to "yes" makes smbd log with
     3500        a level 0 message a list of all files that have been opened
     3501        for writing when the network connection died. Those are the
     3502        files that are potentially corrupted. It is meant as an aid
     3503        for the administrator to give him a list of files to do
     3504        consistency checks on.
     3505        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>log writeable files on exit</code></em> = <code class="literal">no</code>
     3506</em></span>
     3507</p></dd></dl></div></div><div class="section" title="lppause command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id323576"></a>
    34743508
    34753509lppause command (S)
    3476 </h3></div></div></div><a class="indexterm" name="id323525"></a><a name="LPPAUSECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     3510</h3></div></div></div><a class="indexterm" name="id323577"></a><a name="LPPAUSECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    34773511    executed on the server host in order to stop printing or spooling
    34783512    a specific print job.</p><p>This command should be a program or script which takes
    … …  
    34983532</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lppause command</code></em> = <code class="literal">/usr/bin/lpalt %p-%j -p0</code>
    34993533</em></span>
    3500 </p></dd></dl></div></div><div class="section" title="lpq cache time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id323660"></a>
     3534</p></dd></dl></div></div><div class="section" title="lpq cache time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id323712"></a>
    35013535
    35023536lpq cache time (G)
    3503 </h3></div></div></div><a class="indexterm" name="id323661"></a><a name="LPQCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls how long lpq info will be cached
     3537</h3></div></div></div><a class="indexterm" name="id323713"></a><a name="LPQCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls how long lpq info will be cached
    35043538        for to prevent the <code class="literal">lpq</code> command being called too
    35053539        often. A separate cache is kept for each variation of the <code class="literal">
    … …  
    35143548</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lpq cache time</code></em> = <code class="literal">10</code>
    35153549</em></span>
    3516 </p></dd></dl></div></div><div class="section" title="lpq command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id323771"></a>
     3550</p></dd></dl></div></div><div class="section" title="lpq command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id323823"></a>
    35173551
    35183552lpq command (S)
    3519 </h3></div></div></div><a class="indexterm" name="id323772"></a><a name="LPQCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     3553</h3></div></div></div><a class="indexterm" name="id323824"></a><a name="LPQCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    35203554    executed on the server host in order to obtain <code class="literal">lpq
    35213555    </code>-style printer status information.</p><p>This command should be a program or script which
    … …  
    35393573</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lpq command</code></em> = <code class="literal">/usr/bin/lpq -P%p</code>
    35403574</em></span>
    3541 </p></dd></dl></div></div><div class="section" title="lpresume command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id323888"></a>
     3575</p></dd></dl></div></div><div class="section" title="lpresume command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id323940"></a>
    35423576
    35433577lpresume command (S)
    3544 </h3></div></div></div><a class="indexterm" name="id323889"></a><a name="LPRESUMECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     3578</h3></div></div></div><a class="indexterm" name="id323941"></a><a name="LPRESUMECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    35453579    executed on the server host in order to restart or continue
    35463580    printing or spooling a specific print job.</p><p>This command should be a program or script which takes
    … …  
    35553589    is <code class="constant">SOFTQ</code>, then the default is:</p><p><code class="literal">qstat -s -j%j -r</code></p><p><span class="emphasis"><em>No default</em></span></p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lpresume command</code></em> = <code class="literal">/usr/bin/lpalt %p-%j -p2</code>
    35563590</em></span>
    3557 </p></dd></dl></div></div><div class="section" title="lprm command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id324032"></a>
     3591</p></dd></dl></div></div><div class="section" title="lprm command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id324083"></a>
    35583592
    35593593lprm command (S)
    3560 </h3></div></div></div><a class="indexterm" name="id324033"></a><a name="LPRMCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     3594</h3></div></div></div><a class="indexterm" name="id324084"></a><a name="LPRMCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    35613595    executed on the server host in order to delete a print job.</p><p>This command should be a program or script which takes
    35623596    a printer name and job number, and deletes the print job.</p><p>If a <em class="parameter"><code>%p</code></em> is given then the printer name
    … …  
    35753609        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>lprm command</code></em> = <code class="literal"> determined by printing parameter</code>
    35763610</em></span>
    3577 </p></dd></dl></div></div><div class="section" title="machine password timeout (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id324113"></a>
     3611</p></dd></dl></div></div><div class="section" title="machine password timeout (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id324165"></a>
    35783612
    35793613machine password timeout (G)
    3580 </h3></div></div></div><a class="indexterm" name="id324114"></a><a name="MACHINEPASSWORDTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3614</h3></div></div></div><a class="indexterm" name="id324166"></a><a name="MACHINEPASSWORDTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    35813615        If a Samba server is a member of a Windows NT Domain (see the <a class="link" href="smb.conf.5.html#SECURITY" target="_top">security = domain</a> parameter) then periodically a running smbd process will try and change
    35823616        the MACHINE ACCOUNT PASSWORD stored in the TDB called <code class="filename">private/secrets.tdb
    … …  
    35883622        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>machine password timeout</code></em> = <code class="literal">604800</code>
    35893623</em></span>
    3590 </p></dd></dl></div></div><div class="section" title="magic output (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id324197"></a>
     3624</p></dd></dl></div></div><div class="section" title="magic output (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id324249"></a>
    35913625
    35923626magic output (S)
    3593 </h3></div></div></div><a class="indexterm" name="id324198"></a><a name="MAGICOUTPUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3627</h3></div></div></div><a class="indexterm" name="id324250"></a><a name="MAGICOUTPUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    35943628        This parameter specifies the name of a file which will contain output created by a magic script (see the
    35953629        <a class="link" href="smb.conf.5.html#MAGICSCRIPT" target="_top">magic script</a> parameter below).
    … …  
    36003634</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>magic output</code></em> = <code class="literal">myfile.txt</code>
    36013635</em></span>
    3602 </p></dd></dl></div></div><div class="section" title="magic script (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id324277"></a>
     3636</p></dd></dl></div></div><div class="section" title="magic script (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id324329"></a>
    36033637
    36043638magic script (S)
    3605 </h3></div></div></div><a class="indexterm" name="id324278"></a><a name="MAGICSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the name of a file which,
     3639</h3></div></div></div><a class="indexterm" name="id324330"></a><a name="MAGICSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the name of a file which,
    36063640        if opened, will be executed by the server when the file is closed.
    36073641        This allows a UNIX script to be sent to the Samba host and
    … …  
    36193653</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>magic script</code></em> = <code class="literal">user.csh</code>
    36203654</em></span>
    3621 </p></dd></dl></div></div><div class="section" title="mangled names (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id324375"></a>
     3655</p></dd></dl></div></div><div class="section" title="mangled names (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id324427"></a>
    36223656
    36233657mangled names (S)
    3624 </h3></div></div></div><a class="indexterm" name="id324376"></a><a name="MANGLEDNAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether non-DOS names under UNIX
     3658</h3></div></div></div><a class="indexterm" name="id324428"></a><a name="MANGLEDNAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether non-DOS names under UNIX
    36253659        should be mapped to DOS-compatible names ("mangled") and made visible,
    36263660        or whether non-DOS names should simply be ignored.</p><p>See the section on <a class="link" href="smb.conf.5.html#NAMEMANGLING" target="_top">name mangling</a> for
    … …  
    36473681        do not change between sessions.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>mangled names</code></em> = <code class="literal">yes</code>
    36483682</em></span>
    3649 </p></dd></dl></div></div><div class="section" title="mangle prefix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id324494"></a>
     3683</p></dd></dl></div></div><div class="section" title="mangle prefix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id324546"></a>
    36503684
    36513685mangle prefix (G)
    3652 </h3></div></div></div><a class="indexterm" name="id324495"></a><a name="MANGLEPREFIX"></a><div class="variablelist"><dl><dt></dt><dd><p> controls the number of prefix
     3686</h3></div></div></div><a class="indexterm" name="id324547"></a><a name="MANGLEPREFIX"></a><div class="variablelist"><dl><dt></dt><dd><p> controls the number of prefix
    36533687        characters from the original name used when generating
    36543688        the mangled names. A larger value will give a weaker
    … …  
    36603694</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>mangle prefix</code></em> = <code class="literal">4</code>
    36613695</em></span>
    3662 </p></dd></dl></div></div><div class="section" title="mangling char (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id324558"></a>
     3696</p></dd></dl></div></div><div class="section" title="mangling char (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id324610"></a>
    36633697
    36643698mangling char (S)
    3665 </h3></div></div></div><a class="indexterm" name="id324559"></a><a name="MANGLINGCHAR"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what character is used as
     3699</h3></div></div></div><a class="indexterm" name="id324611"></a><a name="MANGLINGCHAR"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what character is used as
    36663700        the <span class="emphasis"><em>magic</em></span> character in <a class="link" href="smb.conf.5.html#NAMEMANGLING" target="_top">name mangling</a>. The
    36673701        default is a '~' but this may interfere with some software. Use this option to set
    … …  
    36703704</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>mangling char</code></em> = <code class="literal">^</code>
    36713705</em></span>
    3672 </p></dd></dl></div></div><div class="section" title="mangling method (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id324632"></a>
     3706</p></dd></dl></div></div><div class="section" title="mangling method (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id324684"></a>
    36733707
    36743708mangling method (G)
    3675 </h3></div></div></div><a class="indexterm" name="id324633"></a><a name="MANGLINGMETHOD"></a><div class="variablelist"><dl><dt></dt><dd><p> controls the algorithm used for the generating
     3709</h3></div></div></div><a class="indexterm" name="id324685"></a><a name="MANGLINGMETHOD"></a><div class="variablelist"><dl><dt></dt><dd><p> controls the algorithm used for the generating
    36763710        the mangled names. Can take two different values, "hash" and
    36773711        "hash2". "hash" is the algorithm that was used
    … …  
    36843718</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>mangling method</code></em> = <code class="literal">hash</code>
    36853719</em></span>
    3686 </p></dd></dl></div></div><div class="section" title="map acl inherit (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id324694"></a>
     3720</p></dd></dl></div></div><div class="section" title="map acl inherit (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id324746"></a>
    36873721
    36883722map acl inherit (S)
    3689 </h3></div></div></div><a class="indexterm" name="id324695"></a><a name="MAPACLINHERIT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will attempt to map the 'inherit' and 'protected'
     3723</h3></div></div></div><a class="indexterm" name="id324747"></a><a name="MAPACLINHERIT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will attempt to map the 'inherit' and 'protected'
    36903724    access control entry flags stored in Windows ACLs into an extended attribute
    36913725    called user.SAMBA_PAI. This parameter only takes effect if Samba is being run
    … …  
    36953729    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>map acl inherit</code></em> = <code class="literal">no</code>
    36963730</em></span>
    3697 </p></dd></dl></div></div><div class="section" title="map archive (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id324746"></a>
     3731</p></dd></dl></div></div><div class="section" title="map archive (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id324798"></a>
    36983732
    36993733map archive (S)
    3700 </h3></div></div></div><a class="indexterm" name="id324747"></a><a name="MAPARCHIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3734</h3></div></div></div><a class="indexterm" name="id324799"></a><a name="MAPARCHIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    37013735        This controls whether the DOS archive attribute
    37023736        should be mapped to the UNIX owner execute bit.  The DOS archive bit
    … …  
    37113745        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>map archive</code></em> = <code class="literal">yes</code>
    37123746</em></span>
    3713 </p></dd></dl></div></div><div class="section" title="map hidden (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id324815"></a>
     3747</p></dd></dl></div></div><div class="section" title="map hidden (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id324867"></a>
    37143748
    37153749map hidden (S)
    3716 </h3></div></div></div><a class="indexterm" name="id324816"></a><a name="MAPHIDDEN"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3750</h3></div></div></div><a class="indexterm" name="id324868"></a><a name="MAPHIDDEN"></a><div class="variablelist"><dl><dt></dt><dd><p>
    37173751        This controls whether DOS style hidden files should be mapped to the UNIX world execute bit.
    37183752        </p><p>
    … …  
    37203754        bit is not masked out (i.e. it must include 001). See the parameter <a class="link" href="smb.conf.5.html#CREATEMASK" target="_top">create mask</a>
    37213755        for details.
    3722         </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="map readonly (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id324870"></a>
     3756        </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="map readonly (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id324922"></a>
    37233757
    37243758map readonly (S)
    3725 </h3></div></div></div><a class="indexterm" name="id324871"></a><a name="MAPREADONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3759</h3></div></div></div><a class="indexterm" name="id324923"></a><a name="MAPREADONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    37263760        This controls how the DOS read only attribute should be mapped from a UNIX filesystem.
    37273761        </p><p>
    … …  
    37483782                </p></li></ul></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>map readonly</code></em> = <code class="literal">yes</code>
    37493783</em></span>
    3750 </p></dd></dl></div></div><div class="section" title="map system (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id325012"></a>
     3784</p></dd></dl></div></div><div class="section" title="map system (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id325064"></a>
    37513785
    37523786map system (S)
    3753 </h3></div></div></div><a class="indexterm" name="id325013"></a><a name="MAPSYSTEM"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3787</h3></div></div></div><a class="indexterm" name="id325065"></a><a name="MAPSYSTEM"></a><div class="variablelist"><dl><dt></dt><dd><p>
    37543788        This controls whether DOS style system files should be mapped to the UNIX group execute bit.
    37553789        </p><p>
    … …  
    37593793        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>map system</code></em> = <code class="literal">no</code>
    37603794</em></span>
    3761 </p></dd></dl></div></div><div class="section" title="map to guest (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id325078"></a>
     3795</p></dd></dl></div></div><div class="section" title="map to guest (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id325130"></a>
    37623796
    37633797map to guest (G)
    3764 </h3></div></div></div><a class="indexterm" name="id325079"></a><a name="MAPTOGUEST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only useful in <a class="link" href="smb.conf.5.html#SECURITY" target="_top">SECURITY =
     3798</h3></div></div></div><a class="indexterm" name="id325131"></a><a name="MAPTOGUEST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only useful in <a class="link" href="smb.conf.5.html#SECURITY" target="_top">SECURITY =
    37653799    security</a> modes other than <em class="parameter"><code>security = share</code></em>
    37663800    and <em class="parameter"><code>security = server</code></em>
    … …  
    38043838</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>map to guest</code></em> = <code class="literal">Bad User</code>
    38053839</em></span>
    3806 </p></dd></dl></div></div><div class="section" title="map untrusted to domain (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id325294"></a>
     3840</p></dd></dl></div></div><div class="section" title="map untrusted to domain (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id325346"></a>
    38073841
    38083842map untrusted to domain (G)
    3809 </h3></div></div></div><a class="indexterm" name="id325295"></a><a name="MAPUNTRUSTEDTODOMAIN"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3843</h3></div></div></div><a class="indexterm" name="id325347"></a><a name="MAPUNTRUSTEDTODOMAIN"></a><div class="variablelist"><dl><dt></dt><dd><p>
    38103844    If a client connects to smbd using an untrusted domain name, such as
    38113845    BOGUS\user, smbd replaces the BOGUS domain with it's SAM name before
    … …  
    38253859    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>map untrusted to domain</code></em> = <code class="literal">no</code>
    38263860</em></span>
    3827 </p></dd></dl></div></div><div class="section" title="max connections (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id325352"></a>
     3861</p></dd></dl></div></div><div class="section" title="max connections (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id325404"></a>
    38283862
    38293863max connections (S)
    3830 </h3></div></div></div><a class="indexterm" name="id325353"></a><a name="MAXCONNECTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows the number of simultaneous connections to a service to be limited.
     3864</h3></div></div></div><a class="indexterm" name="id325405"></a><a name="MAXCONNECTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows the number of simultaneous connections to a service to be limited.
    38313865    If <em class="parameter"><code>max connections</code></em> is greater than 0 then connections
    38323866    will be refused if this number of connections to the service are already open. A value
    … …  
    38363870</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max connections</code></em> = <code class="literal">10</code>
    38373871</em></span>
    3838 </p></dd></dl></div></div><div class="section" title="max disk size (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id325434"></a>
     3872</p></dd></dl></div></div><div class="section" title="max disk size (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id325486"></a>
    38393873
    38403874max disk size (G)
    3841 </h3></div></div></div><a class="indexterm" name="id325435"></a><a name="MAXDISKSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to put an upper limit
     3875</h3></div></div></div><a class="indexterm" name="id325487"></a><a name="MAXDISKSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to put an upper limit
    38423876    on the apparent size of disks. If you set this option to 100
    38433877    then all shares will appear to be not larger than 100 MB in
    … …  
    38533887</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max disk size</code></em> = <code class="literal">1000</code>
    38543888</em></span>
    3855 </p></dd></dl></div></div><div class="section" title="max log size (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id325519"></a>
     3889</p></dd></dl></div></div><div class="section" title="max log size (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id325571"></a>
    38563890
    38573891max log size (G)
    3858 </h3></div></div></div><a class="indexterm" name="id325520"></a><a name="MAXLOGSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3892</h3></div></div></div><a class="indexterm" name="id325572"></a><a name="MAXLOGSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    38593893    This option (an integer in kilobytes) specifies the max size the log file should grow to.
    38603894    Samba periodically checks the size and if it is exceeded it will rename the file, adding
    … …  
    38653899</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max log size</code></em> = <code class="literal">1000</code>
    38663900</em></span>
    3867 </p></dd></dl></div></div><div class="section" title="max mux (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id325587"></a>
     3901</p></dd></dl></div></div><div class="section" title="max mux (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id325639"></a>
    38683902
    38693903max mux (G)
    3870 </h3></div></div></div><a class="indexterm" name="id325588"></a><a name="MAXMUX"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum number of
     3904</h3></div></div></div><a class="indexterm" name="id325640"></a><a name="MAXMUX"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum number of
    38713905    outstanding simultaneous SMB operations that Samba tells the client
    38723906        it will allow. You should never need to set this parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>max mux</code></em> = <code class="literal">50</code>
    38733907</em></span>
    3874 </p></dd></dl></div></div><div class="section" title="max open files (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id325629"></a>
     3908</p></dd></dl></div></div><div class="section" title="max open files (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id325681"></a>
    38753909
    38763910max open files (G)
    3877 </h3></div></div></div><a class="indexterm" name="id325630"></a><a name="MAXOPENFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of
     3911</h3></div></div></div><a class="indexterm" name="id325682"></a><a name="MAXOPENFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of
    38783912    open files that one <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> file
    38793913    serving process may have open for a client at any one time. The
    … …  
    38863920    this parameter so you should never need to touch this parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>max open files</code></em> = <code class="literal">16404</code>
    38873921</em></span>
    3888 </p></dd></dl></div></div><div class="section" title="max print jobs (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id325686"></a>
     3922</p></dd></dl></div></div><div class="section" title="max print jobs (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id325738"></a>
    38893923
    38903924max print jobs (S)
    3891 </h3></div></div></div><a class="indexterm" name="id325687"></a><a name="MAXPRINTJOBS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of
     3925</h3></div></div></div><a class="indexterm" name="id325739"></a><a name="MAXPRINTJOBS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of
    38923926    jobs allowable in a Samba printer queue at any given moment.
    38933927    If this number is exceeded, <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will remote "Out of Space" to the client.
    … …  
    38963930</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max print jobs</code></em> = <code class="literal">5000</code>
    38973931</em></span>
    3898 </p></dd></dl></div></div><div class="section" title="protocol"><div class="titlepage"><div><div><h3 class="title"><a name="id325754"></a>
     3932</p></dd></dl></div></div><div class="section" title="protocol"><div class="titlepage"><div><div><h3 class="title"><a name="id325806"></a>
    38993933
    39003934<a name="PROTOCOL"></a>protocol
    3901 </h3></div></div></div><a class="indexterm" name="id325755"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#MAXPROTOCOL">max protocol</a>.</p></dd></dl></div></div><div class="section" title="max protocol (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id325786"></a>
     3935</h3></div></div></div><a class="indexterm" name="id325807"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#MAXPROTOCOL">max protocol</a>.</p></dd></dl></div></div><div class="section" title="max protocol (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id325838"></a>
    39023936
    39033937max protocol (G)
    3904 </h3></div></div></div><a class="indexterm" name="id325787"></a><a name="MAXPROTOCOL"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a string) is the highest
     3938</h3></div></div></div><a class="indexterm" name="id325839"></a><a name="MAXPROTOCOL"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a string) is the highest
    39053939    protocol level that will be supported by the server.</p><p>Possible values are :</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="constant">CORE</code>: Earliest version. No
    39063940            concept of user names.</p></li><li class="listitem"><p><code class="constant">COREPLUS</code>: Slight improvements on
    … …  
    39163950</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max protocol</code></em> = <code class="literal">LANMAN1</code>
    39173951</em></span>
    3918 </p></dd></dl></div></div><div class="section" title="max reported print jobs (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id325915"></a>
     3952</p></dd></dl></div></div><div class="section" title="max reported print jobs (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id325967"></a>
    39193953
    39203954max reported print jobs (S)
    3921 </h3></div></div></div><a class="indexterm" name="id325916"></a><a name="MAXREPORTEDPRINTJOBS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3955</h3></div></div></div><a class="indexterm" name="id325968"></a><a name="MAXREPORTEDPRINTJOBS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    39223956    This parameter limits the maximum number of jobs displayed in a port monitor for
    39233957    Samba printer queue at any given moment. If this number is exceeded, the excess
    … …  
    39283962</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max reported print jobs</code></em> = <code class="literal">1000</code>
    39293963</em></span>
    3930 </p></dd></dl></div></div><div class="section" title="max smbd processes (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id325974"></a>
     3964</p></dd></dl></div></div><div class="section" title="max smbd processes (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id326026"></a>
    39313965
    39323966max smbd processes (G)
    3933 </h3></div></div></div><a class="indexterm" name="id325975"></a><a name="MAXSMBDPROCESSES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> processes concurrently running on a system and is intended
     3967</h3></div></div></div><a class="indexterm" name="id326027"></a><a name="MAXSMBDPROCESSES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> processes concurrently running on a system and is intended
    39343968    as a stopgap to prevent degrading service to clients in the event that the server has insufficient
    39353969    resources to handle more than this number of connections.  Remember that under normal operating
    … …  
    39393973</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max smbd processes</code></em> = <code class="literal">1000</code>
    39403974</em></span>
    3941 </p></dd></dl></div></div><div class="section" title="max stat cache size (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id326051"></a>
     3975</p></dd></dl></div></div><div class="section" title="max stat cache size (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id326103"></a>
    39423976
    39433977max stat cache size (G)
    3944 </h3></div></div></div><a class="indexterm" name="id326052"></a><a name="MAXSTATCACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the size in memory of any
     3978</h3></div></div></div><a class="indexterm" name="id326104"></a><a name="MAXSTATCACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the size in memory of any
    39453979          <em class="parameter"><code>stat cache</code></em> being used
    39463980          to speed up case insensitive name mappings. It represents
    … …  
    39533987</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max stat cache size</code></em> = <code class="literal">100</code>
    39543988</em></span>
    3955 </p></dd></dl></div></div><div class="section" title="max ttl (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id326117"></a>
     3989</p></dd></dl></div></div><div class="section" title="max ttl (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id326169"></a>
    39563990
    39573991max ttl (G)
    3958 </h3></div></div></div><a class="indexterm" name="id326118"></a><a name="MAXTTL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option tells <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> what the default 'time to live'
     3992</h3></div></div></div><a class="indexterm" name="id326170"></a><a name="MAXTTL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option tells <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> what the default 'time to live'
    39593993    of NetBIOS names should be (in seconds) when <code class="literal">nmbd</code> is
    39603994    requesting a name using either a broadcast packet or from a WINS server. You should
    39613995        never need to change this parameter. The default is 3 days.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>max ttl</code></em> = <code class="literal">259200</code>
    39623996</em></span>
    3963 </p></dd></dl></div></div><div class="section" title="max wins ttl (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id326174"></a>
     3997</p></dd></dl></div></div><div class="section" title="max wins ttl (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id326226"></a>
    39643998
    39653999max wins ttl (G)
    3966 </h3></div></div></div><a class="indexterm" name="id326175"></a><a name="MAXWINSTTL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option tells <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when acting as a WINS server
     4000</h3></div></div></div><a class="indexterm" name="id326227"></a><a name="MAXWINSTTL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option tells <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when acting as a WINS server
    39674001        (<a class="link" href="smb.conf.5.html#WINSSUPPORT" target="_top">wins support = yes</a>) what the maximum
    39684002    'time to live' of NetBIOS names that <code class="literal">nmbd</code>
    … …  
    39704004        parameter.  The default is 6 days (518400 seconds).</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>max wins ttl</code></em> = <code class="literal">518400</code>
    39714005</em></span>
    3972 </p></dd></dl></div></div><div class="section" title="max xmit (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id326243"></a>
     4006</p></dd></dl></div></div><div class="section" title="max xmit (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id326295"></a>
    39734007
    39744008max xmit (G)
    3975 </h3></div></div></div><a class="indexterm" name="id326244"></a><a name="MAXXMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum packet size
     4009</h3></div></div></div><a class="indexterm" name="id326296"></a><a name="MAXXMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum packet size
    39764010    that will be negotiated by Samba. The default is 16644, which
    39774011    matches the behavior of Windows 2000.  A value below 2048 is likely to cause problems.
    … …  
    39814015</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max xmit</code></em> = <code class="literal">8192</code>
    39824016</em></span>
    3983 </p></dd></dl></div></div><div class="section" title="message command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id326303"></a>
     4017</p></dd></dl></div></div><div class="section" title="message command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id326354"></a>
    39844018
    39854019message command (G)
    3986 </h3></div></div></div><a class="indexterm" name="id326304"></a><a name="MESSAGECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies what command to run when the
     4020</h3></div></div></div><a class="indexterm" name="id326355"></a><a name="MESSAGECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies what command to run when the
    39874021        server receives a WinPopup style message.</p><p>This would normally be a command that would
    39884022        deliver the message somehow. How this is to be done is
    … …  
    40234057</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>message command</code></em> = <code class="literal">csh -c 'xedit %s; rm %s' &amp;</code>
    40244058</em></span>
    4025 </p></dd></dl></div></div><div class="section" title="min print space (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id326495"></a>
     4059</p></dd></dl></div></div><div class="section" title="min print space (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id326547"></a>
    40264060
    40274061min print space (S)
    4028 </h3></div></div></div><a class="indexterm" name="id326496"></a><a name="MINPRINTSPACE"></a><div class="variablelist"><dl><dt></dt><dd><p>This sets the minimum amount of free disk
     4062</h3></div></div></div><a class="indexterm" name="id326548"></a><a name="MINPRINTSPACE"></a><div class="variablelist"><dl><dt></dt><dd><p>This sets the minimum amount of free disk
    40294063    space that must be available before a user will be able to spool
    40304064    a print job. It is specified in kilobytes. The default is 0, which
    … …  
    40334067</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>min print space</code></em> = <code class="literal">2000</code>
    40344068</em></span>
    4035 </p></dd></dl></div></div><div class="section" title="min protocol (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id326554"></a>
     4069</p></dd></dl></div></div><div class="section" title="min protocol (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id326606"></a>
    40364070
    40374071min protocol (G)
    4038 </h3></div></div></div><a class="indexterm" name="id326556"></a><a name="MINPROTOCOL"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a string) is the
     4072</h3></div></div></div><a class="indexterm" name="id326607"></a><a name="MINPROTOCOL"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a string) is the
    40394073    lowest SMB protocol dialect than Samba will support.  Please refer
    40404074    to the <a class="link" href="smb.conf.5.html#MAXPROTOCOL" target="_top">max protocol</a>
    … …  
    40484082</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>min protocol</code></em> = <code class="literal">NT1</code>
    40494083</em></span>
    4050 </p></dd></dl></div></div><div class="section" title="min receivefile size (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id326647"></a>
     4084</p></dd></dl></div></div><div class="section" title="min receivefile size (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id326699"></a>
    40514085
    40524086min receivefile size (G)
    4053 </h3></div></div></div><a class="indexterm" name="id326648"></a><a name="MINRECEIVEFILESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option changes the behavior of <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when processing SMBwriteX calls. Any incoming
     4087</h3></div></div></div><a class="indexterm" name="id326700"></a><a name="MINRECEIVEFILESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option changes the behavior of <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when processing SMBwriteX calls. Any incoming
    40544088SMBwriteX call on a non-signed SMB/CIFS connection greater than this value will not be processed in the normal way but will
    40554089be passed to any underlying kernel recvfile or splice system call (if there is no such
    … …  
    40604094nonzero. The maximum value is 128k. Values greater than 128k will be silently set to 128k.</p><p>Note this option will have NO EFFECT if set on a SMB signed connection.</p><p>The default is zero, which diables this option.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>min receivefile size</code></em> = <code class="literal">0</code>
    40614095</em></span>
    4062 </p></dd></dl></div></div><div class="section" title="min wins ttl (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id326709"></a>
     4096</p></dd></dl></div></div><div class="section" title="min wins ttl (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id326761"></a>
    40634097
    40644098min wins ttl (G)
    4065 </h3></div></div></div><a class="indexterm" name="id326710"></a><a name="MINWINSTTL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option tells <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>
     4099</h3></div></div></div><a class="indexterm" name="id326762"></a><a name="MINWINSTTL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option tells <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>
    40664100    when acting as a WINS server (<a class="link" href="smb.conf.5.html#WINSSUPPORT" target="_top">wins support = yes</a>) what the minimum 'time to live'
    40674101    of NetBIOS names that <code class="literal">nmbd</code> will grant will be (in
    … …  
    40694103    is 6 hours (21600 seconds).</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>min wins ttl</code></em> = <code class="literal">21600</code>
    40704104</em></span>
    4071 </p></dd></dl></div></div><div class="section" title="msdfs proxy (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id326776"></a>
     4105</p></dd></dl></div></div><div class="section" title="msdfs proxy (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id326828"></a>
    40724106
    40734107msdfs proxy (S)
    4074 </h3></div></div></div><a class="indexterm" name="id326777"></a><a name="MSDFSPROXY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter indicates that the share is a
     4108</h3></div></div></div><a class="indexterm" name="id326829"></a><a name="MSDFSPROXY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter indicates that the share is a
    40754109        stand-in for another CIFS share whose location is specified by
    40764110        the value of the parameter. When clients attempt to connect to
    … …  
    40804114        options to find out how to set up a Dfs root share.</p><p><span class="emphasis"><em>No default</em></span></p><p>Example: <span class="emphasis"><em><em class="parameter"><code>msdfs proxy</code></em> = <code class="literal">\otherserver\someshare</code>
    40814115</em></span>
    4082 </p></dd></dl></div></div><div class="section" title="msdfs root (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id326849"></a>
     4116</p></dd></dl></div></div><div class="section" title="msdfs root (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id326901"></a>
    40834117
    40844118msdfs root (S)
    4085 </h3></div></div></div><a class="indexterm" name="id326850"></a><a name="MSDFSROOT"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to <code class="constant">yes</code>, Samba treats the
     4119</h3></div></div></div><a class="indexterm" name="id326902"></a><a name="MSDFSROOT"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to <code class="constant">yes</code>, Samba treats the
    40864120        share as a Dfs root and allows clients to browse the
    40874121        distributed file system tree rooted at the share directory.
    … …  
    40914125        Samba, refer to the MSDFS chapter in the Samba3-HOWTO book.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>msdfs root</code></em> = <code class="literal">no</code>
    40924126</em></span>
    4093 </p></dd></dl></div></div><div class="section" title="name cache timeout (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id326902"></a>
     4127</p></dd></dl></div></div><div class="section" title="multicast dns register (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id326954"></a>
     4128
     4129multicast dns register (G)
     4130</h3></div></div></div><a class="indexterm" name="id326955"></a><a name="MULTICASTDNSREGISTER"></a><div class="variablelist"><dl><dt></dt><dd><p>If compiled with proper support for it, Samba will
     4131        announce itself with multicast DNS services like for example
     4132        provided by the Avahi daemon.</p><p>This parameter allows disabling Samba to register
     4133        itself.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>multicast dns register</code></em> = <code class="literal">yes</code>
     4134</em></span>
     4135</p></dd></dl></div></div><div class="section" title="name cache timeout (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327000"></a>
    40944136
    40954137name cache timeout (G)
    4096 </h3></div></div></div><a class="indexterm" name="id326903"></a><a name="NAMECACHETIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the number of seconds it takes before
     4138</h3></div></div></div><a class="indexterm" name="id327001"></a><a name="NAMECACHETIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the number of seconds it takes before
    40974139    entries in samba's hostname resolve cache time out. If
    40984140    the timeout is set to 0. the caching is disabled.
    … …  
    41014143</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>name cache timeout</code></em> = <code class="literal">0</code>
    41024144</em></span>
    4103 </p></dd></dl></div></div><div class="section" title="name resolve order (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id326961"></a>
     4145</p></dd></dl></div></div><div class="section" title="name resolve order (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327059"></a>
    41044146
    41054147name resolve order (G)
    4106 </h3></div></div></div><a class="indexterm" name="id326962"></a><a name="NAMERESOLVEORDER"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used by the programs in the Samba
     4148</h3></div></div></div><a class="indexterm" name="id327060"></a><a name="NAMERESOLVEORDER"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used by the programs in the Samba
    41074149    suite to determine what naming services to use and in what order
    41084150    to resolve host names to IP addresses. Its main purpose to is to
    … …  
    41354177</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>name resolve order</code></em> = <code class="literal">lmhosts bcast host</code>
    41364178</em></span>
    4137 </p></dd></dl></div></div><div class="section" title="netbios aliases (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327146"></a>
     4179</p></dd></dl></div></div><div class="section" title="netbios aliases (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327241"></a>
    41384180
    41394181netbios aliases (G)
    4140 </h3></div></div></div><a class="indexterm" name="id327147"></a><a name="NETBIOSALIASES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of NetBIOS names that nmbd will
     4182</h3></div></div></div><a class="indexterm" name="id327242"></a><a name="NETBIOSALIASES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of NetBIOS names that nmbd will
    41414183        advertise as additional names by which the Samba server is known. This allows one machine
    41424184        to appear in browse lists under multiple names. If a machine is acting as a browse server
    … …  
    41484190</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>netbios aliases</code></em> = <code class="literal">TEST TEST1 TEST2</code>
    41494191</em></span>
    4150 </p></dd></dl></div></div><div class="section" title="netbios name (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327207"></a>
     4192</p></dd></dl></div></div><div class="section" title="netbios name (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327303"></a>
    41514193
    41524194netbios name (G)
    4153 </h3></div></div></div><a class="indexterm" name="id327208"></a><a name="NETBIOSNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4195</h3></div></div></div><a class="indexterm" name="id327304"></a><a name="NETBIOSNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    41544196                This sets the NetBIOS name by which a Samba server is known. By default it is the same as the first component
    41554197                of the host's DNS name. If a machine is a browse server or logon server this name (or the first component of
    … …  
    41644206</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>netbios name</code></em> = <code class="literal">MYNAME</code>
    41654207</em></span>
    4166 </p></dd></dl></div></div><div class="section" title="netbios scope (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327284"></a>
     4208</p></dd></dl></div></div><div class="section" title="netbios scope (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327379"></a>
    41674209
    41684210netbios scope (G)
    4169 </h3></div></div></div><a class="indexterm" name="id327285"></a><a name="NETBIOSSCOPE"></a><div class="variablelist"><dl><dt></dt><dd><p>This sets the NetBIOS scope that Samba will
     4211</h3></div></div></div><a class="indexterm" name="id327380"></a><a name="NETBIOSSCOPE"></a><div class="variablelist"><dl><dt></dt><dd><p>This sets the NetBIOS scope that Samba will
    41704212        operate under. This should not be set unless every machine
    41714213        on your LAN also sets this value.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>netbios scope</code></em> = <code class="literal"></code>
    41724214</em></span>
    4173 </p></dd></dl></div></div><div class="section" title="nis homedir (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327324"></a>
     4215</p></dd></dl></div></div><div class="section" title="nis homedir (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327420"></a>
    41744216
    41754217nis homedir (G)
    4176 </h3></div></div></div><a class="indexterm" name="id327326"></a><a name="NISHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>Get the home share server from a NIS map. For
     4218</h3></div></div></div><a class="indexterm" name="id327421"></a><a name="NISHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>Get the home share server from a NIS map. For
    41774219        UNIX systems that use an automounter, the user's home directory
    41784220        will often be mounted on a workstation on demand from a remote
    … …  
    41934235        be a logon server.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>nis homedir</code></em> = <code class="literal">no</code>
    41944236</em></span>
    4195 </p></dd></dl></div></div><div class="section" title="nmbd bind explicit broadcast (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327395"></a>
     4237</p></dd></dl></div></div><div class="section" title="nmbd bind explicit broadcast (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327490"></a>
    41964238
    41974239nmbd bind explicit broadcast (G)
    4198 </h3></div></div></div><a class="indexterm" name="id327396"></a><a name="NMBDBINDEXPLICITBROADCAST"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4240</h3></div></div></div><a class="indexterm" name="id327492"></a><a name="NMBDBINDEXPLICITBROADCAST"></a><div class="variablelist"><dl><dt></dt><dd><p>
    41994241        This option causes <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> to explicitly bind to the
    42004242        broadcast address of the local subnets. This is needed to make nmbd
    … …  
    42034245        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>nmbd bind explicit broadcast</code></em> = <code class="literal">yes</code>
    42044246</em></span>
    4205 </p></dd></dl></div></div><div class="section" title="nt acl support (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id327457"></a>
     4247</p></dd></dl></div></div><div class="section" title="nt acl support (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id327553"></a>
    42064248
    42074249nt acl support (S)
    4208 </h3></div></div></div><a class="indexterm" name="id327458"></a><a name="NTACLSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will attempt to map
     4250</h3></div></div></div><a class="indexterm" name="id327554"></a><a name="NTACLSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will attempt to map
    42094251    UNIX permissions into Windows NT access control lists.  The UNIX
    42104252    permissions considered are the the traditional UNIX owner and
    … …  
    42134255    releases prior to 2.2.2.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>nt acl support</code></em> = <code class="literal">yes</code>
    42144256</em></span>
    4215 </p></dd></dl></div></div><div class="section" title="ntlm auth (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327509"></a>
     4257</p></dd></dl></div></div><div class="section" title="ntlm auth (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327605"></a>
    42164258
    42174259ntlm auth (G)
    4218 </h3></div></div></div><a class="indexterm" name="id327510"></a><a name="NTLMAUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will attempt to
     4260</h3></div></div></div><a class="indexterm" name="id327606"></a><a name="NTLMAUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will attempt to
    42194261    authenticate users using the NTLM encrypted password response.
    42204262    If disabled, either the lanman password hash or an NTLMv2 response
    … …  
    42244266        special configuration to use it.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ntlm auth</code></em> = <code class="literal">yes</code>
    42254267</em></span>
    4226 </p></dd></dl></div></div><div class="section" title="nt pipe support (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327569"></a>
     4268</p></dd></dl></div></div><div class="section" title="nt pipe support (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327665"></a>
    42274269
    42284270nt pipe support (G)
    4229 </h3></div></div></div><a class="indexterm" name="id327570"></a><a name="NTPIPESUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether
     4271</h3></div></div></div><a class="indexterm" name="id327666"></a><a name="NTPIPESUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether
    42304272    <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will allow Windows NT
    42314273    clients to connect to the NT SMB specific <code class="constant">IPC$</code>
    … …  
    42334275        alone.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>nt pipe support</code></em> = <code class="literal">yes</code>
    42344276</em></span>
    4235 </p></dd></dl></div></div><div class="section" title="nt status support (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327622"></a>
     4277</p></dd></dl></div></div><div class="section" title="nt status support (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327718"></a>
    42364278
    42374279nt status support (G)
    4238 </h3></div></div></div><a class="indexterm" name="id327624"></a><a name="NTSTATUSSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will negotiate NT specific status
     4280</h3></div></div></div><a class="indexterm" name="id327719"></a><a name="NTSTATUSSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will negotiate NT specific status
    42394281    support with Windows NT/2k/XP clients. This is a developer debugging option and should be left alone.
    42404282    If this option is set to <code class="constant">no</code> then Samba offers
    … …  
    42424284    reported.</p><p>You should not need to ever disable this parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>nt status support</code></em> = <code class="literal">yes</code>
    42434285</em></span>
    4244 </p></dd></dl></div></div><div class="section" title="null passwords (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327681"></a>
     4286</p></dd></dl></div></div><div class="section" title="null passwords (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327776"></a>
    42454287
    42464288null passwords (G)
    4247 </h3></div></div></div><a class="indexterm" name="id327682"></a><a name="NULLPASSWORDS"></a><div class="variablelist"><dl><dt></dt><dd><p>Allow or disallow client access to accounts that have null passwords. </p><p>See also <a class="citerefentry" href="smbpasswd.5.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(5)</span></a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>null passwords</code></em> = <code class="literal">no</code>
    4248 </em></span>
    4249 </p></dd></dl></div></div><div class="section" title="obey pam restrictions (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327733"></a>
     4289</h3></div></div></div><a class="indexterm" name="id327777"></a><a name="NULLPASSWORDS"></a><div class="variablelist"><dl><dt></dt><dd><p>Allow or disallow client access to accounts that have null passwords. </p><p>See also <a class="citerefentry" href="smbpasswd.5.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(5)</span></a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>null passwords</code></em> = <code class="literal">no</code>
     4290</em></span>
     4291</p></dd></dl></div></div><div class="section" title="obey pam restrictions (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327828"></a>
    42504292
    42514293obey pam restrictions (G)
    4252 </h3></div></div></div><a class="indexterm" name="id327734"></a><a name="OBEYPAMRESTRICTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba 3.0 is configured to enable PAM support
     4294</h3></div></div></div><a class="indexterm" name="id327829"></a><a name="OBEYPAMRESTRICTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba 3.0 is configured to enable PAM support
    42534295    (i.e. --with-pam), this parameter will control whether or not Samba
    42544296    should obey PAM's account and session management directives.  The
    … …  
    42604302</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>obey pam restrictions</code></em> = <code class="literal">no</code>
    42614303</em></span>
    4262 </p></dd></dl></div></div><div class="section" title="only user (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id327790"></a>
     4304</p></dd></dl></div></div><div class="section" title="only user (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id327885"></a>
    42634305
    42644306only user (S)
    4265 </h3></div></div></div><a class="indexterm" name="id327791"></a><a name="ONLYUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean option that controls whether
     4307</h3></div></div></div><a class="indexterm" name="id327886"></a><a name="ONLYUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean option that controls whether
    42664308    connections with usernames not in the <em class="parameter"><code>user</code></em>
    42674309    list will be allowed. By default this option is disabled so that a
    … …  
    42764318    name of the user.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>only user</code></em> = <code class="literal">no</code>
    42774319</em></span>
    4278 </p></dd></dl></div></div><div class="section" title="oplock break wait time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327873"></a>
     4320</p></dd></dl></div></div><div class="section" title="oplock break wait time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id327968"></a>
    42794321
    42804322oplock break wait time (G)
    4281 </h3></div></div></div><a class="indexterm" name="id327874"></a><a name="OPLOCKBREAKWAITTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4323</h3></div></div></div><a class="indexterm" name="id327969"></a><a name="OPLOCKBREAKWAITTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    42824324        This is a tuning parameter added due to bugs in both Windows 9x and WinNT. If Samba responds to a client too
    42834325        quickly when that client issues an SMB that can cause an oplock break request, then the network client can
    … …  
    42884330        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>oplock break wait time</code></em> = <code class="literal">0</code>
    42894331</em></span>
    4290 </p></dd></dl></div></div><div class="section" title="oplock contention limit (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id327922"></a>
     4332</p></dd></dl></div></div><div class="section" title="oplock contention limit (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id328017"></a>
    42914333
    42924334oplock contention limit (S)
    4293 </h3></div></div></div><a class="indexterm" name="id327923"></a><a name="OPLOCKCONTENTIONLIMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4335</h3></div></div></div><a class="indexterm" name="id328018"></a><a name="OPLOCKCONTENTIONLIMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    42944336        This is a <span class="emphasis"><em>very</em></span> advanced <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> tuning option to improve the efficiency of the
    42954337        granting of oplocks under multiple client contention for the same file.
    … …  
    43034345        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>oplock contention limit</code></em> = <code class="literal">2</code>
    43044346</em></span>
    4305 </p></dd></dl></div></div><div class="section" title="oplocks (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id328000"></a>
     4347</p></dd></dl></div></div><div class="section" title="oplocks (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id328095"></a>
    43064348
    43074349oplocks (S)
    4308 </h3></div></div></div><a class="indexterm" name="id328001"></a><a name="OPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4350</h3></div></div></div><a class="indexterm" name="id328096"></a><a name="OPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    43094351        This boolean option tells <code class="literal">smbd</code> whether to
    43104352        issue oplocks (opportunistic locks) to file open requests on this
    … …  
    43234365        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>oplocks</code></em> = <code class="literal">yes</code>
    43244366</em></span>
    4325 </p></dd></dl></div></div><div class="section" title="os2 driver map (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328077"></a>
     4367</p></dd></dl></div></div><div class="section" title="os2 driver map (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328172"></a>
    43264368
    43274369os2 driver map (G)
    4328 </h3></div></div></div><a class="indexterm" name="id328078"></a><a name="OS2DRIVERMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>The parameter is used to define the absolute
     4370</h3></div></div></div><a class="indexterm" name="id328173"></a><a name="OS2DRIVERMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>The parameter is used to define the absolute
    43294371    path to a file containing a mapping of Windows NT printer driver
    43304372    names to OS/2 printer driver names.  The format is:</p><p>&lt;nt driver name&gt; = &lt;os2 driver name&gt;.&lt;device name&gt;</p><p>For example, a valid entry using the HP LaserJet 5
    … …  
    43364378    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>os2 driver map</code></em> = <code class="literal"></code>
    43374379</em></span>
    4338 </p></dd></dl></div></div><div class="section" title="os level (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328137"></a>
     4380</p></dd></dl></div></div><div class="section" title="os level (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328232"></a>
    43394381
    43404382os level (G)
    4341 </h3></div></div></div><a class="indexterm" name="id328138"></a><a name="OSLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4383</h3></div></div></div><a class="indexterm" name="id328233"></a><a name="OSLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    43424384        This integer value controls what level Samba advertises itself as for browse elections. The value of this
    43434385        parameter determines whether <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> has a chance of becoming a local master browser for the <a class="link" href="smb.conf.5.html#WORKGROUP" target="_top">workgroup</a> in the local broadcast area.
    … …  
    43554397</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>os level</code></em> = <code class="literal">65</code>
    43564398</em></span>
    4357 </p></dd></dl></div></div><div class="section" title="pam password change (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328235"></a>
     4399</p></dd></dl></div></div><div class="section" title="pam password change (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328326"></a>
    43584400
    43594401pam password change (G)
    4360 </h3></div></div></div><a class="indexterm" name="id328236"></a><a name="PAMPASSWORDCHANGE"></a><div class="variablelist"><dl><dt></dt><dd><p>With the addition of better PAM support in Samba 2.2,
     4402</h3></div></div></div><a class="indexterm" name="id328327"></a><a name="PAMPASSWORDCHANGE"></a><div class="variablelist"><dl><dt></dt><dd><p>With the addition of better PAM support in Samba 2.2,
    43614403    this parameter, it is possible to use PAM's password change control
    43624404    flag for Samba.  If enabled, then PAM will be used for password
    … …  
    43664408    <a class="link" href="smb.conf.5.html#PASSWDCHAT" target="_top">passwd chat</a> parameter for most setups.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>pam password change</code></em> = <code class="literal">no</code>
    43674409</em></span>
    4368 </p></dd></dl></div></div><div class="section" title="panic action (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328302"></a>
     4410</p></dd></dl></div></div><div class="section" title="panic action (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328393"></a>
    43694411
    43704412panic action (G)
    4371 </h3></div></div></div><a class="indexterm" name="id328303"></a><a name="PANICACTION"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a Samba developer option that allows a
     4413</h3></div></div></div><a class="indexterm" name="id328394"></a><a name="PANICACTION"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a Samba developer option that allows a
    43724414        system command to be called when either <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> or <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>      crashes. This is usually used to
    43734415        draw attention to the fact that a problem occurred.
    … …  
    43764418</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>panic action</code></em> = <code class="literal">"/bin/sleep 90000"</code>
    43774419</em></span>
    4378 </p></dd></dl></div></div><div class="section" title="paranoid server security (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328376"></a>
     4420</p></dd></dl></div></div><div class="section" title="paranoid server security (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328467"></a>
    43794421
    43804422paranoid server security (G)
    4381 </h3></div></div></div><a class="indexterm" name="id328377"></a><a name="PARANOIDSERVERSECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>Some version of NT 4.x allow non-guest
     4423</h3></div></div></div><a class="indexterm" name="id328468"></a><a name="PARANOIDSERVERSECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>Some version of NT 4.x allow non-guest
    43824424    users with a bad passowrd. When this option is enabled, samba will not
    43834425    use a broken NT 4.x server as password server, but instead complain
    … …  
    43874429    bad logon to the remote server.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>paranoid server security</code></em> = <code class="literal">yes</code>
    43884430</em></span>
    4389 </p></dd></dl></div></div><div class="section" title="passdb backend (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328424"></a>
     4431</p></dd></dl></div></div><div class="section" title="passdb backend (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328515"></a>
    43904432
    43914433passdb backend (G)
    4392 </h3></div></div></div><a class="indexterm" name="id328425"></a><a name="PASSDBBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows the administrator to chose which backend
     4434</h3></div></div></div><a class="indexterm" name="id328516"></a><a name="PASSDBBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows the administrator to chose which backend
    43934435    will be used for storing user and possibly group information.  This allows
    43944436    you to swap between different storage mechanisms without recompile. </p><p>The parameter value is divided into two parts, the backend's name, and a 'location'
    … …  
    44254467</pre><p>Default: <span class="emphasis"><em><em class="parameter"><code>passdb backend</code></em> = <code class="literal">tdbsam</code>
    44264468</em></span>
    4427 </p></dd></dl></div></div><div class="section" title="passdb expand explicit (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328568"></a>
     4469</p></dd></dl></div></div><div class="section" title="passdb expand explicit (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328658"></a>
    44284470
    44294471passdb expand explicit (G)
    4430 </h3></div></div></div><a class="indexterm" name="id328569"></a><a name="PASSDBEXPANDEXPLICIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4472</h3></div></div></div><a class="indexterm" name="id328659"></a><a name="PASSDBEXPANDEXPLICIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    44314473        This parameter controls whether Samba substitutes %-macros in the passdb fields if they are explicitly set. We
    44324474        used to expand macros here, but this turned out to be a bug because the Windows client can expand a variable
    … …  
    44344476    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>passdb expand explicit</code></em> = <code class="literal">no</code>
    44354477</em></span>
    4436 </p></dd></dl></div></div><div class="section" title="passwd chat debug (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328610"></a>
     4478</p></dd></dl></div></div><div class="section" title="passwd chat debug (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328701"></a>
    44374479
    44384480passwd chat debug (G)
    4439 </h3></div></div></div><a class="indexterm" name="id328611"></a><a name="PASSWDCHATDEBUG"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean specifies if the passwd chat script
     4481</h3></div></div></div><a class="indexterm" name="id328702"></a><a name="PASSWDCHATDEBUG"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean specifies if the passwd chat script
    44404482    parameter is run in <span class="emphasis"><em>debug</em></span> mode. In this mode the
    44414483    strings passed to and received from the passwd chat are printed
    … …  
    44504492        parameter is set. This parameter is off by default.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>passwd chat debug</code></em> = <code class="literal">no</code>
    44514493</em></span>
    4452 </p></dd></dl></div></div><div class="section" title="passwd chat timeout (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328707"></a>
     4494</p></dd></dl></div></div><div class="section" title="passwd chat timeout (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328798"></a>
    44534495
    44544496passwd chat timeout (G)
    4455 </h3></div></div></div><a class="indexterm" name="id328708"></a><a name="PASSWDCHATTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>This integer specifies the number of seconds smbd will wait for an initial
     4497</h3></div></div></div><a class="indexterm" name="id328799"></a><a name="PASSWDCHATTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>This integer specifies the number of seconds smbd will wait for an initial
    44564498    answer from a passwd chat script being run. Once the initial answer is received
    44574499    the subsequent answers must be received in one tenth of this time. The default it
    44584500    two seconds.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>passwd chat timeout</code></em> = <code class="literal">2</code>
    44594501</em></span>
    4460 </p></dd></dl></div></div><div class="section" title="passwd chat (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328750"></a>
     4502</p></dd></dl></div></div><div class="section" title="passwd chat (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328840"></a>
    44614503
    44624504passwd chat (G)
    4463 </h3></div></div></div><a class="indexterm" name="id328751"></a><a name="PASSWDCHAT"></a><div class="variablelist"><dl><dt></dt><dd><p>This string controls the <span class="emphasis"><em>"chat"</em></span>
     4505</h3></div></div></div><a class="indexterm" name="id328841"></a><a name="PASSWDCHAT"></a><div class="variablelist"><dl><dt></dt><dd><p>This string controls the <span class="emphasis"><em>"chat"</em></span>
    44644506    conversation that takes places between <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> and the local password changing
    44654507    program to change the user's password. The string describes a
    … …  
    44924534</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>passwd chat</code></em> = <code class="literal">"*Enter NEW password*" %n\n "*Reenter NEW password*" %n\n "*Password changed*"</code>
    44934535</em></span>
    4494 </p></dd></dl></div></div><div class="section" title="passwd program (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id328933"></a>
     4536</p></dd></dl></div></div><div class="section" title="passwd program (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id329024"></a>
    44954537
    44964538passwd program (G)
    4497 </h3></div></div></div><a class="indexterm" name="id328934"></a><a name="PASSWDPROGRAM"></a><div class="variablelist"><dl><dt></dt><dd><p>The name of a program that can be used to set
     4539</h3></div></div></div><a class="indexterm" name="id329025"></a><a name="PASSWDPROGRAM"></a><div class="variablelist"><dl><dt></dt><dd><p>The name of a program that can be used to set
    44984540    UNIX user passwords.  Any occurrences of <em class="parameter"><code>%u</code></em>
    44994541    will be replaced with the user name. The user name is checked for
    … …  
    45164558</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>passwd program</code></em> = <code class="literal">/bin/passwd %u</code>
    45174559</em></span>
    4518 </p></dd></dl></div></div><div class="section" title="password level (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id329059"></a>
     4560</p></dd></dl></div></div><div class="section" title="password level (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id329150"></a>
    45194561
    45204562password level (G)
    4521 </h3></div></div></div><a class="indexterm" name="id329060"></a><a name="PASSWORDLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>Some client/server combinations have difficulty
     4563</h3></div></div></div><a class="indexterm" name="id329151"></a><a name="PASSWORDLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>Some client/server combinations have difficulty
    45224564    with mixed-case passwords.  One offending client is Windows for
    45234565    Workgroups, which for some reason forces passwords to upper
    … …  
    45414583</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>password level</code></em> = <code class="literal">4</code>
    45424584</em></span>
    4543 </p></dd></dl></div></div><div class="section" title="password server (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id329182"></a>
     4585</p></dd></dl></div></div><div class="section" title="password server (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id329273"></a>
    45444586
    45454587password server (G)
    4546 </h3></div></div></div><a class="indexterm" name="id329183"></a><a name="PASSWORDSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>By specifying the name of another SMB server
     4588</h3></div></div></div><a class="indexterm" name="id329274"></a><a name="PASSWORDSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>By specifying the name of another SMB server
    45474589    or Active Directory domain controller with this option,
    45484590    and using <code class="literal">security = [ads|domain|server]</code>
    … …  
    46044646</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>password server</code></em> = <code class="literal">windc.mydomain.com:389 192.168.1.101 *</code>
    46054647</em></span>
    4606 </p></dd></dl></div></div><div class="section" title="directory"><div class="titlepage"><div><div><h3 class="title"><a name="id329447"></a>
     4648</p></dd></dl></div></div><div class="section" title="directory"><div class="titlepage"><div><div><h3 class="title"><a name="id329538"></a>
    46074649
    46084650<a name="DIRECTORY"></a>directory
    4609 </h3></div></div></div><a class="indexterm" name="id329448"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PATH">path</a>.</p></dd></dl></div></div><div class="section" title="path (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id329478"></a>
     4651</h3></div></div></div><a class="indexterm" name="id329539"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PATH">path</a>.</p></dd></dl></div></div><div class="section" title="path (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id329568"></a>
    46104652
    46114653path (S)
    4612 </h3></div></div></div><a class="indexterm" name="id329479"></a><a name="PATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a directory to which
     4654</h3></div></div></div><a class="indexterm" name="id329570"></a><a name="PATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a directory to which
    46134655        the user of the service is to be given access. In the case of
    46144656        printable services, this is where print data will spool prior to
    … …  
    46274669</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>path</code></em> = <code class="literal">/home/fred</code>
    46284670</em></span>
    4629 </p></dd></dl></div></div><div class="section" title="perfcount module (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id329575"></a>
     4671</p></dd></dl></div></div><div class="section" title="perfcount module (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id329666"></a>
    46304672
    46314673perfcount module (G)
    4632 </h3></div></div></div><a class="indexterm" name="id329576"></a><a name="PERFCOUNTMODULE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the perfcount backend to be used when monitoring SMB
     4674</h3></div></div></div><a class="indexterm" name="id329667"></a><a name="PERFCOUNTMODULE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the perfcount backend to be used when monitoring SMB
    46334675        operations.  Only one perfcount module may be used, and it must implement all of the
    46344676        apis contained in the smb_perfcount_handler structure defined in smb.h.
    4635         </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="pid directory (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id329606"></a>
     4677        </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="pid directory (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id329696"></a>
    46364678
    46374679pid directory (G)
    4638 </h3></div></div></div><a class="indexterm" name="id329607"></a><a name="PIDDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4680</h3></div></div></div><a class="indexterm" name="id329697"></a><a name="PIDDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    46394681        This option specifies the directory where pid files will be placed. 
    46404682        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>pid directory</code></em> = <code class="literal">${prefix}/var/locks</code>
    … …  
    46424684</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>pid directory</code></em> = <code class="literal">pid directory = /var/run/</code>
    46434685</em></span>
    4644 </p></dd></dl></div></div><div class="section" title="posix locking (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id329663"></a>
     4686</p></dd></dl></div></div><div class="section" title="posix locking (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id329754"></a>
    46454687
    46464688posix locking (S)
    4647 </h3></div></div></div><a class="indexterm" name="id329664"></a><a name="POSIXLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4689</h3></div></div></div><a class="indexterm" name="id329755"></a><a name="POSIXLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
    46484690        The <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>
    46494691        daemon maintains an database of file locks obtained by SMB clients. The default behavior is
    46504692        to map this internal database to POSIX locks. This means that file locks obtained by SMB clients are
    46514693        consistent with those seen by POSIX compliant applications accessing the files via a non-SMB
    4652         method (e.g. NFS or local file access). You should never need to disable this parameter.
     4694        method (e.g. NFS or local file access). It is very unlikely that you need to set this parameter
     4695        to "no", unless you are sharing from an NFS mount, which is not a good idea in the first place.
    46534696        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>posix locking</code></em> = <code class="literal">yes</code>
    46544697</em></span>
    4655 </p></dd></dl></div></div><div class="section" title="postexec (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id329715"></a>
     4698</p></dd></dl></div></div><div class="section" title="postexec (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id329806"></a>
    46564699
    46574700postexec (S)
    4658 </h3></div></div></div><a class="indexterm" name="id329716"></a><a name="POSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run
     4701</h3></div></div></div><a class="indexterm" name="id329807"></a><a name="POSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run
    46594702        whenever the service is disconnected. It takes the usual
    46604703        substitutions. The command may be run as the root on some
    … …  
    46644707</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>postexec</code></em> = <code class="literal">echo \"%u disconnected from %S from %m (%I)\" &gt;&gt; /tmp/log</code>
    46654708</em></span>
    4666 </p></dd></dl></div></div><div class="section" title="preexec close (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id329784"></a>
     4709</p></dd></dl></div></div><div class="section" title="preexec close (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id329876"></a>
    46674710
    46684711preexec close (S)
    4669 </h3></div></div></div><a class="indexterm" name="id329785"></a><a name="PREEXECCLOSE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4712</h3></div></div></div><a class="indexterm" name="id329877"></a><a name="PREEXECCLOSE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    46704713        This boolean option controls whether a non-zero return code from <a class="link" href="smb.conf.5.html#PREEXEC" target="_top">preexec</a>
    46714714        should close the service being connected to.
    46724715        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preexec close</code></em> = <code class="literal">no</code>
    46734716</em></span>
    4674 </p></dd></dl></div></div><div class="section" title="exec"><div class="titlepage"><div><div><h3 class="title"><a name="id329837"></a>
     4717</p></dd></dl></div></div><div class="section" title="exec"><div class="titlepage"><div><div><h3 class="title"><a name="id329929"></a>
    46754718
    46764719<a name="EXEC"></a>exec
    4677 </h3></div></div></div><a class="indexterm" name="id329838"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PREEXEC">preexec</a>.</p></dd></dl></div></div><div class="section" title="preexec (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id329868"></a>
     4720</h3></div></div></div><a class="indexterm" name="id329930"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PREEXEC">preexec</a>.</p></dd></dl></div></div><div class="section" title="preexec (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id329960"></a>
    46784721
    46794722preexec (S)
    4680 </h3></div></div></div><a class="indexterm" name="id329869"></a><a name="PREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run whenever
     4723</h3></div></div></div><a class="indexterm" name="id329961"></a><a name="PREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run whenever
    46814724        the service is connected to. It takes the usual substitutions.</p><p>An interesting example is to send the users a welcome
    46824725        message every time they log in. Maybe a message of the day? Here
    … …  
    46904733</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>preexec</code></em> = <code class="literal">echo \"%u connected to %S from %m (%I)\" &gt;&gt; /tmp/log</code>
    46914734</em></span>
    4692 </p></dd></dl></div></div><div class="section" title="prefered master"><div class="titlepage"><div><div><h3 class="title"><a name="id329970"></a>
     4735</p></dd></dl></div></div><div class="section" title="prefered master"><div class="titlepage"><div><div><h3 class="title"><a name="id330061"></a>
    46934736
    46944737<a name="PREFEREDMASTER"></a>prefered master
    4695 </h3></div></div></div><a class="indexterm" name="id329971"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PREFERREDMASTER">preferred master</a>.</p></dd></dl></div></div><div class="section" title="preferred master (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id330002"></a>
     4738</h3></div></div></div><a class="indexterm" name="id330062"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PREFERREDMASTER">preferred master</a>.</p></dd></dl></div></div><div class="section" title="preferred master (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id330093"></a>
    46964739
    46974740preferred master (G)
    4698 </h3></div></div></div><a class="indexterm" name="id330003"></a><a name="PREFERREDMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4741</h3></div></div></div><a class="indexterm" name="id330094"></a><a name="PREFERREDMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    46994742        This boolean parameter controls if <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> is a preferred master browser  for its workgroup.
    47004743        </p><p>
    … …  
    47104753        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preferred master</code></em> = <code class="literal">auto</code>
    47114754</em></span>
    4712 </p></dd></dl></div></div><div class="section" title="preload modules (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id330088"></a>
     4755</p></dd></dl></div></div><div class="section" title="preload modules (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id330180"></a>
    47134756
    47144757preload modules (G)
    4715 </h3></div></div></div><a class="indexterm" name="id330089"></a><a name="PRELOADMODULES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of paths to modules that should
     4758</h3></div></div></div><a class="indexterm" name="id330181"></a><a name="PRELOADMODULES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of paths to modules that should
    47164759        be loaded into smbd before a client connects. This improves
    47174760        the speed of smbd when reacting to new connections somewhat. </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preload modules</code></em> = <code class="literal"></code>
    … …  
    47194762</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>preload modules</code></em> = <code class="literal">/usr/lib/samba/passdb/mysql.so</code>
    47204763</em></span>
    4721 </p></dd></dl></div></div><div class="section" title="auto services"><div class="titlepage"><div><div><h3 class="title"><a name="id330146"></a>
     4764</p></dd></dl></div></div><div class="section" title="auto services"><div class="titlepage"><div><div><h3 class="title"><a name="id330238"></a>
    47224765
    47234766<a name="AUTOSERVICES"></a>auto services
    4724 </h3></div></div></div><a class="indexterm" name="id330148"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PRELOAD">preload</a>.</p></dd></dl></div></div><div class="section" title="preload (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id330178"></a>
     4767</h3></div></div></div><a class="indexterm" name="id330239"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PRELOAD">preload</a>.</p></dd></dl></div></div><div class="section" title="preload (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id330270"></a>
    47254768
    47264769preload (G)
    4727 </h3></div></div></div><a class="indexterm" name="id330179"></a><a name="PRELOAD"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of services that you want to be
     4770</h3></div></div></div><a class="indexterm" name="id330271"></a><a name="PRELOAD"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of services that you want to be
    47284771        automatically added to the browse lists. This is most useful
    47294772        for homes and printers services that would otherwise not be
    … …  
    47364779</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>preload</code></em> = <code class="literal">fred lp colorlp</code>
    47374780</em></span>
    4738 </p></dd></dl></div></div><div class="section" title="preserve case (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id330252"></a>
     4781</p></dd></dl></div></div><div class="section" title="preserve case (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id330343"></a>
    47394782
    47404783preserve case (S)
    4741 </h3></div></div></div><a class="indexterm" name="id330253"></a><a name="PRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4784</h3></div></div></div><a class="indexterm" name="id330344"></a><a name="PRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    47424785        This controls if new filenames are created with the case that the client passes, or if
    47434786        they are forced to be the <a class="link" href="smb.conf.5.html#DEFAULTCASE" target="_top">default case</a>.
    … …  
    47464789        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preserve case</code></em> = <code class="literal">yes</code>
    47474790</em></span>
    4748 </p></dd></dl></div></div><div class="section" title="print ok"><div class="titlepage"><div><div><h3 class="title"><a name="id330315"></a>
     4791</p></dd></dl></div></div><div class="section" title="print ok"><div class="titlepage"><div><div><h3 class="title"><a name="id330407"></a>
    47494792
    47504793<a name="PRINTOK"></a>print ok
    4751 </h3></div></div></div><a class="indexterm" name="id330316"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PRINTABLE">printable</a>.</p></dd></dl></div></div><div class="section" title="printable (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id330347"></a>
     4794</h3></div></div></div><a class="indexterm" name="id330408"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PRINTABLE">printable</a>.</p></dd></dl></div></div><div class="section" title="printable (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id330438"></a>
    47524795
    47534796printable (S)
    4754 </h3></div></div></div><a class="indexterm" name="id330348"></a><a name="PRINTABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code>, then
     4797</h3></div></div></div><a class="indexterm" name="id330439"></a><a name="PRINTABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code>, then
    47554798    clients may open, write to and submit spool files on the directory
    47564799    specified for the service. </p><p>Note that a printable service will ALWAYS allow writing
    … …  
    47594802    the resource.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>printable</code></em> = <code class="literal">no</code>
    47604803</em></span>
    4761 </p></dd></dl></div></div><div class="section" title="printcap cache time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id330407"></a>
     4804</p></dd></dl></div></div><div class="section" title="printcap cache time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id330499"></a>
    47624805
    47634806printcap cache time (G)
    4764 </h3></div></div></div><a class="indexterm" name="id330408"></a><a name="PRINTCAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the number of seconds before the printing
    4765     subsystem is again asked for the known printers.  If the value
    4766     is greater than 60 the initial waiting time is set to 60 seconds
    4767     to allow an earlier first rescan of the printing subsystem.
     4807</h3></div></div></div><a class="indexterm" name="id330500"></a><a name="PRINTCAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the number of seconds before the printing
     4808    subsystem is again asked for the known printers.
    47684809    </p><p>Setting this parameter to 0 disables any rescanning for new
    47694810    or removed printers after the initial startup.
    … …  
    47724813</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printcap cache time</code></em> = <code class="literal">600</code>
    47734814</em></span>
    4774 </p></dd></dl></div></div><div class="section" title="printcap"><div class="titlepage"><div><div><h3 class="title"><a name="id330472"></a>
     4815</p></dd></dl></div></div><div class="section" title="printcap"><div class="titlepage"><div><div><h3 class="title"><a name="id330562"></a>
    47754816
    47764817<a name="PRINTCAP"></a>printcap
    4777 </h3></div></div></div><a class="indexterm" name="id330473"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PRINTCAPNAME">printcap name</a>.</p></dd></dl></div></div><div class="section" title="printcap name (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id330504"></a>
     4818</h3></div></div></div><a class="indexterm" name="id330563"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PRINTCAPNAME">printcap name</a>.</p></dd></dl></div></div><div class="section" title="printcap name (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id330594"></a>
    47784819
    47794820printcap name (G)
    4780 </h3></div></div></div><a class="indexterm" name="id330505"></a><a name="PRINTCAPNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4821</h3></div></div></div><a class="indexterm" name="id330595"></a><a name="PRINTCAPNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    47814822        This parameter may be used to override the compiled-in default printcap name used by the server (usually
    47824823        <code class="filename"> /etc/printcap</code>). See the discussion of the <a class="link" href="#PRINTERSSECT" title="The [printers] section">[printers]</a> section above for reasons why you might want to do this.
    … …  
    48134854</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printcap name</code></em> = <code class="literal">/etc/myprintcap</code>
    48144855</em></span>
    4815 </p></dd></dl></div></div><div class="section" title="print command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id330675"></a>
     4856</p></dd></dl></div></div><div class="section" title="print command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id330766"></a>
    48164857
    48174858print command (S)
    4818 </h3></div></div></div><a class="indexterm" name="id330676"></a><a name="PRINTCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>After a print job has finished spooling to
     4859</h3></div></div></div><a class="indexterm" name="id330767"></a><a name="PRINTCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>After a print job has finished spooling to
    48194860    a service, this command will be used via a <code class="literal">system()</code>
    48204861    call to process the spool file. Typically the command specified will
    … …  
    48584899        set print command will be ignored.</p><p><span class="emphasis"><em>No default</em></span></p><p>Example: <span class="emphasis"><em><em class="parameter"><code>print command</code></em> = <code class="literal">/usr/local/samba/bin/myprintscript %p %s</code>
    48594900</em></span>
    4860 </p></dd></dl></div></div><div class="section" title="printer admin (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id330918"></a>
     4901</p></dd></dl></div></div><div class="section" title="printer admin (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id331008"></a>
    48614902
    48624903printer admin (S)
    4863 </h3></div></div></div><a class="indexterm" name="id330919"></a><a name="PRINTERADMIN"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4904</h3></div></div></div><a class="indexterm" name="id331010"></a><a name="PRINTERADMIN"></a><div class="variablelist"><dl><dt></dt><dd><p>
    48644905        This lists users who can do anything to printers
    48654906        via the remote administration interfaces offered
    … …  
    48774918</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printer admin</code></em> = <code class="literal">admin, @staff</code>
    48784919</em></span>
    4879 </p></dd></dl></div></div><div class="section" title="printer"><div class="titlepage"><div><div><h3 class="title"><a name="id330982"></a>
     4920</p></dd></dl></div></div><div class="section" title="printer"><div class="titlepage"><div><div><h3 class="title"><a name="id331072"></a>
    48804921
    48814922<a name="PRINTER"></a>printer
    4882 </h3></div></div></div><a class="indexterm" name="id330983"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PRINTERNAME">printer name</a>.</p></dd></dl></div></div><div class="section" title="printer name (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id331012"></a>
     4923</h3></div></div></div><a class="indexterm" name="id331073"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PRINTERNAME">printer name</a>.</p></dd></dl></div></div><div class="section" title="printer name (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id331103"></a>
    48834924
    48844925printer name (S)
    4885 </h3></div></div></div><a class="indexterm" name="id331014"></a><a name="PRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4926</h3></div></div></div><a class="indexterm" name="id331104"></a><a name="PRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    48864927        This parameter specifies the name of the printer to which print jobs spooled through a printable service
    48874928        will be sent.
    … …  
    48964937</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printer name</code></em> = <code class="literal">laserwriter</code>
    48974938</em></span>
    4898 </p></dd></dl></div></div><div class="section" title="printing (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id331096"></a>
     4939</p></dd></dl></div></div><div class="section" title="printing (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id331187"></a>
    48994940
    49004941printing (S)
    4901 </h3></div></div></div><a class="indexterm" name="id331097"></a><a name="PRINTING"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters controls how printer status  information is
     4942</h3></div></div></div><a class="indexterm" name="id331188"></a><a name="PRINTING"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters controls how printer status  information is
    49024943    interpreted on your system. It also affects the  default values for
    49034944    the <em class="parameter"><code>print command</code></em>,  <em class="parameter"><code>lpq command</code></em>, <em class="parameter"><code>lppause command </code></em>, <em class="parameter"><code>lpresume command</code></em>, and  <em class="parameter"><code>lprm command</code></em> if specified in the
    … …  
    49164957<code class="literal">testparm -v.</code></code>
    49174958</em></span>
    4918 </p></dd></dl></div></div><div class="section" title="printjob username (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id331242"></a>
     4959</p></dd></dl></div></div><div class="section" title="printjob username (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id331333"></a>
    49194960
    49204961printjob username (S)
    4921 </h3></div></div></div><a class="indexterm" name="id331243"></a><a name="PRINTJOBUSERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies which user information will be
     4962</h3></div></div></div><a class="indexterm" name="id331334"></a><a name="PRINTJOBUSERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies which user information will be
    49224963    passed to the printing system. Usually, the username is sent,
    49234964    but in some cases, e.g. the domain prefix is useful, too.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>printjob username</code></em> = <code class="literal">%U</code>
    … …  
    49254966</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printjob username</code></em> = <code class="literal">%D\%U</code>
    49264967</em></span>
    4927 </p></dd></dl></div></div><div class="section" title="private dir (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id331301"></a>
     4968</p></dd></dl></div></div><div class="section" title="print notify backchannel (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id331392"></a>
     4969
     4970print notify backchannel (S)
     4971</h3></div></div></div><a class="indexterm" name="id331393"></a><a name="PRINTNOTIFYBACKCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>Windows print clients can update print queue status by expecting
     4972        the server to open a backchannel SMB connection to them. Due to
     4973        client firewall settings this can cause considerable timeouts
     4974        and will often fail, as there is no guarantee the client is even
     4975        running an SMB server. By setting this parameter to <code class="constant">no</code>
     4976        the Samba print server will not try to connect back to clients
     4977        and treat corresponding requests as if the connection back to
     4978        the client failed. The default setting of <code class="constant">yes</code>
     4979        causes smbd to attempt this connection.
     4980</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>print notify backchannel</code></em> = <code class="literal">yes</code>
     4981</em></span>
     4982</p></dd></dl></div></div><div class="section" title="private dir (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id331444"></a>
    49284983
    49294984private dir (G)
    4930 </h3></div></div></div><a class="indexterm" name="id331302"></a><a name="PRIVATEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters defines the directory
     4985</h3></div></div></div><a class="indexterm" name="id331445"></a><a name="PRIVATEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters defines the directory
    49314986    smbd will use for storing such files as <code class="filename">smbpasswd</code>
    49324987    and <code class="filename">secrets.tdb</code>.
    49334988</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>private dir</code></em> = <code class="literal">${prefix}/private</code>
    49344989</em></span>
    4935 </p></dd></dl></div></div><div class="section" title="profile acls (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id331354"></a>
     4990</p></dd></dl></div></div><div class="section" title="profile acls (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id331497"></a>
    49364991
    49374992profile acls (S)
    4938 </h3></div></div></div><a class="indexterm" name="id331355"></a><a name="PROFILEACLS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4993</h3></div></div></div><a class="indexterm" name="id331498"></a><a name="PROFILEACLS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    49394994        This boolean parameter was added to fix the problems that people have been
    49404995        having with storing user profiles on Samba shares from Windows 2000 or
    … …  
    49645019        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>profile acls</code></em> = <code class="literal">no</code>
    49655020</em></span>
    4966 </p></dd></dl></div></div><div class="section" title="queuepause command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id331414"></a>
     5021</p></dd></dl></div></div><div class="section" title="queuepause command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id331557"></a>
    49675022
    49685023queuepause command (S)
    4969 </h3></div></div></div><a class="indexterm" name="id331415"></a><a name="QUEUEPAUSECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     5024</h3></div></div></div><a class="indexterm" name="id331558"></a><a name="QUEUEPAUSECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    49705025    executed on the server host in order to pause the printer queue.</p><p>This command should be a program or script which takes
    49715026    a printer name as its only parameter and stops the printer queue,
    … …  
    49785033        server.</p><p><span class="emphasis"><em>No default</em></span></p><p>Example: <span class="emphasis"><em><em class="parameter"><code>queuepause command</code></em> = <code class="literal">disable %p</code>
    49795034</em></span>
    4980 </p></dd></dl></div></div><div class="section" title="queueresume command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id331485"></a>
     5035</p></dd></dl></div></div><div class="section" title="queueresume command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id331628"></a>
    49815036
    49825037queueresume command (S)
    4983 </h3></div></div></div><a class="indexterm" name="id331486"></a><a name="QUEUERESUMECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     5038</h3></div></div></div><a class="indexterm" name="id331629"></a><a name="QUEUERESUMECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    49845039    executed on the server host in order to resume the printer queue. It
    49855040    is the command to undo the behavior that is caused by the
    … …  
    49965051</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>queueresume command</code></em> = <code class="literal">enable %p</code>
    49975052</em></span>
    4998 </p></dd></dl></div></div><div class="section" title="read list (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id331579"></a>
     5053</p></dd></dl></div></div><div class="section" title="read list (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id331722"></a>
    49995054
    50005055read list (S)
    5001 </h3></div></div></div><a class="indexterm" name="id331580"></a><a name="READLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5056</h3></div></div></div><a class="indexterm" name="id331723"></a><a name="READLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
    50025057        This is a list of users that are given read-only access to a service. If the connecting user is in this list
    50035058        then they will not be given write access, no matter what the <a class="link" href="smb.conf.5.html#READONLY" target="_top">read only</a> option is set
    … …  
    50095064</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>read list</code></em> = <code class="literal">mary, @students</code>
    50105065</em></span>
    5011 </p></dd></dl></div></div><div class="section" title="read only (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id331673"></a>
     5066</p></dd></dl></div></div><div class="section" title="read only (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id331816"></a>
    50125067
    50135068read only (S)
    5014 </h3></div></div></div><a class="indexterm" name="id331674"></a><a name="READONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>An inverted synonym is <a class="link" href="smb.conf.5.html#WRITEABLE" target="_top">writeable</a>.</p><p>If this parameter is <code class="constant">yes</code>, then users
     5069</h3></div></div></div><a class="indexterm" name="id331817"></a><a name="READONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>An inverted synonym is <a class="link" href="smb.conf.5.html#WRITEABLE" target="_top">writeable</a>.</p><p>If this parameter is <code class="constant">yes</code>, then users
    50155070    of a service may not create or modify files in the service's
    50165071    directory.</p><p>Note that a printable service (<code class="literal">printable = yes</code>)
    … …  
    50185073    (user privileges permitting), but only via spooling operations.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>read only</code></em> = <code class="literal">yes</code>
    50195074</em></span>
    5020 </p></dd></dl></div></div><div class="section" title="read raw (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id331746"></a>
     5075</p></dd></dl></div></div><div class="section" title="read raw (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id331888"></a>
    50215076
    50225077read raw (G)
    5023 </h3></div></div></div><a class="indexterm" name="id331747"></a><a name="READRAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
     5078</h3></div></div></div><a class="indexterm" name="id331890"></a><a name="READRAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
    50245079    will support the raw read SMB requests when transferring data
    50255080    to clients.</p><p>If enabled, raw reads allow reads of 65535 bytes in
    … …  
    50305085        tool and left severely alone.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>read raw</code></em> = <code class="literal">yes</code>
    50315086</em></span>
    5032 </p></dd></dl></div></div><div class="section" title="realm (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id331801"></a>
     5087</p></dd></dl></div></div><div class="section" title="realm (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id331944"></a>
    50335088
    50345089realm (G)
    5035 </h3></div></div></div><a class="indexterm" name="id331802"></a><a name="REALM"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the kerberos realm to use. The realm is
     5090</h3></div></div></div><a class="indexterm" name="id331945"></a><a name="REALM"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the kerberos realm to use. The realm is
    50365091        used as the ADS equivalent of the NT4 <code class="literal">domain</code>. It
    50375092        is usually set to the DNS name of the kerberos server.
    … …  
    50405095</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>realm</code></em> = <code class="literal">mysambabox.mycompany.com</code>
    50415096</em></span>
    5042 </p></dd></dl></div></div><div class="section" title="registry shares (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id331864"></a>
     5097</p></dd></dl></div></div><div class="section" title="registry shares (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id332006"></a>
    50435098
    50445099registry shares (G)
    5045 </h3></div></div></div><a class="indexterm" name="id331865"></a><a name="REGISTRYSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5100</h3></div></div></div><a class="indexterm" name="id332007"></a><a name="REGISTRYSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    50465101        This turns on or off support for share definitions read from
    50475102        registry. Shares defined in <span class="emphasis"><em>smb.conf</em></span> take
    … …  
    50585113</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>registry shares</code></em> = <code class="literal">yes</code>
    50595114</em></span>
    5060 </p></dd></dl></div></div><div class="section" title="remote announce (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id331947"></a>
     5115</p></dd></dl></div></div><div class="section" title="remote announce (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id332089"></a>
    50615116
    50625117remote announce (G)
    5063 </h3></div></div></div><a class="indexterm" name="id331948"></a><a name="REMOTEANNOUNCE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5118</h3></div></div></div><a class="indexterm" name="id332090"></a><a name="REMOTEANNOUNCE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    50645119        This option allows you to setup <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> to periodically announce itself
    50655120        to arbitrary IP addresses with an arbitrary workgroup name.
    … …  
    50855140        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>remote announce</code></em> = <code class="literal"></code>
    50865141</em></span>
    5087 </p></dd></dl></div></div><div class="section" title="remote browse sync (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id332043"></a>
     5142</p></dd></dl></div></div><div class="section" title="remote browse sync (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id332186"></a>
    50885143
    50895144remote browse sync (G)
    5090 </h3></div></div></div><a class="indexterm" name="id332044"></a><a name="REMOTEBROWSESYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5145</h3></div></div></div><a class="indexterm" name="id332187"></a><a name="REMOTEBROWSESYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    50915146        This option allows you to setup <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> to periodically request
    50925147        synchronization of browse lists with the master browser of a Samba
    … …  
    51205175        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>remote browse sync</code></em> = <code class="literal"></code>
    51215176</em></span>
    5122 </p></dd></dl></div></div><div class="section" title="rename user script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id332143"></a>
     5177</p></dd></dl></div></div><div class="section" title="rename user script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id332290"></a>
    51235178
    51245179rename user script (G)
    5125 </h3></div></div></div><a class="indexterm" name="id332144"></a><a name="RENAMEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5180</h3></div></div></div><a class="indexterm" name="id332291"></a><a name="RENAMEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    51265181        This is the full pathname to a script that will be run as root by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> under special circumstances described below.
    51275182        </p><p>
    … …  
    51415196        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>rename user script</code></em> = <code class="literal">no</code>
    51425197</em></span>
    5143 </p></dd></dl></div></div><div class="section" title="reset on zero vc (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id332222"></a>
     5198</p></dd></dl></div></div><div class="section" title="reset on zero vc (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id332369"></a>
    51445199
    51455200reset on zero vc (G)
    5146 </h3></div></div></div><a class="indexterm" name="id332224"></a><a name="RESETONZEROVC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5201</h3></div></div></div><a class="indexterm" name="id332370"></a><a name="RESETONZEROVC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    51475202        This boolean option controls whether an incoming session setup
    51485203        should kill other connections coming from the same IP. This matches
    … …  
    51635218        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>reset on zero vc</code></em> = <code class="literal">no</code>
    51645219</em></span>
    5165 </p></dd></dl></div></div><div class="section" title="restrict anonymous (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id332269"></a>
     5220</p></dd></dl></div></div><div class="section" title="restrict anonymous (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id332415"></a>
    51665221
    51675222restrict anonymous (G)
    5168 </h3></div></div></div><a class="indexterm" name="id332270"></a><a name="RESTRICTANONYMOUS"></a><div class="variablelist"><dl><dt></dt><dd><p>The setting of this parameter determines whether user and
     5223</h3></div></div></div><a class="indexterm" name="id332416"></a><a name="RESTRICTANONYMOUS"></a><div class="variablelist"><dl><dt></dt><dd><p>The setting of this parameter determines whether user and
    51695224    group list information is returned for an anonymous connection.
    51705225    and mirrors the effects of the
    … …  
    51895244        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>restrict anonymous</code></em> = <code class="literal">0</code>
    51905245</em></span>
    5191 </p></dd></dl></div></div><div class="section" title="root"><div class="titlepage"><div><div><h3 class="title"><a name="id332342"></a>
     5246</p></dd></dl></div></div><div class="section" title="root"><div class="titlepage"><div><div><h3 class="title"><a name="id332488"></a>
    51925247
    51935248<a name="ROOT"></a>root
    5194 </h3></div></div></div><a class="indexterm" name="id332343"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#ROOTDIRECTORY">root directory</a>.</p></dd></dl></div></div><div class="section" title="root dir"><div class="titlepage"><div><div><h3 class="title"><a name="id332375"></a>
     5249</h3></div></div></div><a class="indexterm" name="id332490"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#ROOTDIRECTORY">root directory</a>.</p></dd></dl></div></div><div class="section" title="root dir"><div class="titlepage"><div><div><h3 class="title"><a name="id332521"></a>
    51955250
    51965251<a name="ROOTDIR"></a>root dir
    5197 </h3></div></div></div><a class="indexterm" name="id332376"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#ROOTDIRECTORY">root directory</a>.</p></dd></dl></div></div><div class="section" title="root directory (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id332405"></a>
     5252</h3></div></div></div><a class="indexterm" name="id332522"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#ROOTDIRECTORY">root directory</a>.</p></dd></dl></div></div><div class="section" title="root directory (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id332552"></a>
    51985253
    51995254root directory (G)
    5200 </h3></div></div></div><a class="indexterm" name="id332406"></a><a name="ROOTDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>The server will <code class="literal">chroot()</code> (i.e.
     5255</h3></div></div></div><a class="indexterm" name="id332553"></a><a name="ROOTDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>The server will <code class="literal">chroot()</code> (i.e.
    52015256    Change its root directory) to this directory on startup. This is
    52025257    not strictly necessary for secure operation. Even without it the
    … …  
    52215276</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>root directory</code></em> = <code class="literal">/homes/smb</code>
    52225277</em></span>
    5223 </p></dd></dl></div></div><div class="section" title="root postexec (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id332518"></a>
     5278</p></dd></dl></div></div><div class="section" title="root postexec (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id332664"></a>
    52245279
    52255280root postexec (S)
    5226 </h3></div></div></div><a class="indexterm" name="id332519"></a><a name="ROOTPOSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5281</h3></div></div></div><a class="indexterm" name="id332665"></a><a name="ROOTPOSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    52275282        This is the same as the <em class="parameter"><code>postexec</code></em>
    52285283        parameter except that the command is run as root. This is useful for
    … …  
    52305285        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>root postexec</code></em> = <code class="literal"></code>
    52315286</em></span>
    5232 </p></dd></dl></div></div><div class="section" title="root preexec close (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id332565"></a>
     5287</p></dd></dl></div></div><div class="section" title="root preexec close (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id332711"></a>
    52335288
    52345289root preexec close (S)
    5235 </h3></div></div></div><a class="indexterm" name="id332566"></a><a name="ROOTPREEXECCLOSE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the same as the <em class="parameter"><code>preexec close
     5290</h3></div></div></div><a class="indexterm" name="id332712"></a><a name="ROOTPREEXECCLOSE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the same as the <em class="parameter"><code>preexec close
    52365291        </code></em> parameter except that the command is run as root.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>root preexec close</code></em> = <code class="literal">no</code>
    52375292</em></span>
    5238 </p></dd></dl></div></div><div class="section" title="root preexec (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id332612"></a>
     5293</p></dd></dl></div></div><div class="section" title="root preexec (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id332758"></a>
    52395294
    52405295root preexec (S)
    5241 </h3></div></div></div><a class="indexterm" name="id332613"></a><a name="ROOTPREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5296</h3></div></div></div><a class="indexterm" name="id332760"></a><a name="ROOTPREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    52425297        This is the same as the <em class="parameter"><code>preexec</code></em>
    52435298        parameter except that the command is run as root. This is useful for
    … …  
    52455300        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>root preexec</code></em> = <code class="literal"></code>
    52465301</em></span>
    5247 </p></dd></dl></div></div><div class="section" title="security mask (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id332659"></a>
     5302</p></dd></dl></div></div><div class="section" title="rpc_server (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id332806"></a>
     5303
     5304rpc_server (G)
     5305</h3></div></div></div><a class="indexterm" name="id332807"></a><a name="RPC_SERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5306        Defines what kind of rpc server to use for a named pipe.
     5307        The rpc_server prefix must be followed by the pipe name, and a value.
     5308        </p><p>
     5309        Three possible values are currently supported:
     5310                <code class="literal">embedded</code>
     5311                <code class="literal">daemon</code>
     5312                <code class="literal">external</code>
     5313        </p><p>
     5314        The classic method is to run every pipe as an internal function
     5315        <span class="emphasis"><em>embedded</em></span> in smbd.
     5316        </p><p>
     5317        An alternative method is to fork a <span class="emphasis"><em>daemon</em></span>
     5318        early on at smbd startup time. This is supported only for selected
     5319        pipes.
     5320        </p><p>
     5321        Choosing the <span class="emphasis"><em>external</em></span> option allows to run a
     5322        completely independent (3rd party) server capable of interfacing
     5323        with samba via the MS-RPC interface over named pipes.
     5324        </p><p>
     5325        Currently only the spoolss pipe can be configured in
     5326        <span class="emphasis"><em>daemon</em></span> mode like this:
     5327        </p><pre class="programlisting">
     5328        rpc_server:spoolss = daemon
     5329        </pre><p>
     5330        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>rpc_server</code></em> = <code class="literal">none</code>
     5331</em></span>
     5332</p></dd></dl></div></div><div class="section" title="security mask (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id332905"></a>
    52485333
    52495334security mask (S)
    5250 </h3></div></div></div><a class="indexterm" name="id332660"></a><a name="SECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5335</h3></div></div></div><a class="indexterm" name="id332906"></a><a name="SECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
    52515336        This parameter controls what UNIX permission bits will be set when a Windows NT client is manipulating the
    52525337        UNIX permission on a file using the native NT security dialog box.
    … …  
    52675352</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>security mask</code></em> = <code class="literal">0770</code>
    52685353</em></span>
    5269 </p></dd></dl></div></div><div class="section" title="security (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id332755"></a>
     5354</p></dd></dl></div></div><div class="section" title="security (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id333001"></a>
    52705355
    52715356security (G)
    5272 </h3></div></div></div><a class="indexterm" name="id332756"></a><a name="SECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option affects how clients respond to
     5357</h3></div></div></div><a class="indexterm" name="id333002"></a><a name="SECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option affects how clients respond to
    52735358    Samba and is one of the most important settings in the <code class="filename">
    52745359    smb.conf</code> file.</p><p>The option sets the "security mode bit" in replies to
    … …  
    53945479</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>security</code></em> = <code class="literal">DOMAIN</code>
    53955480</em></span>
    5396 </p></dd></dl></div></div><div class="section" title="server schannel (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id333543"></a>
     5481</p></dd></dl></div></div><div class="section" title="send spnego principal (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id333789"></a>
     5482
     5483send spnego principal (G)
     5484</h3></div></div></div><a class="indexterm" name="id333790"></a><a name="SENDSPNEGOPRINCIPAL"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not
     5485    <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will send the
     5486    server-supplied principal sometimes given in the SPNEGO
     5487    exchange.</p><p>If enabled, Samba can attempt to help clients to use
     5488    Kerberos to contact it, even when known only by IP address or a
     5489    name not registered with our KDC as a service principal name.
     5490    Kerberos relies on names, so ordinarily cannot function in this
     5491    situation. </p><p>If disabled, Samba will send the string
     5492    not_defined_in_RFC4178@please_ignore as the 'rfc4178 hint',
     5493    following the updated RFC and Windows 2008 behaviour in this area.
     5494    </p><p>Note that Windows XP SP2 and later versions already ignored
     5495    this value in all circumstances. </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>send spnego principal</code></em> = <code class="literal">no</code>
     5496</em></span>
     5497</p></dd></dl></div></div><div class="section" title="server schannel (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id333854"></a>
    53975498
    53985499server schannel (G)
    5399 </h3></div></div></div><a class="indexterm" name="id333544"></a><a name="SERVERSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5500</h3></div></div></div><a class="indexterm" name="id333855"></a><a name="SERVERSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    54005501        This controls whether the server offers or even demands the use of the netlogon schannel.
    54015502        <a class="link" href="smb.conf.5.html#SERVERSCHANNEL" target="_top">server schannel = no</a> does not offer the schannel, <a class="link" href="smb.conf.5.html#SERVERSCHANNEL" target="_top">server schannel = auto</a> offers the schannel but does not enforce it, and <a class="link" href="smb.conf.5.html#SERVERSCHANNEL" target="_top">server schannel = yes</a> denies access if the client is not able to speak netlogon schannel.
    … …  
    54085509</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>server schannel</code></em> = <code class="literal">yes</code>
    54095510</em></span>
    5410 </p></dd></dl></div></div><div class="section" title="server signing (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id333651"></a>
     5511</p></dd></dl></div></div><div class="section" title="server signing (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id333962"></a>
    54115512
    54125513server signing (G)
    5413 </h3></div></div></div><a class="indexterm" name="id333652"></a><a name="SERVERSIGNING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether the client is allowed or required to use SMB signing. Possible values
     5514</h3></div></div></div><a class="indexterm" name="id333963"></a><a name="SERVERSIGNING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether the client is allowed or required to use SMB signing. Possible values
    54145515    are <span class="emphasis"><em>auto</em></span>, <span class="emphasis"><em>mandatory</em></span>
    54155516    and <span class="emphasis"><em>disabled</em></span>.
    … …  
    54185519        to disabled, SMB signing is not offered either.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>server signing</code></em> = <code class="literal">Disabled</code>
    54195520</em></span>
    5420 </p></dd></dl></div></div><div class="section" title="server string (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id333708"></a>
     5521</p></dd></dl></div></div><div class="section" title="server string (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id334019"></a>
    54215522
    54225523server string (G)
    5423 </h3></div></div></div><a class="indexterm" name="id333709"></a><a name="SERVERSTRING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what string will show up in the printer comment box in print
     5524</h3></div></div></div><a class="indexterm" name="id334020"></a><a name="SERVERSTRING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what string will show up in the printer comment box in print
    54245525        manager and next to the IPC connection in <code class="literal">net view</code>. It
    54255526        can be any string that you wish to show to your users.</p><p>It also sets what will appear in browse lists next
    … …  
    54305531</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>server string</code></em> = <code class="literal">University of GNUs Samba Server</code>
    54315532</em></span>
    5432 </p></dd></dl></div></div><div class="section" title="set directory (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id333795"></a>
     5533</p></dd></dl></div></div><div class="section" title="set directory (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id334106"></a>
    54335534
    54345535set directory (S)
    5435 </h3></div></div></div><a class="indexterm" name="id333796"></a><a name="SETDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5536</h3></div></div></div><a class="indexterm" name="id334107"></a><a name="SETDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    54365537        If <code class="literal">set directory = no</code>, then        users of the
    54375538        service may not use the setdir command to change directory.
    … …  
    54425543        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>set directory</code></em> = <code class="literal">no</code>
    54435544</em></span>
    5444 </p></dd></dl></div></div><div class="section" title="set primary group script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id333852"></a>
     5545</p></dd></dl></div></div><div class="section" title="set primary group script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id334163"></a>
    54455546
    54465547set primary group script (G)
    5447 </h3></div></div></div><a class="indexterm" name="id333854"></a><a name="SETPRIMARYGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>Thanks to the Posix subsystem in NT a Windows User has a
     5548</h3></div></div></div><a class="indexterm" name="id334164"></a><a name="SETPRIMARYGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>Thanks to the Posix subsystem in NT a Windows User has a
    54485549        primary group in addition to the auxiliary groups.  This script
    54495550        sets the primary group in the unix userdatase when an
    … …  
    54575558</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>set primary group script</code></em> = <code class="literal">/usr/sbin/usermod -g '%g' '%u'</code>
    54585559</em></span>
    5459 </p></dd></dl></div></div><div class="section" title="set quota command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id333930"></a>
     5560</p></dd></dl></div></div><div class="section" title="set quota command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id334240"></a>
    54605561
    54615562set quota command (G)
    5462 </h3></div></div></div><a class="indexterm" name="id333931"></a><a name="SETQUOTACOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>The <code class="literal">set quota command</code> should only be used
     5563</h3></div></div></div><a class="indexterm" name="id334241"></a><a name="SETQUOTACOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>The <code class="literal">set quota command</code> should only be used
    54635564        whenever there is no operating system API available from the OS that
    54645565        samba can use.</p><p>This option is only available if Samba was configured with the argument <code class="literal">--with-sys-quotas</code> or
    … …  
    54705571</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>set quota command</code></em> = <code class="literal">/usr/local/sbin/set_quota</code>
    54715572</em></span>
    5472 </p></dd></dl></div></div><div class="section" title="share:fake_fscaps (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id334083"></a>
     5573</p></dd></dl></div></div><div class="section" title="share:fake_fscaps (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id334394"></a>
    54735574
    54745575share:fake_fscaps (G)
    5475 </h3></div></div></div><a class="indexterm" name="id334084"></a><a name="SHARE:FAKE_FSCAPS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5576</h3></div></div></div><a class="indexterm" name="id334395"></a><a name="SHARE:FAKE_FSCAPS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    54765577        This is needed to support some special application that makes
    54775578        QFSINFO calls to check whether we set the SPARSE_FILES bit
    … …  
    54835584        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>share:fake_fscaps</code></em> = <code class="literal">0</code>
    54845585</em></span>
    5485 </p></dd></dl></div></div><div class="section" title="share modes (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id334140"></a>
     5586</p></dd></dl></div></div><div class="section" title="share modes (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id334450"></a>
    54865587
    54875588share modes (S)
    5488 </h3></div></div></div><a class="indexterm" name="id334141"></a><a name="SHAREMODES"></a><div class="variablelist"><dl><dt></dt><dd><p>This enables or disables the honoring of
     5589</h3></div></div></div><a class="indexterm" name="id334451"></a><a name="SHAREMODES"></a><div class="variablelist"><dl><dt></dt><dd><p>This enables or disables the honoring of
    54895590        the <em class="parameter"><code>share modes</code></em> during a file open. These
    54905591        modes are used by clients to gain exclusive read or write access
    … …  
    54985599        off as many Windows applications will break if you do so.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>share modes</code></em> = <code class="literal">yes</code>
    54995600</em></span>
    5500 </p></dd></dl></div></div><div class="section" title="short preserve case (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id334210"></a>
     5601</p></dd></dl></div></div><div class="section" title="short preserve case (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id334520"></a>
    55015602
    55025603short preserve case (S)
    5503 </h3></div></div></div><a class="indexterm" name="id334211"></a><a name="SHORTPRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5604</h3></div></div></div><a class="indexterm" name="id334522"></a><a name="SHORTPRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    55045605        This boolean parameter controls if new files which conform to 8.3 syntax, that is all in upper case and of
    55055606        suitable length, are created upper case, or if they are forced to be the <a class="link" href="smb.conf.5.html#DEFAULTCASE" target="_top">default case</a>.
    … …  
    55085609        </p><p>See the section on <a class="link" href="#NAMEMANGLINGSECT" title="NAME MANGLING">NAME MANGLING</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>short preserve case</code></em> = <code class="literal">yes</code>
    55095610</em></span>
    5510 </p></dd></dl></div></div><div class="section" title="show add printer wizard (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id334284"></a>
     5611</p></dd></dl></div></div><div class="section" title="show add printer wizard (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id334594"></a>
    55115612
    55125613show add printer wizard (G)
    5513 </h3></div></div></div><a class="indexterm" name="id334285"></a><a name="SHOWADDPRINTERWIZARD"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printing support
     5614</h3></div></div></div><a class="indexterm" name="id334595"></a><a name="SHOWADDPRINTERWIZARD"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printing support
    55145615    for Windows NT/2000 client in Samba 2.2, a "Printers..." folder will
    55155616    appear on Samba hosts in the share listing.  Normally this folder will
    … …  
    55295630                administrative privilege on an individual printer.</p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>show add printer wizard</code></em> = <code class="literal">yes</code>
    55305631</em></span>
    5531 </p></dd></dl></div></div><div class="section" title="shutdown script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id334356"></a>
     5632</p></dd></dl></div></div><div class="section" title="shutdown script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id334667"></a>
    55325633
    55335634shutdown script (G)
    5534 </h3></div></div></div><a class="indexterm" name="id334357"></a><a name="SHUTDOWNSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This a full path name to a script called by
     5635</h3></div></div></div><a class="indexterm" name="id334668"></a><a name="SHUTDOWNSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This a full path name to a script called by
    55355636         <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> that should
    55365637        start a shutdown procedure.</p><p>If the connected user posseses the <code class="constant">SeRemoteShutdownPrivilege</code>,
    … …  
    55585659</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>shutdown script</code></em> = <code class="literal">/usr/local/samba/sbin/shutdown %m %t %r %f</code>
    55595660</em></span>
    5560 </p></dd></dl></div></div><div class="section" title="smb encrypt (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id334503"></a>
     5661</p></dd></dl></div></div><div class="section" title="smb2 max credits (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id334813"></a>
     5662
     5663smb2 max credits (G)
     5664</h3></div></div></div><a class="indexterm" name="id334814"></a><a name="SMB2MAXCREDITS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum number of outstanding simultaneous SMB2 operations
     5665that Samba tells the client it will allow. This is similar to the <a class="link" href="smb.conf.5.html#MAXMUX" target="_top">max mux</a>
     5666parameter for SMB1. You should never need to set this parameter.
     5667</p><p>The default is 128 credits, which is the same as a Windows SMB2 server.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>smb2 max credits</code></em> = <code class="literal">128</code>
     5668</em></span>
     5669</p></dd></dl></div></div><div class="section" title="smb2 max read (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id334871"></a>
     5670
     5671smb2 max read (G)
     5672</h3></div></div></div><a class="indexterm" name="id334872"></a><a name="SMB2MAXREAD"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the protocol value that <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will return to a client, informing the client of the largest
     5673size that may be returned by a single SMB2 read call.
     5674</p><p>The default is 1048576 bytes (1MB), which is the same as a Windows7 SMB2 server.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>smb2 max read</code></em> = <code class="literal">1048576</code>
     5675</em></span>
     5676</p></dd></dl></div></div><div class="section" title="smb2 max trans (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id334924"></a>
     5677
     5678smb2 max trans (G)
     5679</h3></div></div></div><a class="indexterm" name="id334925"></a><a name="SMB2MAXTRANS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the protocol value that <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will return to a client, informing the client of the largest
     5680size of buffer that may be used in querying file meta-data via QUERY_INFO and related SMB2 calls.
     5681</p><p>The default is 1048576 bytes (1MB), which is the same as a Windows7 SMB2 server.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>smb2 max trans</code></em> = <code class="literal">1048576</code>
     5682</em></span>
     5683</p></dd></dl></div></div><div class="section" title="smb2 max write (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id334979"></a>
     5684
     5685smb2 max write (G)
     5686</h3></div></div></div><a class="indexterm" name="id334980"></a><a name="SMB2MAXWRITE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the protocol value that <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will return to a client, informing the client of the largest
     5687size that may be sent to the server by a single SMB2 write call.
     5688</p><p>The default is 1048576 bytes (1MB), which is the same as a Windows7 SMB2 server.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>smb2 max write</code></em> = <code class="literal">1048576</code>
     5689</em></span>
     5690</p></dd></dl></div></div><div class="section" title="smb encrypt (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id335033"></a>
    55615691
    55625692smb encrypt (S)
    5563 </h3></div></div></div><a class="indexterm" name="id334504"></a><a name="SMBENCRYPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a new feature introduced with Samba 3.2 and above. It is an
     5693</h3></div></div></div><a class="indexterm" name="id335034"></a><a name="SMBENCRYPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a new feature introduced with Samba 3.2 and above. It is an
    55645694    extension to the SMB/CIFS protocol negotiated as part of the UNIX extensions.
    55655695    SMB encryption uses the GSSAPI (SSPI on Windows) ability to encrypt
    … …  
    55895719    to disabled, SMB encryption can not be negotiated.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>smb encrypt</code></em> = <code class="literal">auto</code>
    55905720</em></span>
    5591 </p></dd></dl></div></div><div class="section" title="smb passwd file (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id334599"></a>
     5721</p></dd></dl></div></div><div class="section" title="smb passwd file (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id335124"></a>
    55925722
    55935723smb passwd file (G)
    5594 </h3></div></div></div><a class="indexterm" name="id334600"></a><a name="SMBPASSWDFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option sets the path to the encrypted smbpasswd file. By
     5724</h3></div></div></div><a class="indexterm" name="id335125"></a><a name="SMBPASSWDFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option sets the path to the encrypted smbpasswd file. By
    55955725    default the path to the smbpasswd file  is compiled into Samba.</p><p>
    55965726    An example of use is:
    … …  
    56005730    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>smb passwd file</code></em> = <code class="literal">${prefix}/private/smbpasswd</code>
    56015731</em></span>
    5602 </p></dd></dl></div></div><div class="section" title="smb ports (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id334651"></a>
     5732</p></dd></dl></div></div><div class="section" title="smb ports (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id335176"></a>
    56035733
    56045734smb ports (G)
    5605 </h3></div></div></div><a class="indexterm" name="id334652"></a><a name="SMBPORTS"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies which ports the server should listen on for SMB traffic.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>smb ports</code></em> = <code class="literal">445 139</code>
    5606 </em></span>
    5607 </p></dd></dl></div></div><div class="section" title="socket address (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id334692"></a>
     5735</h3></div></div></div><a class="indexterm" name="id335177"></a><a name="SMBPORTS"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies which ports the server should listen on for SMB traffic.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>smb ports</code></em> = <code class="literal">445 139</code>
     5736</em></span>
     5737</p></dd></dl></div></div><div class="section" title="socket address (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id335217"></a>
    56085738
    56095739socket address (G)
    5610 </h3></div></div></div><a class="indexterm" name="id334693"></a><a name="SOCKETADDRESS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to control what
     5740</h3></div></div></div><a class="indexterm" name="id335218"></a><a name="SOCKETADDRESS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to control what
    56115741        address Samba will listen for connections on. This is used to
    56125742        support multiple virtual interfaces on the one server, each
    … …  
    56175747</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>socket address</code></em> = <code class="literal">192.168.2.20</code>
    56185748</em></span>
    5619 </p></dd></dl></div></div><div class="section" title="socket options (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id334758"></a>
     5749</p></dd></dl></div></div><div class="section" title="socket options (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id335283"></a>
    56205750
    56215751socket options (G)
    5622 </h3></div></div></div><a class="indexterm" name="id334759"></a><a name="SOCKETOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to set socket options
     5752</h3></div></div></div><a class="indexterm" name="id335284"></a><a name="SOCKETOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to set socket options
    56235753    to be used when talking with the client.</p><p>Socket options are controls on the networking layer
    56245754    of the operating systems which allow the connection to be
    … …  
    56485778</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>socket options</code></em> = <code class="literal">IPTOS_LOWDELAY</code>
    56495779</em></span>
    5650 </p></dd></dl></div></div><div class="section" title="stat cache (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id334950"></a>
     5780</p></dd></dl></div></div><div class="section" title="stat cache (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id335475"></a>
    56515781
    56525782stat cache (G)
    5653 </h3></div></div></div><a class="indexterm" name="id334951"></a><a name="STATCACHE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines if <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will use a cache in order to
     5783</h3></div></div></div><a class="indexterm" name="id335476"></a><a name="STATCACHE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines if <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will use a cache in order to
    56545784        speed up case insensitive name mappings. You should never need
    56555785        to change this parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>stat cache</code></em> = <code class="literal">yes</code>
    56565786</em></span>
    5657 </p></dd></dl></div></div><div class="section" title="state directory (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id335000"></a>
     5787</p></dd></dl></div></div><div class="section" title="state directory (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id335525"></a>
    56585788
    56595789state directory (G)
    5660 </h3></div></div></div><a class="indexterm" name="id335001"></a><a name="STATEDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>Usually, most of the TDB files are stored in the
     5790</h3></div></div></div><a class="indexterm" name="id335526"></a><a name="STATEDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>Usually, most of the TDB files are stored in the
    56615791        <em class="parameter"><code>lock directory</code></em>. Since
    56625792        Samba 3.4.0, it is possible to differentiate between TDB files
    … …  
    56705800</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>state directory</code></em> = <code class="literal">/var/run/samba/locks/state</code>
    56715801</em></span>
    5672 </p></dd></dl></div></div><div class="section" title="store dos attributes (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id335082"></a>
     5802</p></dd></dl></div></div><div class="section" title="store dos attributes (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id335607"></a>
    56735803
    56745804store dos attributes (S)
    5675 </h3></div></div></div><a class="indexterm" name="id335083"></a><a name="STOREDOSATTRIBUTES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5805</h3></div></div></div><a class="indexterm" name="id335608"></a><a name="STOREDOSATTRIBUTES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    56765806        If this parameter is set Samba attempts to first read DOS attributes (SYSTEM, HIDDEN, ARCHIVE or
    56775807        READ-ONLY) from a filesystem extended attribute, before mapping DOS attributes to UNIX permission bits (such
    … …  
    56925822        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>store dos attributes</code></em> = <code class="literal">no</code>
    56935823</em></span>
    5694 </p></dd></dl></div></div><div class="section" title="strict allocate (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id335198"></a>
     5824</p></dd></dl></div></div><div class="section" title="strict allocate (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id335731"></a>
    56955825
    56965826strict allocate (S)
    5697 </h3></div></div></div><a class="indexterm" name="id335199"></a><a name="STRICTALLOCATE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean that controls the handling of
     5827</h3></div></div></div><a class="indexterm" name="id335732"></a><a name="STRICTALLOCATE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean that controls the handling of
    56985828    disk space allocation in the server. When this is set to <code class="constant">yes</code>
    56995829    the server will change from UNIX behaviour of not committing real
    … …  
    57025832    when a file is created or extended to be a given size. In UNIX
    57035833    terminology this means that Samba will stop creating sparse files.
    5704     This can be slow on some systems. When you work with large files like
    5705     &gt;100MB or so you may even run into problems with clients running into
    5706     timeouts.</p><p>When you have an extent based filesystem it's likely that we can make
     5834    Modern UNIX filesystems now support extents and so in Samba 3.6.0 we
     5835    have changed this parameter to default to "yes". On older filesystems
     5836    without extents you might want to turn this parameter to "no".
     5837    </p><p>When you have an extent based filesystem it's likely that we can make
    57075838    use of unwritten extents which allows Samba to allocate even large amounts
    57085839    of space very fast and you will not see any timeout problems caused by
    … …  
    57165847    performance and risk to let clients run into timeouts when creating large
    57175848    files. Examples are ext3, ZFS, HFS+ and most others, so be aware if you
    5718     activate this setting on those filesystems.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>strict allocate</code></em> = <code class="literal">no</code>
    5719 </em></span>
    5720 </p></dd></dl></div></div><div class="section" title="strict locking (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id335264"></a>
     5849    leave the default setting on those filesystems.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>strict allocate</code></em> = <code class="literal">yes</code>
     5850</em></span>
     5851</p></dd></dl></div></div><div class="section" title="strict locking (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id335795"></a>
    57215852
    57225853strict locking (S)
    5723 </h3></div></div></div><a class="indexterm" name="id335266"></a><a name="STRICTLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5854</h3></div></div></div><a class="indexterm" name="id335796"></a><a name="STRICTLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
    57245855        This is an enumerated type that controls the handling of file locking in the server. When this is set to <code class="constant">yes</code>,
    57255856        the server will check every read and write access for file locks, and deny access if locks exist. This can be slow on
    … …  
    57375868        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>strict locking</code></em> = <code class="literal">Auto</code>
    57385869</em></span>
    5739 </p></dd></dl></div></div><div class="section" title="strict sync (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id335336"></a>
     5870</p></dd></dl></div></div><div class="section" title="strict sync (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id335868"></a>
    57405871
    57415872strict sync (S)
    5742 </h3></div></div></div><a class="indexterm" name="id335337"></a><a name="STRICTSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>Many Windows applications (including the Windows 98 explorer
     5873</h3></div></div></div><a class="indexterm" name="id335869"></a><a name="STRICTSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>Many Windows applications (including the Windows 98 explorer
    57435874    shell) seem to confuse flushing buffer contents to disk with doing
    57445875    a sync to disk. Under UNIX, a sync call forces the process to be
    … …  
    57545885    reported with the new Windows98 explorer shell file copies.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>strict sync</code></em> = <code class="literal">no</code>
    57555886</em></span>
    5756 </p></dd></dl></div></div><div class="section" title="svcctl list (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id335394"></a>
     5887</p></dd></dl></div></div><div class="section" title="svcctl list (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id335926"></a>
    57575888
    57585889svcctl list (G)
    5759 </h3></div></div></div><a class="indexterm" name="id335395"></a><a name="SVCCTLLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of init scripts that smbd
     5890</h3></div></div></div><a class="indexterm" name="id335927"></a><a name="SVCCTLLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of init scripts that smbd
    57605891    will use for starting and stopping Unix services via the Win32
    57615892    ServiceControl API.  This allows Windows administrators to
    … …  
    57705901</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>svcctl list</code></em> = <code class="literal">cups postfix portmap httpd</code>
    57715902</em></span>
    5772 </p></dd></dl></div></div><div class="section" title="sync always (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id335475"></a>
     5903</p></dd></dl></div></div><div class="section" title="sync always (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id336006"></a>
    57735904
    57745905sync always (S)
    5775 </h3></div></div></div><a class="indexterm" name="id335476"></a><a name="SYNCALWAYS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls
     5906</h3></div></div></div><a class="indexterm" name="id336007"></a><a name="SYNCALWAYS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls
    57765907    whether writes will always be written to stable storage before
    57775908    the write call returns. If this is <code class="constant">no</code> then the server will be
    … …  
    57845915    any effect.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>sync always</code></em> = <code class="literal">no</code>
    57855916</em></span>
    5786 </p></dd></dl></div></div><div class="section" title="syslog only (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id335542"></a>
     5917</p></dd></dl></div></div><div class="section" title="syslog only (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336072"></a>
    57875918
    57885919syslog only (G)
    5789 </h3></div></div></div><a class="indexterm" name="id335543"></a><a name="SYSLOGONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5920</h3></div></div></div><a class="indexterm" name="id336074"></a><a name="SYSLOGONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    57905921    If this parameter is set then Samba debug messages are logged into the system
    57915922    syslog only, and not to the debug log files. There still will be some
    … …  
    57935924    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>syslog only</code></em> = <code class="literal">no</code>
    57945925</em></span>
    5795 </p></dd></dl></div></div><div class="section" title="syslog (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id335587"></a>
     5926</p></dd></dl></div></div><div class="section" title="syslog (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336118"></a>
    57965927
    57975928syslog (G)
    5798 </h3></div></div></div><a class="indexterm" name="id335588"></a><a name="SYSLOG"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5929</h3></div></div></div><a class="indexterm" name="id336119"></a><a name="SYSLOG"></a><div class="variablelist"><dl><dt></dt><dd><p>
    57995930    This parameter maps how Samba debug messages are logged onto the system syslog logging levels.
    58005931    Samba debug level zero maps onto syslog <code class="constant">LOG_ERR</code>, debug level one maps onto
    … …  
    58075938    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>syslog</code></em> = <code class="literal">1</code>
    58085939</em></span>
    5809 </p></dd></dl></div></div><div class="section" title="template homedir (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id335654"></a>
     5940</p></dd></dl></div></div><div class="section" title="template homedir (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336185"></a>
    58105941
    58115942template homedir (G)
    5812 </h3></div></div></div><a class="indexterm" name="id335655"></a><a name="TEMPLATEHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
     5943</h3></div></div></div><a class="indexterm" name="id336186"></a><a name="TEMPLATEHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
    58135944        user, the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon  uses this
    58145945        parameter to fill in the home directory for that user. If the
    … …  
    58185949        is substituted with the user's Windows  NT user name.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>template homedir</code></em> = <code class="literal">/home/%D/%U</code>
    58195950</em></span>
    5820 </p></dd></dl></div></div><div class="section" title="template shell (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id335716"></a>
     5951</p></dd></dl></div></div><div class="section" title="template shell (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336247"></a>
    58215952
    58225953template shell (G)
    5823 </h3></div></div></div><a class="indexterm" name="id335717"></a><a name="TEMPLATESHELL"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
     5954</h3></div></div></div><a class="indexterm" name="id336248"></a><a name="TEMPLATESHELL"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
    58245955        user, the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon uses this
    5825         parameter to fill in the login shell for that user.</p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="time offset (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id335753"></a>
     5956        parameter to fill in the login shell for that user.</p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="time offset (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336284"></a>
    58265957
    58275958time offset (G)
    5828 </h3></div></div></div><a class="indexterm" name="id335754"></a><a name="TIMEOFFSET"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a setting in minutes to add
     5959</h3></div></div></div><a class="indexterm" name="id336285"></a><a name="TIMEOFFSET"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a setting in minutes to add
    58295960        to the normal GMT to local time conversion. This is useful if
    58305961        you are serving a lot of PCs that have incorrect daylight
    … …  
    58335964</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>time offset</code></em> = <code class="literal">60</code>
    58345965</em></span>
    5835 </p></dd></dl></div></div><div class="section" title="time server (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id335812"></a>
     5966</p></dd></dl></div></div><div class="section" title="time server (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336343"></a>
    58365967
    58375968time server (G)
    5838 </h3></div></div></div><a class="indexterm" name="id335814"></a><a name="TIMESERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines if <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> advertises itself as a time server to Windows
     5969</h3></div></div></div><a class="indexterm" name="id336344"></a><a name="TIMESERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines if <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> advertises itself as a time server to Windows
    58395970clients.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>time server</code></em> = <code class="literal">no</code>
    58405971</em></span>
    5841 </p></dd></dl></div></div><div class="section" title="unix charset (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id335862"></a>
     5972</p></dd></dl></div></div><div class="section" title="unix charset (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336393"></a>
    58425973
    58435974unix charset (G)
    5844 </h3></div></div></div><a class="indexterm" name="id335863"></a><a name="UNIXCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the charset the unix machine
     5975</h3></div></div></div><a class="indexterm" name="id336394"></a><a name="UNIXCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the charset the unix machine
    58455976                Samba runs on uses. Samba needs to know this in order to be able to
    58465977                convert text to the charsets other SMB clients use.
    … …  
    58515982</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>unix charset</code></em> = <code class="literal">ASCII</code>
    58525983</em></span>
    5853 </p></dd></dl></div></div><div class="section" title="unix extensions (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id335925"></a>
     5984</p></dd></dl></div></div><div class="section" title="unix extensions (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336456"></a>
    58545985
    58555986unix extensions (G)
    5856 </h3></div></div></div><a class="indexterm" name="id335926"></a><a name="UNIXEXTENSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
     5987</h3></div></div></div><a class="indexterm" name="id336457"></a><a name="UNIXEXTENSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
    58575988    implements the CIFS UNIX extensions, as defined by HP.
    58585989    These extensions enable Samba to better serve UNIX CIFS clients
    … …  
    58645995    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>unix extensions</code></em> = <code class="literal">yes</code>
    58655996</em></span>
    5866 </p></dd></dl></div></div><div class="section" title="unix password sync (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id335986"></a>
     5997</p></dd></dl></div></div><div class="section" title="unix password sync (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336517"></a>
    58675998
    58685999unix password sync (G)
    5869 </h3></div></div></div><a class="indexterm" name="id335987"></a><a name="UNIXPASSWORDSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
     6000</h3></div></div></div><a class="indexterm" name="id336518"></a><a name="UNIXPASSWORDSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
    58706001    attempts to synchronize the UNIX password with the SMB password
    58716002    when the encrypted SMB password in the smbpasswd file is changed.
    … …  
    58766007        access to the old password cleartext, only the new).</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>unix password sync</code></em> = <code class="literal">no</code>
    58776008</em></span>
    5878 </p></dd></dl></div></div><div class="section" title="update encrypted (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336043"></a>
    5879 
    5880 update encrypted (G)
    5881 </h3></div></div></div><a class="indexterm" name="id336044"></a><a name="UPDATEENCRYPTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
    5882         This boolean parameter allows a user logging on with a plaintext password to have their encrypted (hashed)
    5883         password in the smbpasswd file to be updated automatically as they log on. This option allows a site to
    5884         migrate from plaintext password authentication (users authenticate with plaintext password over the
    5885         wire, and are checked against a UNIX account database) to encrypted password authentication (the SMB
    5886         challenge/response authentication mechanism) without forcing all users to re-enter their passwords via
    5887         smbpasswd at the time the change is made. This is a convenience option to allow the change over to encrypted
    5888         passwords to be made over a longer period.  Once all users have encrypted representations of their passwords
    5889         in the smbpasswd file this parameter should be set to <code class="constant">no</code>.
    5890         </p><p>
    5891         In order for this parameter to be operative the <a class="link" href="smb.conf.5.html#ENCRYPTPASSWORDS" target="_top">encrypt passwords</a> parameter must
    5892     be set to <code class="constant">no</code>. The default value of <a class="link" href="smb.conf.5.html#ENCRYPTPASSWORDS" target="_top">encrypt  passwords = Yes</a>. Note: This must be set to <code class="constant">no</code> for this <a class="link" href="smb.conf.5.html#UPDATEENCRYPTED" target="_top">update encrypted</a> to work.
    5893         </p><p>
    5894         Note that even when this parameter is set, a user authenticating to <code class="literal">smbd</code>
    5895         must still enter a valid password in order to connect correctly, and to update their hashed (smbpasswd)
    5896         passwords.
    5897         </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>update encrypted</code></em> = <code class="literal">no</code>
    5898 </em></span>
    5899 </p></dd></dl></div></div><div class="section" title="use client driver (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id336148"></a>
     6009</p></dd></dl></div></div><div class="section" title="use client driver (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id336574"></a>
    59006010
    59016011use client driver (S)
    5902 </h3></div></div></div><a class="indexterm" name="id336149"></a><a name="USECLIENTDRIVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter applies only to Windows NT/2000
     6012</h3></div></div></div><a class="indexterm" name="id336575"></a><a name="USECLIENTDRIVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter applies only to Windows NT/2000
    59036013    clients.  It has no effect on Windows 95/98/ME clients.  When
    59046014    serving a printer to Windows NT/2000 clients without first installing
    … …  
    59256035        server.</em></span></p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use client driver</code></em> = <code class="literal">no</code>
    59266036</em></span>
    5927 </p></dd></dl></div></div><div class="section" title="use mmap (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336222"></a>
     6037</p></dd></dl></div></div><div class="section" title="use mmap (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336642"></a>
    59286038
    59296039use mmap (G)
    5930 </h3></div></div></div><a class="indexterm" name="id336223"></a><a name="USEMMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>This global parameter determines if the tdb internals of Samba can
     6040</h3></div></div></div><a class="indexterm" name="id336643"></a><a name="USEMMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>This global parameter determines if the tdb internals of Samba can
    59316041    depend on mmap working correctly on the running system. Samba requires a coherent
    59326042    mmap/read-write system memory cache. Currently only HPUX does not have such a
    … …  
    59376047    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use mmap</code></em> = <code class="literal">yes</code>
    59386048</em></span>
    5939 </p></dd></dl></div></div><div class="section" title="username level (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336270"></a>
     6049</p></dd></dl></div></div><div class="section" title="username level (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336690"></a>
    59406050
    59416051username level (G)
    5942 </h3></div></div></div><a class="indexterm" name="id336271"></a><a name="USERNAMELEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option helps Samba to try and 'guess' at
     6052</h3></div></div></div><a class="indexterm" name="id336691"></a><a name="USERNAMELEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option helps Samba to try and 'guess' at
    59436053    the real UNIX username, as many DOS clients send an all-uppercase
    59446054    username. By default Samba tries all lowercase, followed by the
    … …  
    59556065</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>username level</code></em> = <code class="literal">5</code>
    59566066</em></span>
    5957 </p></dd></dl></div></div><div class="section" title="username map script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336343"></a>
     6067</p></dd></dl></div></div><div class="section" title="username map cache time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336763"></a>
     6068
     6069username map cache time (G)
     6070</h3></div></div></div><a class="indexterm" name="id336764"></a><a name="USERNAMEMAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6071        Mapping usernames with the <a class="link" href="smb.conf.5.html#USERNAMEMAP" target="_top">username map</a>
     6072        or <a class="link" href="smb.conf.5.html#USERNAMEMAPSCRIPT" target="_top">username map script</a>
     6073        features of Samba can be relatively expensive.
     6074        During login of a user, the mapping is done several times.
     6075        In particular, calling the <a class="link" href="smb.conf.5.html#USERNAMEMAPSCRIPT" target="_top">username map script</a>
     6076        can slow down logins if external databases have to be queried from
     6077        the script being called.
     6078        </p><p>
     6079        The parameter <a class="link" href="smb.conf.5.html#USERNAMEMAPCACHETIME" target="_top">username map cache time</a>
     6080        controls a mapping cache. It specifies the number of seconds a
     6081        mapping from the username map file or script is to be efficiently cached.
     6082        The default of 0 means no caching is done.
     6083        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>username map cache time</code></em> = <code class="literal">0</code>
     6084</em></span>
     6085</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>username map cache time</code></em> = <code class="literal">60</code>
     6086</em></span>
     6087</p></dd></dl></div></div><div class="section" title="username map script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336873"></a>
    59586088
    59596089username map script (G)
    5960 </h3></div></div></div><a class="indexterm" name="id336344"></a><a name="USERNAMEMAPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This script is a mutually exclusive alternative to the
     6090</h3></div></div></div><a class="indexterm" name="id336874"></a><a name="USERNAMEMAPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This script is a mutually exclusive alternative to the
    59616091        <a class="link" href="smb.conf.5.html#USERNAMEMAP" target="_top">username map</a> parameter.  This parameter
    59626092        specifies and external program or script that must accept a single
    … …  
    59696099</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>username map script</code></em> = <code class="literal">/etc/samba/scripts/mapusers.sh</code>
    59706100</em></span>
    5971 </p></dd></dl></div></div><div class="section" title="username map (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336415"></a>
     6101</p></dd></dl></div></div><div class="section" title="username map (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336944"></a>
    59726102
    59736103username map (G)
    5974 </h3></div></div></div><a class="indexterm" name="id336416"></a><a name="USERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6104</h3></div></div></div><a class="indexterm" name="id336945"></a><a name="USERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    59756105        This option allows you to specify a file containing a mapping of usernames from the clients to the server.
    59766106        This can be used for several purposes. The most common is to map usernames that users use on DOS or Windows
    … …  
    60566186# no username map</code>
    60576187</em></span>
    6058 </p></dd></dl></div></div><div class="section" title="user"><div class="titlepage"><div><div><h3 class="title"><a name="id336657"></a>
     6188</p></dd></dl></div></div><div class="section" title="user"><div class="titlepage"><div><div><h3 class="title"><a name="id337186"></a>
    60596189
    60606190<a name="USER"></a>user
    6061 </h3></div></div></div><a class="indexterm" name="id336658"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#USERNAME">username</a>.</p></dd></dl></div></div><div class="section" title="users"><div class="titlepage"><div><div><h3 class="title"><a name="id336689"></a>
     6191</h3></div></div></div><a class="indexterm" name="id337187"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#USERNAME">username</a>.</p></dd></dl></div></div><div class="section" title="users"><div class="titlepage"><div><div><h3 class="title"><a name="id337217"></a>
    60626192
    60636193<a name="USERS"></a>users
    6064 </h3></div></div></div><a class="indexterm" name="id336690"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#USERNAME">username</a>.</p></dd></dl></div></div><div class="section" title="username (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id336720"></a>
     6194</h3></div></div></div><a class="indexterm" name="id337218"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#USERNAME">username</a>.</p></dd></dl></div></div><div class="section" title="username (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id337248"></a>
    60656195
    60666196username (S)
    6067 </h3></div></div></div><a class="indexterm" name="id336721"></a><a name="USERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>Multiple users may be specified in a comma-delimited
     6197</h3></div></div></div><a class="indexterm" name="id337250"></a><a name="USERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>Multiple users may be specified in a comma-delimited
    60686198    list, in which case the supplied password will be tested against
    60696199    each username in turn (left to right).</p><p>The <em class="parameter"><code>username</code></em> line is needed only when
    … …  
    61036233</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>username</code></em> = <code class="literal">fred, mary, jack, jane, @users, @pcgroup</code>
    61046234</em></span>
    6105 </p></dd></dl></div></div><div class="section" title="usershare allow guests (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336866"></a>
     6235</p></dd></dl></div></div><div class="section" title="usershare allow guests (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id337395"></a>
    61066236
    61076237usershare allow guests (G)
    6108 </h3></div></div></div><a class="indexterm" name="id336867"></a><a name="USERSHAREALLOWGUESTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether user defined shares are allowed
     6238</h3></div></div></div><a class="indexterm" name="id337396"></a><a name="USERSHAREALLOWGUESTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether user defined shares are allowed
    61096239        to be accessed by non-authenticated users or not. It is the equivalent
    61106240        of allowing people who can create a share the option of setting
    … …  
    61136243        is set to off.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare allow guests</code></em> = <code class="literal">no</code>
    61146244</em></span>
    6115 </p></dd></dl></div></div><div class="section" title="usershare max shares (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336915"></a>
     6245</p></dd></dl></div></div><div class="section" title="usershare max shares (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id337444"></a>
    61166246
    61176247usershare max shares (G)
    6118 </h3></div></div></div><a class="indexterm" name="id336916"></a><a name="USERSHAREMAXSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of user defined shares
     6248</h3></div></div></div><a class="indexterm" name="id337445"></a><a name="USERSHAREMAXSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of user defined shares
    61196249        that are allowed to be created by users belonging to the group owning the
    61206250        usershare directory. If set to zero (the default) user defined shares are ignored.
    61216251        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare max shares</code></em> = <code class="literal">0</code>
    61226252</em></span>
    6123 </p></dd></dl></div></div><div class="section" title="usershare owner only (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id336957"></a>
     6253</p></dd></dl></div></div><div class="section" title="usershare owner only (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id337486"></a>
    61246254
    61256255usershare owner only (G)
    6126 </h3></div></div></div><a class="indexterm" name="id336958"></a><a name="USERSHAREOWNERONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether the pathname exported by
     6256</h3></div></div></div><a class="indexterm" name="id337487"></a><a name="USERSHAREOWNERONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether the pathname exported by
    61276257        a user defined shares must be owned by the user creating the
    61286258        user defined share or not. If set to True (the default) then
    … …  
    61346264        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare owner only</code></em> = <code class="literal">True</code>
    61356265</em></span>
    6136 </p></dd></dl></div></div><div class="section" title="usershare path (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id337002"></a>
     6266</p></dd></dl></div></div><div class="section" title="usershare path (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id337530"></a>
    61376267
    61386268usershare path (G)
    6139 </h3></div></div></div><a class="indexterm" name="id337003"></a><a name="USERSHAREPATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the absolute path of the directory on the
     6269</h3></div></div></div><a class="indexterm" name="id337531"></a><a name="USERSHAREPATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the absolute path of the directory on the
    61406270        filesystem used to store the user defined share definition files.
    61416271        This directory must be owned by root, and have no access for
    … …  
    61586288        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare path</code></em> = <code class="literal">NULL</code>
    61596289</em></span>
    6160 </p></dd></dl></div></div><div class="section" title="usershare prefix allow list (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id337065"></a>
     6290</p></dd></dl></div></div><div class="section" title="usershare prefix allow list (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id337594"></a>
    61616291
    61626292usershare prefix allow list (G)
    6163 </h3></div></div></div><a class="indexterm" name="id337066"></a><a name="USERSHAREPREFIXALLOWLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
     6293</h3></div></div></div><a class="indexterm" name="id337595"></a><a name="USERSHAREPREFIXALLOWLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
    61646294        the root of which are allowed to be exported by user defined share definitions.
    61656295        If the pathname to be exported doesn't start with one of the strings in this
    … …  
    61766306</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>usershare prefix allow list</code></em> = <code class="literal">/home /data /space</code>
    61776307</em></span>
    6178 </p></dd></dl></div></div><div class="section" title="usershare prefix deny list (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id337133"></a>
     6308</p></dd></dl></div></div><div class="section" title="usershare prefix deny list (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id337661"></a>
    61796309
    61806310usershare prefix deny list (G)
    6181 </h3></div></div></div><a class="indexterm" name="id337134"></a><a name="USERSHAREPREFIXDENYLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
     6311</h3></div></div></div><a class="indexterm" name="id337662"></a><a name="USERSHAREPREFIXDENYLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
    61826312        the root of which are NOT allowed to be exported by user defined share definitions.
    61836313        If the pathname exported starts with one of the strings in this
    … …  
    61956325</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>usershare prefix deny list</code></em> = <code class="literal">/etc /dev /private</code>
    61966326</em></span>
    6197 </p></dd></dl></div></div><div class="section" title="usershare template share (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id337199"></a>
     6327</p></dd></dl></div></div><div class="section" title="usershare template share (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id337728"></a>
    61986328
    61996329usershare template share (G)
    6200 </h3></div></div></div><a class="indexterm" name="id337200"></a><a name="USERSHARETEMPLATESHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>User defined shares only have limited possible parameters
     6330</h3></div></div></div><a class="indexterm" name="id337729"></a><a name="USERSHARETEMPLATESHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>User defined shares only have limited possible parameters
    62016331        such as path, guest ok, etc. This parameter allows usershares to
    62026332        "cloned" from an existing share. If "usershare template share"
    … …  
    62136343</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>usershare template share</code></em> = <code class="literal">template_share</code>
    62146344</em></span>
    6215 </p></dd></dl></div></div><div class="section" title="use sendfile (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id337266"></a>
     6345</p></dd></dl></div></div><div class="section" title="use sendfile (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id337795"></a>
    62166346
    62176347use sendfile (S)
    6218 </h3></div></div></div><a class="indexterm" name="id337267"></a><a name="USESENDFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code>, and the <code class="constant">sendfile()</code>
     6348</h3></div></div></div><a class="indexterm" name="id337796"></a><a name="USESENDFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code>, and the <code class="constant">sendfile()</code>
    62196349    system call is supported by the underlying operating system, then some SMB read calls
    62206350    (mainly ReadAndX and ReadRaw) will use the more efficient sendfile system call for files that
    … …  
    62256355    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use sendfile</code></em> = <code class="literal">false</code>
    62266356</em></span>
    6227 </p></dd></dl></div></div><div class="section" title="use spnego (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id337319"></a>
     6357</p></dd></dl></div></div><div class="section" title="use spnego (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id337847"></a>
    62286358
    62296359use spnego (G)
    6230 </h3></div></div></div><a class="indexterm" name="id337320"></a><a name="USESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p>This variable controls controls whether samba will try
     6360</h3></div></div></div><a class="indexterm" name="id337848"></a><a name="USESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p>This variable controls controls whether samba will try
    62316361    to use Simple and Protected NEGOciation (as specified by rfc2478) with
    62326362    WindowsXP and Windows2000 clients to agree upon an authentication mechanism.
    … …  
    62366366        disabled.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use spnego</code></em> = <code class="literal">yes</code>
    62376367</em></span>
    6238 </p></dd></dl></div></div><div class="section" title="utmp directory (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id337365"></a>
     6368</p></dd></dl></div></div><div class="section" title="utmp directory (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id337894"></a>
    62396369
    62406370utmp directory (G)
    6241 </h3></div></div></div><a class="indexterm" name="id337366"></a><a name="UTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only available if Samba has
     6371</h3></div></div></div><a class="indexterm" name="id337895"></a><a name="UTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only available if Samba has
    62426372        been configured and compiled with the option <code class="literal">
    62436373        --with-utmp</code>. It specifies a directory pathname that is
    … …  
    62516381</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>utmp directory</code></em> = <code class="literal">/var/run/utmp</code>
    62526382</em></span>
    6253 </p></dd></dl></div></div><div class="section" title="utmp (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id337439"></a>
     6383</p></dd></dl></div></div><div class="section" title="utmp (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id337967"></a>
    62546384
    62556385utmp (G)
    6256 </h3></div></div></div><a class="indexterm" name="id337440"></a><a name="UTMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6386</h3></div></div></div><a class="indexterm" name="id337968"></a><a name="UTMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    62576387        This boolean parameter is only available if Samba has been configured and compiled 
    62586388        with the option <code class="literal">--with-utmp</code>. If set to
    … …  
    62666396        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>utmp</code></em> = <code class="literal">no</code>
    62676397</em></span>
    6268 </p></dd></dl></div></div><div class="section" title="valid users (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id337496"></a>
     6398</p></dd></dl></div></div><div class="section" title="valid users (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id338025"></a>
    62696399
    62706400valid users (S)
    6271 </h3></div></div></div><a class="indexterm" name="id337497"></a><a name="VALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6401</h3></div></div></div><a class="indexterm" name="id338026"></a><a name="VALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    62726402    This is a list of users that should be allowed to login to this service. Names starting with
    62736403    '@', '+' and  '&amp;' are interpreted using the same rules as described in the
    … …  
    62856415</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>valid users</code></em> = <code class="literal">greg, @pcusers</code>
    62866416</em></span>
    6287 </p></dd></dl></div></div><div class="section" title="-valid (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id337583"></a>
     6417</p></dd></dl></div></div><div class="section" title="-valid (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id338111"></a>
    62886418
    62896419-valid (S)
    6290 </h3></div></div></div><a class="indexterm" name="id337584"></a><a name="-VALID"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter indicates whether a share is
     6420</h3></div></div></div><a class="indexterm" name="id338112"></a><a name="-VALID"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter indicates whether a share is
    62916421        valid and thus can be used. When this parameter is set to false,
    62926422        the share will be in no way visible nor accessible.
    … …  
    62976427        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>-valid</code></em> = <code class="literal">yes</code>
    62986428</em></span>
    6299 </p></dd></dl></div></div><div class="section" title="veto files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id337629"></a>
     6429</p></dd></dl></div></div><div class="section" title="veto files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id338157"></a>
    63006430
    63016431veto files (S)
    6302 </h3></div></div></div><a class="indexterm" name="id337630"></a><a name="VETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6432</h3></div></div></div><a class="indexterm" name="id338158"></a><a name="VETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    63036433        This is a list of files and directories that are neither visible nor accessible.  Each entry in
    63046434        the list must be separated by a '/', which allows spaces to be included in the entry. '*' and '?'
    … …  
    63316461        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>veto files</code></em> = <code class="literal">No files or directories are vetoed.</code>
    63326462</em></span>
    6333 </p></dd></dl></div></div><div class="section" title="veto oplock files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id337736"></a>
     6463</p></dd></dl></div></div><div class="section" title="veto oplock files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id338264"></a>
    63346464
    63356465veto oplock files (S)
    6336 </h3></div></div></div><a class="indexterm" name="id337737"></a><a name="VETOOPLOCKFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6466</h3></div></div></div><a class="indexterm" name="id338266"></a><a name="VETOOPLOCKFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    63376467        This parameter is only valid when the <a class="link" href="smb.conf.5.html#OPLOCKS" target="_top">oplocks</a>
    63386468        parameter is turned on for a share. It allows the Samba administrator
    … …  
    63556485# No files are vetoed for oplock grants</code>
    63566486</em></span>
    6357 </p></dd></dl></div></div><div class="section" title="vfs object"><div class="titlepage"><div><div><h3 class="title"><a name="id337822"></a>
     6487</p></dd></dl></div></div><div class="section" title="vfs object"><div class="titlepage"><div><div><h3 class="title"><a name="id338350"></a>
    63586488
    63596489<a name="VFSOBJECT"></a>vfs object
    6360 </h3></div></div></div><a class="indexterm" name="id337823"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#VFSOBJECTS">vfs objects</a>.</p></dd></dl></div></div><div class="section" title="vfs objects (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id337854"></a>
     6490</h3></div></div></div><a class="indexterm" name="id338351"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#VFSOBJECTS">vfs objects</a>.</p></dd></dl></div></div><div class="section" title="vfs objects (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id338382"></a>
    63616491
    63626492vfs objects (S)
    6363 </h3></div></div></div><a class="indexterm" name="id337855"></a><a name="VFSOBJECTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the backend names which
     6493</h3></div></div></div><a class="indexterm" name="id338383"></a><a name="VFSOBJECTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the backend names which
    63646494        are used for Samba VFS I/O operations.  By default, normal
    63656495        disk I/O operations are used but these can be overloaded
    … …  
    63686498</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>vfs objects</code></em> = <code class="literal">extd_audit recycle</code>
    63696499</em></span>
    6370 </p></dd></dl></div></div><div class="section" title="volume (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id337912"></a>
     6500</p></dd></dl></div></div><div class="section" title="volume (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id338440"></a>
    63716501
    63726502volume (S)
    6373 </h3></div></div></div><a class="indexterm" name="id337913"></a><a name="VOLUME"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the volume label
     6503</h3></div></div></div><a class="indexterm" name="id338441"></a><a name="VOLUME"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the volume label
    63746504        returned for a share. Useful for CDROMs with installation programs
    63756505        that insist on a particular volume label.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>volume</code></em> = <code class="literal">
    63766506# the name of the share</code>
    63776507</em></span>
    6378 </p></dd></dl></div></div><div class="section" title="wide links (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id337953"></a>
     6508</p></dd></dl></div></div><div class="section" title="wide links (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id338482"></a>
    63796509
    63806510wide links (S)
    6381 </h3></div></div></div><a class="indexterm" name="id337954"></a><a name="WIDELINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not links
     6511</h3></div></div></div><a class="indexterm" name="id338483"></a><a name="WIDELINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not links
    63826512        in the UNIX file system may be followed by the server. Links
    63836513        that point to areas within the directory tree exported by the
    … …  
    63926522        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>wide links</code></em> = <code class="literal">no</code>
    63936523</em></span>
    6394 </p></dd></dl></div></div><div class="section" title="winbind cache time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338014"></a>
     6524</p></dd></dl></div></div><div class="section" title="winbind cache time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338542"></a>
    63956525
    63966526winbind cache time (G)
    6397 </h3></div></div></div><a class="indexterm" name="id338015"></a><a name="WINBINDCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of
     6527</h3></div></div></div><a class="indexterm" name="id338543"></a><a name="WINBINDCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of
    63986528        seconds the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon will cache
    63996529        user and group information before querying a Windows NT server
    … …  
    64036533        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind cache time</code></em> = <code class="literal">300</code>
    64046534</em></span>
    6405 </p></dd></dl></div></div><div class="section" title="winbind enum groups (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338080"></a>
     6535</p></dd></dl></div></div><div class="section" title="winbind enum groups (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338609"></a>
    64066536
    64076537winbind enum groups (G)
    6408 </h3></div></div></div><a class="indexterm" name="id338082"></a><a name="WINBINDENUMGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>On large installations using <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> it may be necessary to suppress
     6538</h3></div></div></div><a class="indexterm" name="id338610"></a><a name="WINBINDENUMGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>On large installations using <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> it may be necessary to suppress
    64096539        the enumeration of groups through the <code class="literal">setgrent()</code>,
    64106540        <code class="literal">getgrent()</code> and
    … …  
    64146544        call will not return any data. </p><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>Turning off group enumeration may cause some programs to behave oddly.  </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind enum groups</code></em> = <code class="literal">no</code>
    64156545</em></span>
    6416 </p></dd></dl></div></div><div class="section" title="winbind enum users (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338168"></a>
     6546</p></dd></dl></div></div><div class="section" title="winbind enum users (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338697"></a>
    64176547
    64186548winbind enum users (G)
    6419 </h3></div></div></div><a class="indexterm" name="id338169"></a><a name="WINBINDENUMUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>On large installations using <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> it may be
     6549</h3></div></div></div><a class="indexterm" name="id338698"></a><a name="WINBINDENUMUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>On large installations using <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> it may be
    64206550        necessary to suppress the enumeration of users through the <code class="literal">setpwent()</code>,
    64216551         <code class="literal">getpwent()</code> and
    … …  
    64296559        usernames. </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind enum users</code></em> = <code class="literal">no</code>
    64306560</em></span>
    6431 </p></dd></dl></div></div><div class="section" title="winbind expand groups (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338257"></a>
     6561</p></dd></dl></div></div><div class="section" title="winbind expand groups (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338786"></a>
    64326562
    64336563winbind expand groups (G)
    6434 </h3></div></div></div><a class="indexterm" name="id338258"></a><a name="WINBINDEXPANDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum depth that winbindd
     6564</h3></div></div></div><a class="indexterm" name="id338787"></a><a name="WINBINDEXPANDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum depth that winbindd
    64356565              will traverse when flattening nested group memberships
    64366566              of Windows domain groups.  This is different from the
    … …  
    64446574         incoming NSS or authentication requests during this time.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind expand groups</code></em> = <code class="literal">1</code>
    64456575</em></span>
    6446 </p></dd></dl></div></div><div class="section" title="winbind nested groups (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338319"></a>
     6576</p></dd></dl></div></div><div class="section" title="winbind max clients (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338848"></a>
     6577
     6578winbind max clients (G)
     6579</h3></div></div></div><a class="indexterm" name="id338849"></a><a name="WINBINDMAXCLIENTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the maximum number of clients
     6580        the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon can connect with.
     6581        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind max clients</code></em> = <code class="literal">200</code>
     6582</em></span>
     6583</p></dd></dl></div></div><div class="section" title="winbind max domain connections (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338897"></a>
     6584
     6585winbind max domain connections (G)
     6586</h3></div></div></div><a class="indexterm" name="id338898"></a><a name="WINBINDMAXDOMAINCONNECTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the maximum number of simultaneous
     6587        connections that the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon should open to the
     6588        domain controller of one domain.
     6589        Setting this parameter to a value greater than 1 can improve
     6590        scalability with many simultaneous winbind requests,
     6591        some of which might be slow.
     6592        </p><p>
     6593        Note that if <a class="link" href="smb.conf.5.html#WINBINDOFFLINELOGON" target="_top">winbind offline logon</a> is set to
     6594        <code class="constant">Yes</code>, then only one
     6595        DC connection is allowed per domain, regardless of this setting.
     6596        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind max domain connections</code></em> = <code class="literal">1</code>
     6597</em></span>
     6598</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind max domain connections</code></em> = <code class="literal">10</code>
     6599</em></span>
     6600</p></dd></dl></div></div><div class="section" title="winbind nested groups (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338983"></a>
    64476601
    64486602winbind nested groups (G)
    6449 </h3></div></div></div><a class="indexterm" name="id338320"></a><a name="WINBINDNESTEDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to yes, this parameter activates the support for nested
     6603</h3></div></div></div><a class="indexterm" name="id338984"></a><a name="WINBINDNESTEDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to yes, this parameter activates the support for nested
    64506604                 groups. Nested groups are also called local groups or
    64516605                 aliases. They work like their counterparts in Windows: Nested
    … …  
    64556609                 groups, you need to run nss_winbind.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind nested groups</code></em> = <code class="literal">yes</code>
    64566610</em></span>
    6457 </p></dd></dl></div></div><div class="section" title="winbind normalize names (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338364"></a>
     6611</p></dd></dl></div></div><div class="section" title="winbind normalize names (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id339032"></a>
    64586612
    64596613winbind normalize names (G)
    6460 </h3></div></div></div><a class="indexterm" name="id338365"></a><a name="WINBINDNORMALIZENAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether winbindd will replace
     6614</h3></div></div></div><a class="indexterm" name="id339033"></a><a name="WINBINDNORMALIZENAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether winbindd will replace
    64616615          whitespace in user and group names with an underscore (_) character.
    64626616          For example, whether the name "Space Kadet" should be
    … …  
    64786632</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind normalize names</code></em> = <code class="literal">yes</code>
    64796633</em></span>
    6480 </p></dd></dl></div></div><div class="section" title="winbind nss info (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338433"></a>
     6634</p></dd></dl></div></div><div class="section" title="winbind nss info (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id339101"></a>
    64816635
    64826636winbind nss info (G)
    6483 </h3></div></div></div><a class="indexterm" name="id338434"></a><a name="WINBINDNSSINFO"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control how Winbind retrieves Name
     6637</h3></div></div></div><a class="indexterm" name="id339102"></a><a name="WINBINDNSSINFO"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control how Winbind retrieves Name
    64846638        Service Information to construct a user's home directory and login shell.
    64856639        Currently the following settings are available:
    … …  
    65026656</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind nss info</code></em> = <code class="literal">sfu</code>
    65036657</em></span>
    6504 </p></dd></dl></div></div><div class="section" title="winbind offline logon (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338540"></a>
     6658</p></dd></dl></div></div><div class="section" title="winbind offline logon (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id339208"></a>
    65056659
    65066660winbind offline logon (G)
    6507 </h3></div></div></div><a class="indexterm" name="id338541"></a><a name="WINBINDOFFLINELOGON"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control whether Winbind should
     6661</h3></div></div></div><a class="indexterm" name="id339209"></a><a name="WINBINDOFFLINELOGON"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control whether Winbind should
    65086662        allow to login with the <em class="parameter"><code>pam_winbind</code></em>
    65096663        module using Cached Credentials. If enabled, winbindd will store user credentials
    … …  
    65136667</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind offline logon</code></em> = <code class="literal">true</code>
    65146668</em></span>
    6515 </p></dd></dl></div></div><div class="section" title="winbind reconnect delay (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338605"></a>
     6669</p></dd></dl></div></div><div class="section" title="winbind reconnect delay (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id339274"></a>
    65166670
    65176671winbind reconnect delay (G)
    6518 </h3></div></div></div><a class="indexterm" name="id338606"></a><a name="WINBINDRECONNECTDELAY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of
     6672</h3></div></div></div><a class="indexterm" name="id339275"></a><a name="WINBINDRECONNECTDELAY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of
    65196673        seconds the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon will wait between
    65206674        attempts to contact a Domain controller for a domain that is
    65216675        determined to be down or not contactable.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind reconnect delay</code></em> = <code class="literal">30</code>
    65226676</em></span>
    6523 </p></dd></dl></div></div><div class="section" title="winbind refresh tickets (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338655"></a>
     6677</p></dd></dl></div></div><div class="section" title="winbind refresh tickets (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id339324"></a>
    65246678
    65256679winbind refresh tickets (G)
    6526 </h3></div></div></div><a class="indexterm" name="id338656"></a><a name="WINBINDREFRESHTICKETS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control whether Winbind should refresh Kerberos Tickets
     6680</h3></div></div></div><a class="indexterm" name="id339325"></a><a name="WINBINDREFRESHTICKETS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control whether Winbind should refresh Kerberos Tickets
    65276681        retrieved using the <em class="parameter"><code>pam_winbind</code></em> module.
    65286682
    … …  
    65316685</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind refresh tickets</code></em> = <code class="literal">true</code>
    65326686</em></span>
    6533 </p></dd></dl></div></div><div class="section" title="winbind rpc only (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338721"></a>
     6687</p></dd></dl></div></div><div class="section" title="winbind rpc only (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id339389"></a>
    65346688
    65356689winbind rpc only (G)
    6536 </h3></div></div></div><a class="indexterm" name="id338722"></a><a name="WINBINDRPCONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6690</h3></div></div></div><a class="indexterm" name="id339390"></a><a name="WINBINDRPCONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    65376691        Setting this parameter to <code class="literal">yes</code> forces
    65386692        winbindd to use RPC instead of LDAP to retrieve information from Domain
    … …  
    65406694        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind rpc only</code></em> = <code class="literal">no</code>
    65416695</em></span>
    6542 </p></dd></dl></div></div><div class="section" title="winbind separator (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338768"></a>
     6696</p></dd></dl></div></div><div class="section" title="winbind separator (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id339436"></a>
    65436697
    65446698winbind separator (G)
    6545 </h3></div></div></div><a class="indexterm" name="id338769"></a><a name="WINBINDSEPARATOR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows an admin to define the character
     6699</h3></div></div></div><a class="indexterm" name="id339437"></a><a name="WINBINDSEPARATOR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows an admin to define the character
    65466700        used when listing a username of the form of <em class="replaceable"><code>DOMAIN
    65476701        </code></em>\<em class="replaceable"><code>user</code></em>.  This parameter
    … …  
    65546708</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind separator</code></em> = <code class="literal">+</code>
    65556709</em></span>
    6556 </p></dd></dl></div></div><div class="section" title="winbind trusted domains only (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338850"></a>
     6710</p></dd></dl></div></div><div class="section" title="winbind trusted domains only (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id339519"></a>
    65576711
    65586712winbind trusted domains only (G)
    6559 </h3></div></div></div><a class="indexterm" name="id338851"></a><a name="WINBINDTRUSTEDDOMAINSONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6713</h3></div></div></div><a class="indexterm" name="id339520"></a><a name="WINBINDTRUSTEDDOMAINSONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    65606714        This parameter is designed to allow Samba servers that are members
    65616715        of a Samba controlled domain to use UNIX accounts distributed via NIS,
    … …  
    65686722        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind trusted domains only</code></em> = <code class="literal">no</code>
    65696723</em></span>
    6570 </p></dd></dl></div></div><div class="section" title="winbind use default domain (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338912"></a>
     6724</p></dd></dl></div></div><div class="section" title="winbind use default domain (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id339580"></a>
    65716725
    65726726winbind use default domain (G)
    6573 </h3></div></div></div><a class="indexterm" name="id338913"></a><a name="WINBINDUSEDEFAULTDOMAIN"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether the
     6727</h3></div></div></div><a class="indexterm" name="id339582"></a><a name="WINBINDUSEDEFAULTDOMAIN"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether the
    65746728         <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon should operate on users 
    65756729        without domain component in their username. Users without a domain
    65766730        component are treated as is part of the winbindd server's own
    6577         domain. While this does not benifit Windows users, it makes SSH, FTP and
     6731        domain. While this does not benefit Windows users, it makes SSH, FTP and
    65786732        e-mail function in a way much closer to the way they
    6579         would in a native unix system.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind use default domain</code></em> = <code class="literal">no</code>
     6733        would in a native unix system.</p><p>This option should be avoided if possible. It can cause confusion
     6734        about responsibilities for a user or group. In many situations it is
     6735        not clear whether winbind or /etc/passwd should be seen as authoritative
     6736        for a user, likewise for groups.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind use default domain</code></em> = <code class="literal">no</code>
    65806737</em></span>
    65816738</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind use default domain</code></em> = <code class="literal">yes</code>
    65826739</em></span>
    6583 </p></dd></dl></div></div><div class="section" title="wins hook (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id338981"></a>
     6740</p></dd></dl></div></div><div class="section" title="wins hook (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id339655"></a>
    65846741
    65856742wins hook (G)
    6586 </h3></div></div></div><a class="indexterm" name="id338982"></a><a name="WINSHOOK"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba is running as a WINS server this
     6743</h3></div></div></div><a class="indexterm" name="id339656"></a><a name="WINSHOOK"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba is running as a WINS server this
    65876744        allows you to call an external program for all changes to the
    65886745        WINS database. The primary use for this option is to allow the
    … …  
    66056762                        empty then the name should be deleted.</p></li></ul></div><p>An example script that calls the BIND dynamic DNS update
    66066763        program <code class="literal">nsupdate</code> is provided in the examples
    6607         directory of the Samba source code. </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="wins proxy (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id339076"></a>
     6764        directory of the Samba source code. </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="wins proxy (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id339749"></a>
    66086765
    66096766wins proxy (G)
    6610 </h3></div></div></div><a class="indexterm" name="id339077"></a><a name="WINSPROXY"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean that controls if <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> will respond to broadcast name
     6767</h3></div></div></div><a class="indexterm" name="id339750"></a><a name="WINSPROXY"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean that controls if <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> will respond to broadcast name
    66116768        queries on behalf of  other hosts. You may need to set this
    66126769        to <code class="constant">yes</code> for some older clients.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>wins proxy</code></em> = <code class="literal">no</code>
    66136770</em></span>
    6614 </p></dd></dl></div></div><div class="section" title="wins server (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id339129"></a>
     6771</p></dd></dl></div></div><div class="section" title="wins server (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id339803"></a>
    66156772
    66166773wins server (G)
    6617 </h3></div></div></div><a class="indexterm" name="id339130"></a><a name="WINSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the IP address (or DNS name: IP
     6774</h3></div></div></div><a class="indexterm" name="id339804"></a><a name="WINSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the IP address (or DNS name: IP
    66186775        address for preference) of the WINS server that <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> should register with. If you have a WINS server on
    66196776        your network then you should set this to the WINS server's IP.</p><p>You should point this at your WINS server if you have a
    … …  
    66346791</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>wins server</code></em> = <code class="literal">192.9.200.1 192.168.2.61</code>
    66356792</em></span>
    6636 </p></dd></dl></div></div><div class="section" title="wins support (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id339232"></a>
     6793</p></dd></dl></div></div><div class="section" title="wins support (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id339905"></a>
    66376794
    66386795wins support (G)
    6639 </h3></div></div></div><a class="indexterm" name="id339233"></a><a name="WINSSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean controls if the <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> process in Samba will act as a WINS server. You should
     6796</h3></div></div></div><a class="indexterm" name="id339906"></a><a name="WINSSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean controls if the <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> process in Samba will act as a WINS server. You should
    66406797        not set this to <code class="constant">yes</code> unless you have a multi-subnetted network and
    66416798        you wish a particular <code class="literal">nmbd</code> to be your WINS server.
    … …  
    66436800        on more than one machine in your network.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>wins support</code></em> = <code class="literal">no</code>
    66446801</em></span>
    6645 </p></dd></dl></div></div><div class="section" title="workgroup (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id339298"></a>
     6802</p></dd></dl></div></div><div class="section" title="workgroup (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id339972"></a>
    66466803
    66476804workgroup (G)
    6648 </h3></div></div></div><a class="indexterm" name="id339299"></a><a name="WORKGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what workgroup your server will
     6805</h3></div></div></div><a class="indexterm" name="id339973"></a><a name="WORKGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what workgroup your server will
    66496806        appear to be in when queried by clients. Note that this parameter
    66506807        also controls the Domain name used with
    … …  
    66546811</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>workgroup</code></em> = <code class="literal">MYGROUP</code>
    66556812</em></span>
    6656 </p></dd></dl></div></div><div class="section" title="writable"><div class="titlepage"><div><div><h3 class="title"><a name="id339369"></a>
     6813</p></dd></dl></div></div><div class="section" title="writable"><div class="titlepage"><div><div><h3 class="title"><a name="id340043"></a>
    66576814
    66586815<a name="WRITABLE"></a>writable
    6659 </h3></div></div></div><a class="indexterm" name="id339370"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#WRITEABLE">writeable</a>.</p></dd></dl></div></div><div class="section" title="writeable (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id339400"></a>
     6816</h3></div></div></div><a class="indexterm" name="id340044"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#WRITEABLE">writeable</a>.</p></dd></dl></div></div><div class="section" title="writeable (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id340074"></a>
    66606817
    66616818writeable (S)
    6662 </h3></div></div></div><a class="indexterm" name="id339401"></a><a name="WRITEABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>Inverted synonym for <a class="link" href="smb.conf.5.html#READONLY" target="_top">read only</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>writeable</code></em> = <code class="literal">no</code>
    6663 </em></span>
    6664 </p></dd></dl></div></div><div class="section" title="write cache size (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id339451"></a>
     6819</h3></div></div></div><a class="indexterm" name="id340075"></a><a name="WRITEABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>Inverted synonym for <a class="link" href="smb.conf.5.html#READONLY" target="_top">read only</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>writeable</code></em> = <code class="literal">no</code>
     6820</em></span>
     6821</p></dd></dl></div></div><div class="section" title="write cache size (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id340125"></a>
    66656822
    66666823write cache size (S)
    6667 </h3></div></div></div><a class="indexterm" name="id339452"></a><a name="WRITECACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this integer parameter is set to non-zero value,
     6824</h3></div></div></div><a class="indexterm" name="id340126"></a><a name="WRITECACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this integer parameter is set to non-zero value,
    66686825    Samba will create an in-memory cache for each oplocked file
    66696826    (it does <span class="emphasis"><em>not</em></span> do this for
    … …  
    66836840#  for a 256k cache size per file</code>
    66846841</em></span>
    6685 </p></dd></dl></div></div><div class="section" title="write list (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id339525"></a>
     6842</p></dd></dl></div></div><div class="section" title="write list (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id340199"></a>
    66866843
    66876844write list (S)
    6688 </h3></div></div></div><a class="indexterm" name="id339526"></a><a name="WRITELIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6845</h3></div></div></div><a class="indexterm" name="id340200"></a><a name="WRITELIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
    66896846    This is a list of users that are given read-write access to a service. If the
    66906847    connecting user is in this list then they will be given write access, no matter
    … …  
    67016858</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>write list</code></em> = <code class="literal">admin, root, @staff</code>
    67026859</em></span>
    6703 </p></dd></dl></div></div><div class="section" title="write raw (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id339614"></a>
     6860</p></dd></dl></div></div><div class="section" title="write raw (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id340287"></a>
    67046861
    67056862write raw (G)
    6706 </h3></div></div></div><a class="indexterm" name="id339615"></a><a name="WRITERAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
     6863</h3></div></div></div><a class="indexterm" name="id340288"></a><a name="WRITERAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
    67076864    will support raw write SMB's when transferring data from clients.
    67086865    You should never need to change this parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>write raw</code></em> = <code class="literal">yes</code>
    67096866</em></span>
    6710 </p></dd></dl></div></div><div class="section" title="wtmp directory (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id339656"></a>
     6867</p></dd></dl></div></div><div class="section" title="wtmp directory (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id340330"></a>
    67116868
    67126869wtmp directory (G)
    6713 </h3></div></div></div><a class="indexterm" name="id339657"></a><a name="WTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6870</h3></div></div></div><a class="indexterm" name="id340331"></a><a name="WTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    67146871        This parameter is only available if Samba has been configured and compiled with the option <code class="literal">
    67156872        --with-utmp</code>. It specifies a directory pathname that is used to store the wtmp or wtmpx files (depending on
    … …  
    67236880</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>wtmp directory</code></em> = <code class="literal">/var/log/wtmp</code>
    67246881</em></span>
    6725 </p></dd></dl></div></div></div></div><div class="refsect1" title="WARNINGS"><a name="id339734"></a><h2>WARNINGS</h2><p>
     6882</p></dd></dl></div></div></div></div><div class="refsect1" title="WARNINGS"><a name="id340408"></a><h2>WARNINGS</h2><p>
    67266883        Although the configuration file permits service names to contain spaces, your client software may not.
    67276884        Spaces will be ignored in comparisons anyway, so it shouldn't be a problem - but be aware of the possibility.
    … …  
    67366893        care when designing these sections. In particular, ensure that the permissions on spool directories are
    67376894        correct.
    6738         </p></div><div class="refsect1" title="VERSION"><a name="id339777"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id339788"></a><h2>SEE ALSO</h2><p>
    6739         <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>, <a class="citerefentry" href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a>, <a class="citerefentry" href="swat.8.html"><span class="citerefentry"><span class="refentrytitle">swat</span>(8)</span></a>, <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>, <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>, <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>, <a class="citerefentry" href="nmblookup.1.html"><span class="citerefentry"><span class="refentrytitle">nmblookup</span>(1)</span></a>, <a class="citerefentry" href="testparm.1.html"><span class="citerefentry"><span class="refentrytitle">testparm</span>(1)</span></a>, <a class="citerefentry" href="testprns.1.html"><span class="citerefentry"><span class="refentrytitle">testprns</span>(1)</span></a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id339866"></a><h2>AUTHOR</h2><p>
     6895        </p></div><div class="refsect1" title="VERSION"><a name="id340451"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id340462"></a><h2>SEE ALSO</h2><p>
     6896        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>, <a class="citerefentry" href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a>, <a class="citerefentry" href="swat.8.html"><span class="citerefentry"><span class="refentrytitle">swat</span>(8)</span></a>, <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>, <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>, <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>, <a class="citerefentry" href="nmblookup.1.html"><span class="citerefentry"><span class="refentrytitle">nmblookup</span>(1)</span></a>, <a class="citerefentry" href="testparm.1.html"><span class="citerefentry"><span class="refentrytitle">testparm</span>(1)</span></a>, <a class="citerefentry" href="testprns.1.html"><span class="citerefentry"><span class="refentrytitle">testprns</span>(1)</span></a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id340541"></a><h2>AUTHOR</h2><p>
    67406897        The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed
    67416898        by the Samba Team as an Open Source project similar to the way the Linux kernel is developed.

  • trunk/server/docs/htmldocs/manpages/smbcacls.1.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbcacls</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbcacls"><a name="smbcacls.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbcacls &#8212; Set or get ACLs on an NT file or directory names</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbcacls</code> {//server/share} {filename} [-D acls] [-M acls] [-a acls] [-S acls] [-C name] [-G name] [--numeric] [-t] [-U username] [-h] [-d]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266897"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">smbcacls</code> program manipulates NT Access Control
    2         Lists (ACLs) on SMB file shares. </p></div><div class="refsect1" title="OPTIONS"><a name="id265721"></a><h2>OPTIONS</h2><p>The following options are available to the <code class="literal">smbcacls</code> program. 
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbcacls</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbcacls"><a name="smbcacls.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbcacls &#8212; Set or get ACLs on an NT file or directory names</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbcacls</code> {//server/share} {filename} [-D|--delete acls] [-M|--modify acls] [-a|--add acls] [-S|--set acls] [-C|--chown name] [-G|--chgrp name] [-I allow|romove|copy] [--numeric] [-t] [-U username] [-h] [-d]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id265699"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">smbcacls</code> program manipulates NT Access Control
     2        Lists (ACLs) on SMB file shares. </p></div><div class="refsect1" title="OPTIONS"><a name="id265727"></a><h2>OPTIONS</h2><p>The following options are available to the <code class="literal">smbcacls</code> program. 
    33        The format of ACLs is described in the section ACL FORMAT </p><div class="variablelist"><dl><dt><span class="term">-a|--add acls</span></dt><dd><p>Add the ACLs specified to the ACL list.  Existing
    44                access control entries are unchanged. </p></dd><dt><span class="term">-M|--modify acls</span></dt><dd><p>Modify the mask value (permissions) for the ACLs
    … …  
    1818                option.  The name can be a sid in the form S-1-x-y-z or a name
    1919                resolved against the server specified n the first argument.
    20                 </p><p>This command is a shortcut for -M GROUP:name.</p></dd><dt><span class="term">--numeric</span></dt><dd><p>This option displays all ACL information in numeric
     20                </p><p>This command is a shortcut for -M GROUP:name.</p></dd><dt><span class="term">-I|--inherit allow|remove|copy</span></dt><dd><p>Set or unset the windows "Allow inheritable
     21                permissions" check box using the <em class="parameter"><code>-I</code></em>
     22                option.  To set the check box pass allow. To unset the check
     23                box pass either remove or copy. Remove will remove all
     24                inherited acls. Copy will copy all the inherited acls.
     25                </p></dd><dt><span class="term">--numeric</span></dt><dd><p>This option displays all ACL information in numeric
    2126                format.  The default is to convert SIDs to names and ACE types
    2227                and masks to a readable string format.  </p></dd><dt><span class="term">-t|--test-args</span></dt><dd><p>
    … …  
    8186via the <code class="literal">ps</code> command.  To be safe always allow
    8287<code class="literal">rpcclient</code> to prompt for a password and type
    83 it in directly. </p></dd></dl></div></div><div class="refsect1" title="ACL FORMAT"><a name="id307238"></a><h2>ACL FORMAT</h2><p>The format of an ACL is one or more ACL entries separated by
     88it in directly. </p></dd></dl></div></div><div class="refsect1" title="ACL FORMAT"><a name="id307265"></a><h2>ACL FORMAT</h2><p>The format of an ACL is one or more ACL entries separated by
    8489        either commas or newlines.  An ACL entry is one of the following: </p><pre class="programlisting">
    8590REVISION:&lt;revision number&gt;
    … …  
    106111                permissions</p></li><li class="listitem"><p><span class="emphasis"><em>CHANGE</em></span> - Equivalent to 'RXWD' permissions
    107112                </p></li><li class="listitem"><p><span class="emphasis"><em>FULL</em></span> - Equivalent to 'RWXDPO'
    108                 permissions</p></li></ul></div></div><div class="refsect1" title="EXIT STATUS"><a name="id307378"></a><h2>EXIT STATUS</h2><p>The <code class="literal">smbcacls</code> program sets the exit status
     113                permissions</p></li></ul></div></div><div class="refsect1" title="EXIT STATUS"><a name="id307406"></a><h2>EXIT STATUS</h2><p>The <code class="literal">smbcacls</code> program sets the exit status
    109114        depending on the success or otherwise of the operations performed. 
    110115        The exit status may be one of the following values. </p><p>If the operation succeeded, smbcacls returns and exit
    … …  
    112117        or there was an error getting or setting the ACLs, an exit status
    113118        of 1 is returned.  If there was an error parsing any command line
    114         arguments, an exit status of 2 is returned. </p></div><div class="refsect1" title="VERSION"><a name="id307406"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id307416"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     119        arguments, an exit status of 2 is returned. </p></div><div class="refsect1" title="VERSION"><a name="id307433"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id307443"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    115120        were created by Andrew Tridgell. Samba is now developed
    116121        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/smbclient.1.html

    r599 r745  
    11<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbclient</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbclient"><a name="smbclient.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbclient &#8212; ftp-like client to access SMB/CIFS resources
    2         on servers</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbclient</code> [-b &lt;buffer size&gt;] [-d debuglevel] [-e] [-L &lt;netbios name&gt;] [-U username] [-I destinationIP] [-M &lt;netbios name&gt;] [-m maxprotocol] [-A authfile] [-N] [-C] [-g] [-i scope] [-O &lt;socket options&gt;] [-p port] [-R &lt;name resolve order&gt;] [-s &lt;smb config file&gt;] [-k] [-P] [-c &lt;command&gt;]</p></div><div class="cmdsynopsis"><p><code class="literal">smbclient</code> {servicename} [password] [-b &lt;buffer size&gt;] [-d debuglevel] [-e] [-D Directory] [-U username] [-W workgroup] [-M &lt;netbios name&gt;] [-m maxprotocol] [-A authfile] [-N] [-C] [-g] [-l log-basename] [-I destinationIP] [-E] [-c &lt;command string&gt;] [-i scope] [-O &lt;socket options&gt;] [-p port] [-R &lt;name resolve order&gt;] [-s &lt;smb config file&gt;] [-T&lt;c|x&gt;IXFqgbNan] [-k]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id265953"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbclient</code> is a client that can
     2        on servers</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbclient</code> [-b &lt;buffer size&gt;] [-d debuglevel] [-e] [-L &lt;netbios name&gt;] [-U username] [-I destinationIP] [-M &lt;netbios name&gt;] [-m maxprotocol] [-A authfile] [-N] [-C] [-g] [-i scope] [-O &lt;socket options&gt;] [-p port] [-R &lt;name resolve order&gt;] [-s &lt;smb config file&gt;] [-k] [-P] [-c &lt;command&gt;]</p></div><div class="cmdsynopsis"><p><code class="literal">smbclient</code> {servicename} [password] [-b &lt;buffer size&gt;] [-d debuglevel] [-e] [-D Directory] [-U username] [-W workgroup] [-M &lt;netbios name&gt;] [-m maxprotocol] [-A authfile] [-N] [-C] [-g] [-l log-basename] [-I destinationIP] [-E] [-c &lt;command string&gt;] [-i scope] [-O &lt;socket options&gt;] [-p port] [-R &lt;name resolve order&gt;] [-s &lt;smb config file&gt;] [-T&lt;c|x&gt;IXFqgbNan] [-k]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id265951"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbclient</code> is a client that can
    33        'talk' to an SMB/CIFS server. It offers an interface
    44        similar to that of the ftp program (see <a class="citerefentry" href="ftp.1.html"><span class="citerefentry"><span class="refentrytitle">ftp</span>(1)</span></a>). 
    … …  
    66        to the local machine, putting files from the local machine to
    77        the server, retrieving directory information from the server
    8         and so on. </p></div><div class="refsect1" title="OPTIONS"><a name="id307046"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">servicename</span></dt><dd><p>servicename is the name of the service
     8        and so on. </p></div><div class="refsect1" title="OPTIONS"><a name="id307044"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">servicename</span></dt><dd><p>servicename is the name of the service
    99                you want to use on the server. A service name takes the form
    1010                <code class="filename">//server/service</code> where <em class="parameter"><code>server
    … …  
    9090                with utilities such as grep and cut.
    9191                </p></dd><dt><span class="term">-m|--max-protocol protocol</span></dt><dd><p>This parameter sets the maximum protocol version announced by the client.
    92                 </p></dd><dt><span class="term">-P</span></dt><dd><p>
     92                </p></dd><dt><span class="term">-P|--machine-pass</span></dt><dd><p>
    9393                Make queries to the external server using the machine account of the local server.
    9494                </p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    … …  
    114114                is 65520 bytes. Setting this value smaller (to 1200 bytes) has been
    115115                observed to speed up file transfers to and from a Win9x server.
    116                 </p></dd><dt><span class="term">-e</span></dt><dd><p>This command line parameter requires the remote
     116                </p></dd><dt><span class="term">-e|--encrypt</span></dt><dd><p>This command line parameter requires the remote
    117117                server support the UNIX extensions. Request that the connection be
    118118                encrypted. This is new for Samba 3.2 and will only work with Samba
    … …  
    262262                the share. </p><p><code class="literal">smbclient //mypc/myshare "" -N -Tc backup.tar *
    263263                </code></p></dd><dt><span class="term">-D|--directory initial directory</span></dt><dd><p>Change to initial directory before starting. Probably
    264                 only of any use with the tar -T option. </p></dd><dt><span class="term">-c|--comand command string</span></dt><dd><p>command string is a semicolon-separated list of
     264                only of any use with the tar -T option. </p></dd><dt><span class="term">-c|--command command string</span></dt><dd><p>command string is a semicolon-separated list of
    265265                commands to be executed instead of prompting from stdin. <em class="parameter"><code>
    266266                -N</code></em> is implied by <em class="parameter"><code>-c</code></em>.</p><p>This is particularly useful in scripts and for printing stdin

  • trunk/server/docs/htmldocs/manpages/smbcontrol.1.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbcontrol</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbcontrol"><a name="smbcontrol.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbcontrol &#8212; send messages to smbd, nmbd or winbindd processes</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbcontrol</code> [-i] [-s]</p></div><div class="cmdsynopsis"><p><code class="literal">smbcontrol</code> [destination] [message-type] [parameter]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266845"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbcontrol</code> is a very small program, which
    2         sends messages to a <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>, a <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>, or a <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon running on the system.</p></div><div class="refsect1" title="OPTIONS"><a name="id266896"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbcontrol</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbcontrol"><a name="smbcontrol.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbcontrol &#8212; send messages to smbd, nmbd or winbindd processes</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbcontrol</code> [-i] [-s]</p></div><div class="cmdsynopsis"><p><code class="literal">smbcontrol</code> [destination] [message-type] [parameter]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266844"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbcontrol</code> is a very small program, which
     2        sends messages to a <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>, a <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>, or a <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon running on the system.</p></div><div class="refsect1" title="OPTIONS"><a name="id266895"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    33</p></dd><dt><span class="term">-s|--configfile &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the
    44configuration details required by the server.  The
    … …  
    6969        sent to smbd.</p></dd><dt><span class="term">reload-config</span></dt><dd><p>Force daemon to reload smb.conf configuration file. Can be sent
    7070        to <code class="constant">smbd</code>, <code class="constant">nmbd</code>, or <code class="constant">winbindd</code>.
    71         </p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id307226"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    72         the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id307235"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> and <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id307259"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     71        </p></dd><dt><span class="term">idmap</span></dt><dd><p>Notify about changes of id mapping. Can be sent
     72        to <code class="constant">smbd</code> or (not implemented yet) <code class="constant">winbindd</code>.
     73        </p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id307287"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     74        the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id307296"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> and <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id307320"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    7375        were created by Andrew Tridgell. Samba is now developed
    7476        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/smbcquotas.1.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbcquotas</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbcquotas"><a name="smbcquotas.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbcquotas &#8212; Set or get QUOTAs of NTFS 5 shares</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbcquotas</code> {//server/share} [-u user] [-L] [-F] [-S QUOTA_SET_COMMAND] [-n] [-t] [-v] [-d debuglevel] [-s configfile] [-l logdir] [-V] [-U username] [-N] [-k] [-A]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id265714"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">smbcquotas</code> program manipulates NT Quotas on SMB file shares. </p></div><div class="refsect1" title="OPTIONS"><a name="id265741"></a><h2>OPTIONS</h2><p>The following options are available to the <code class="literal">smbcquotas</code> program. </p><div class="variablelist"><dl><dt><span class="term">-u user</span></dt><dd><p> Specifies the user of whom the quotas are get or set.
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbcquotas</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbcquotas"><a name="smbcquotas.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbcquotas &#8212; Set or get QUOTAs of NTFS 5 shares</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbcquotas</code> {//server/share} [-u user] [-L] [-F] [-S QUOTA_SET_COMMAND] [-n] [-t] [-v] [-d debuglevel] [-s configfile] [-l logdir] [-V] [-U username] [-N] [-k] [-A]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id265715"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">smbcquotas</code> program manipulates NT Quotas on SMB file shares. </p></div><div class="refsect1" title="OPTIONS"><a name="id265742"></a><h2>OPTIONS</h2><p>The following options are available to the <code class="literal">smbcquotas</code> program. </p><div class="variablelist"><dl><dt><span class="term">-u user</span></dt><dd><p> Specifies the user of whom the quotas are get or set.
    22                By default the current user's username will be used.</p></dd><dt><span class="term">-L</span></dt><dd><p>Lists all quota records of the share.</p></dd><dt><span class="term">-F</span></dt><dd><p>Show the share quota status and default limits.</p></dd><dt><span class="term">-S QUOTA_SET_COMMAND</span></dt><dd><p>This command sets/modifies quotas for a user or on the share,
    33                depending on the QUOTA_SET_COMMAND parameter which is described later.</p></dd><dt><span class="term">-n</span></dt><dd><p>This option displays all QUOTA information in numeric

  • trunk/server/docs/htmldocs/manpages/smbd.8.html

    r599 r745  
    2222        the configuration file will not affect connections to any service
    2323        that is already established.  Either the user will have to
    24         disconnect from the service, or <code class="literal">smbd</code> killed and restarted.</p></div><div class="refsect1" title="OPTIONS"><a name="id265772"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-D</span></dt><dd><p>If specified, this parameter causes
     24        disconnect from the service, or <code class="literal">smbd</code> killed and restarted.</p></div><div class="refsect1" title="OPTIONS"><a name="id265771"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-D</span></dt><dd><p>If specified, this parameter causes
    2525                the server to operate as a daemon. That is, it detaches
    2626                itself and runs in the background, fielding requests
    … …  
    8383                0 turns off profiling, 1 turns on counter profiling only,
    8484                2 turns on complete profiling, and 3 resets all profiling data.
    85                 </p></dd></dl></div></div><div class="refsect1" title="FILES"><a name="id307209"></a><h2>FILES</h2><div class="variablelist"><dl><dt><span class="term"><code class="filename">/etc/inetd.conf</code></span></dt><dd><p>If the server is to be run by the
     85                </p></dd></dl></div></div><div class="refsect1" title="FILES"><a name="id307208"></a><h2>FILES</h2><div class="variablelist"><dl><dt><span class="term"><code class="filename">/etc/inetd.conf</code></span></dt><dd><p>If the server is to be run by the
    8686                <code class="literal">inetd</code> meta-daemon, this file
    8787                must contain suitable startup information for the
    … …  
    9797                install this file are <code class="filename">/usr/samba/lib/smb.conf</code>
    9898                and <code class="filename">/etc/samba/smb.conf</code>.</p><p>This file describes all the services the server
    99                 is to make available to clients. See <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> for more information.</p></dd></dl></div></div><div class="refsect1" title="LIMITATIONS"><a name="id307321"></a><h2>LIMITATIONS</h2><p>On some systems <code class="literal">smbd</code> cannot change uid back
     99                is to make available to clients. See <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> for more information.</p></dd></dl></div></div><div class="refsect1" title="LIMITATIONS"><a name="id307320"></a><h2>LIMITATIONS</h2><p>On some systems <code class="literal">smbd</code> cannot change uid back
    100100        to root after a setuid() call.  Such systems are called
    101101        trapdoor uid systems. If you have such a system,
    … …  
    103103        two different users at once. Attempts to connect the
    104104        second user will result in access denied or
    105         similar.</p></div><div class="refsect1" title="ENVIRONMENT VARIABLES"><a name="id307339"></a><h2>ENVIRONMENT VARIABLES</h2><div class="variablelist"><dl><dt><span class="term"><code class="envar">PRINTER</code></span></dt><dd><p>If no printer name is specified to
     105        similar.</p></div><div class="refsect1" title="ENVIRONMENT VARIABLES"><a name="id307338"></a><h2>ENVIRONMENT VARIABLES</h2><div class="variablelist"><dl><dt><span class="term"><code class="envar">PRINTER</code></span></dt><dd><p>If no printer name is specified to
    106106                printable services, most systems will use the value of
    107107                this variable (or <code class="constant">lp</code> if this variable is
    108108                not defined) as the name of the printer to use. This
    109                 is not specific to the server, however.</p></dd></dl></div></div><div class="refsect1" title="PAM INTERACTION"><a name="id307365"></a><h2>PAM INTERACTION</h2><p>Samba uses PAM for authentication (when presented with a plaintext
     109                is not specific to the server, however.</p></dd></dl></div></div><div class="refsect1" title="PAM INTERACTION"><a name="id307364"></a><h2>PAM INTERACTION</h2><p>Samba uses PAM for authentication (when presented with a plaintext
    110110        password), for account checking (is this account disabled?) and for
    111111        session management.  The degree too which samba supports PAM is restricted
    … …  
    120120        Note also that some older pam configuration files may need a line
    121121        added for session support.
    122         </p></li></ul></div></div><div class="refsect1" title="VERSION"><a name="id307413"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    123         the Samba suite.</p></div><div class="refsect1" title="DIAGNOSTICS"><a name="id307422"></a><h2>DIAGNOSTICS</h2><p>Most diagnostics issued by the server are logged
     122        </p></li></ul></div></div><div class="refsect1" title="VERSION"><a name="id307412"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     123        the Samba suite.</p></div><div class="refsect1" title="DIAGNOSTICS"><a name="id307421"></a><h2>DIAGNOSTICS</h2><p>Most diagnostics issued by the server are logged
    124124        in a specified log file. The log file name is specified
    125125        at compile time, but may be overridden on the command line.</p><p>The number and nature of diagnostics available depends
    … …  
    130130        diagnostic. At this stage your best bet is still to grep the
    131131        source code and inspect the conditions that gave rise to the
    132         diagnostics you are seeing.</p></div><div class="refsect1" title="TDB FILES"><a name="id307445"></a><h2>TDB FILES</h2><p>Samba stores it's data in several TDB (Trivial Database) files, usually located in <code class="filename">/var/lib/samba</code>.</p><p>
     132        diagnostics you are seeing.</p></div><div class="refsect1" title="TDB FILES"><a name="id307444"></a><h2>TDB FILES</h2><p>Samba stores it's data in several TDB (Trivial Database) files, usually located in <code class="filename">/var/lib/samba</code>.</p><p>
    133133        (*) information persistent across restarts (but not
    134134        necessarily important to backup).
    135         </p><div class="variablelist"><dl><dt><span class="term">account_policy.tdb*</span></dt><dd><p>NT account policy settings such as pw expiration, etc...</p></dd><dt><span class="term">brlock.tdb</span></dt><dd><p>byte range locks</p></dd><dt><span class="term">browse.dat</span></dt><dd><p>browse lists</p></dd><dt><span class="term">connections.tdb</span></dt><dd><p>share connections (used to enforce max connections, etc...)</p></dd><dt><span class="term">gencache.tdb</span></dt><dd><p>generic caching db</p></dd><dt><span class="term">group_mapping.tdb*</span></dt><dd><p>group mapping information</p></dd><dt><span class="term">locking.tdb</span></dt><dd><p>share modes &amp; oplocks</p></dd><dt><span class="term">login_cache.tdb*</span></dt><dd><p>bad pw attempts</p></dd><dt><span class="term">messages.tdb</span></dt><dd><p>Samba messaging system</p></dd><dt><span class="term">netsamlogon_cache.tdb*</span></dt><dd><p>cache of user net_info_3 struct from net_samlogon() request (as a domain member)</p></dd><dt><span class="term">ntdrivers.tdb*</span></dt><dd><p>installed printer drivers</p></dd><dt><span class="term">ntforms.tdb*</span></dt><dd><p>installed printer forms</p></dd><dt><span class="term">ntprinters.tdb*</span></dt><dd><p>installed printer information</p></dd><dt><span class="term">printing/</span></dt><dd><p>directory containing tdb per print queue of cached lpq output</p></dd><dt><span class="term">registry.tdb</span></dt><dd><p>Windows registry skeleton (connect via regedit.exe)</p></dd><dt><span class="term">sessionid.tdb</span></dt><dd><p>session information (e.g. support for 'utmp = yes')</p></dd><dt><span class="term">share_info.tdb*</span></dt><dd><p>share acls</p></dd><dt><span class="term">winbindd_cache.tdb</span></dt><dd><p>winbindd's cache of user lists, etc...</p></dd><dt><span class="term">winbindd_idmap.tdb*</span></dt><dd><p>winbindd's local idmap db</p></dd><dt><span class="term">wins.dat*</span></dt><dd><p>wins database when 'wins support = yes'</p></dd></dl></div></div><div class="refsect1" title="SIGNALS"><a name="id307662"></a><h2>SIGNALS</h2><p>Sending the <code class="literal">smbd</code> a SIGHUP will cause it to
     135        </p><div class="variablelist"><dl><dt><span class="term">account_policy.tdb*</span></dt><dd><p>NT account policy settings such as pw expiration, etc...</p></dd><dt><span class="term">brlock.tdb</span></dt><dd><p>byte range locks</p></dd><dt><span class="term">browse.dat</span></dt><dd><p>browse lists</p></dd><dt><span class="term">connections.tdb</span></dt><dd><p>share connections (used to enforce max connections, etc...)</p></dd><dt><span class="term">gencache.tdb</span></dt><dd><p>generic caching db</p></dd><dt><span class="term">group_mapping.tdb*</span></dt><dd><p>group mapping information</p></dd><dt><span class="term">locking.tdb</span></dt><dd><p>share modes &amp; oplocks</p></dd><dt><span class="term">login_cache.tdb*</span></dt><dd><p>bad pw attempts</p></dd><dt><span class="term">messages.tdb</span></dt><dd><p>Samba messaging system</p></dd><dt><span class="term">netsamlogon_cache.tdb*</span></dt><dd><p>cache of user net_info_3 struct from net_samlogon() request (as a domain member)</p></dd><dt><span class="term">ntdrivers.tdb*</span></dt><dd><p>installed printer drivers</p></dd><dt><span class="term">ntforms.tdb*</span></dt><dd><p>installed printer forms</p></dd><dt><span class="term">ntprinters.tdb*</span></dt><dd><p>installed printer information</p></dd><dt><span class="term">printing/</span></dt><dd><p>directory containing tdb per print queue of cached lpq output</p></dd><dt><span class="term">registry.tdb</span></dt><dd><p>Windows registry skeleton (connect via regedit.exe)</p></dd><dt><span class="term">sessionid.tdb</span></dt><dd><p>session information (e.g. support for 'utmp = yes')</p></dd><dt><span class="term">share_info.tdb*</span></dt><dd><p>share acls</p></dd><dt><span class="term">winbindd_cache.tdb</span></dt><dd><p>winbindd's cache of user lists, etc...</p></dd><dt><span class="term">winbindd_idmap.tdb*</span></dt><dd><p>winbindd's local idmap db</p></dd><dt><span class="term">wins.dat*</span></dt><dd><p>wins database when 'wins support = yes'</p></dd></dl></div></div><div class="refsect1" title="SIGNALS"><a name="id307661"></a><h2>SIGNALS</h2><p>Sending the <code class="literal">smbd</code> a SIGHUP will cause it to
    136136        reload its <code class="filename">smb.conf</code> configuration
    137137        file within a short period of time.</p><p>To shut down a user's <code class="literal">smbd</code> process it is recommended
    … …  
    148148        issuing them. It is possible to make the signal handlers safe
    149149        by un-blocking the signals before the select call and re-blocking
    150         them after, however this would affect performance.</p></div><div class="refsect1" title="SEE ALSO"><a name="id307740"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="hosts_access.5.html"><span class="citerefentry"><span class="refentrytitle">hosts_access</span>(5)</span></a>, <a class="citerefentry" href="inetd.8.html"><span class="citerefentry"><span class="refentrytitle">inetd</span>(8)</span></a>, <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>, <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>, <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>, <a class="citerefentry" href="testparm.1.html"><span class="citerefentry"><span class="refentrytitle">testparm</span>(1)</span></a>, <a class="citerefentry" href="testprns.1.html"><span class="citerefentry"><span class="refentrytitle">testprns</span>(1)</span></a>, and the
     150        them after, however this would affect performance.</p></div><div class="refsect1" title="SEE ALSO"><a name="id307739"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="hosts_access.5.html"><span class="citerefentry"><span class="refentrytitle">hosts_access</span>(5)</span></a>, <a class="citerefentry" href="inetd.8.html"><span class="citerefentry"><span class="refentrytitle">inetd</span>(8)</span></a>, <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>, <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>, <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>, <a class="citerefentry" href="testparm.1.html"><span class="citerefentry"><span class="refentrytitle">testparm</span>(1)</span></a>, <a class="citerefentry" href="testprns.1.html"><span class="citerefentry"><span class="refentrytitle">testprns</span>(1)</span></a>, and the
    151151        Internet RFC's  <code class="filename">rfc1001.txt</code>, <code class="filename">rfc1002.txt</code>.
    152152        In addition the CIFS (formerly SMB) specification is available
    153153        as a link from the Web page <a class="ulink" href="http://samba.org/cifs/" target="_top">
    154         http://samba.org/cifs/</a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id307819"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     154        http://samba.org/cifs/</a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id307818"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    155155        were created by Andrew Tridgell. Samba is now developed
    156156        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/smbget.1.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbget</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbget"><a name="smbget.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbget &#8212; wget-like utility for download files over SMB</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbget</code> [-a, --guest] [-r, --resume] [-R, --recursive] [-u, --username=STRING] [-p, --password=STRING] [-w, --workgroup=STRING] [-n, --nonprompt] [-d, --debuglevel=INT] [-D, --dots] [-P, --keep-permissions] [-o, --outputfile] [-f, --rcfile] [-q, --quiet] [-v, --verbose] [-b, --blocksize] [-O, --stdout] [-?, --help] [--usage] {smb://host/share/path/to/file} [smb://url2/] [...]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id265753"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>smbget is a simple utility with wget-like semantics, that can download files from SMB servers. You can specify the files you would like to download on the command-line.
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbget</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbget"><a name="smbget.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbget &#8212; wget-like utility for download files over SMB</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbget</code> [-a, --guest] [-r, --resume] [-R, --recursive] [-u, --username=STRING] [-p, --password=STRING] [-w, --workgroup=STRING] [-n, --nonprompt] [-d, --debuglevel=INT] [-D, --dots] [-P, --keep-permissions] [-o, --outputfile] [-f, --rcfile] [-q, --quiet] [-v, --verbose] [-b, --blocksize] [-O, --stdout] [-?, --help] [--usage] {smb://host/share/path/to/file} [smb://url2/] [...]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id265752"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>smbget is a simple utility with wget-like semantics, that can download files from SMB servers. You can specify the files you would like to download on the command-line.
    22        </p><p>
    33                The files should be in the smb-URL standard, e.g. use smb://host/share/file
    44                for the UNC path <span class="emphasis"><em>\\\\HOST\\SHARE\\file</em></span>.
    5         </p></div><div class="refsect1" title="OPTIONS"><a name="id265784"></a><h2>OPTIONS</h2><dt><span class="term">-a, --guest</span></dt><dd><p>Work as user guest</p></dd><dt><span class="term">-r, --resume</span></dt><dd><p>Automatically resume aborted files</p></dd><dt><span class="term">-R, --recursive</span></dt><dd><p>Recursively download files</p></dd><dt><span class="term">-u, --username=STRING</span></dt><dd><p>Username to use</p></dd><dt><span class="term">-p, --password=STRING</span></dt><dd><p>Password to use</p></dd><dt><span class="term">-w, --workgroup=STRING</span></dt><dd><p>Workgroup to use (optional)</p></dd><dt><span class="term">-n, --nonprompt</span></dt><dd><p>Don't ask anything (non-interactive)</p></dd><dt><span class="term">-d, --debuglevel=INT</span></dt><dd><p>Debuglevel to use</p></dd><dt><span class="term">-D, --dots</span></dt><dd><p>Show dots as progress indication</p></dd><dt><span class="term">-P, --keep-permissions</span></dt><dd><p>Set same permissions on local file as are set on remote file.</p></dd><dt><span class="term">-o, --outputfile</span></dt><dd><p>Write the file that is being downloaded to the specified file. Can not be used together with -R.</p></dd><dt><span class="term">-O, --stdout</span></dt><dd><p>Write the file that is being downloaded to standard output.</p></dd><dt><span class="term">-f, --rcfile</span></dt><dd><p>Use specified rcfile. This will be loaded in the order it was specified - e.g. if you specify any options before this one, they might get overriden by the contents of the rcfile.</p></dd><dt><span class="term">-q, --quiet</span></dt><dd><p>Be quiet</p></dd><dt><span class="term">-v, --verbose</span></dt><dd><p>Be verbose</p></dd><dt><span class="term">-b, --blocksize</span></dt><dd><p>Number of bytes to download in a block. Defaults to 64000.</p></dd><dt><span class="term">-?, --help</span></dt><dd><p>Show help message</p></dd><dt><span class="term">--usage</span></dt><dd><p>Display brief usage message</p></dd></div><div class="refsect1" title="SMB URLS"><a name="id307050"></a><h2>SMB URLS</h2><p> SMB URL's should be specified in the following format:</p><pre class="programlisting">
     5        </p></div><div class="refsect1" title="OPTIONS"><a name="id265783"></a><h2>OPTIONS</h2><dt><span class="term">-a, --guest</span></dt><dd><p>Work as user guest</p></dd><dt><span class="term">-r, --resume</span></dt><dd><p>Automatically resume aborted files</p></dd><dt><span class="term">-R, --recursive</span></dt><dd><p>Recursively download files</p></dd><dt><span class="term">-u, --username=STRING</span></dt><dd><p>Username to use</p></dd><dt><span class="term">-p, --password=STRING</span></dt><dd><p>Password to use</p></dd><dt><span class="term">-w, --workgroup=STRING</span></dt><dd><p>Workgroup to use (optional)</p></dd><dt><span class="term">-n, --nonprompt</span></dt><dd><p>Don't ask anything (non-interactive)</p></dd><dt><span class="term">-d, --debuglevel=INT</span></dt><dd><p>Debuglevel to use</p></dd><dt><span class="term">-D, --dots</span></dt><dd><p>Show dots as progress indication</p></dd><dt><span class="term">-P, --keep-permissions</span></dt><dd><p>Set same permissions on local file as are set on remote file.</p></dd><dt><span class="term">-o, --outputfile</span></dt><dd><p>Write the file that is being downloaded to the specified file. Can not be used together with -R.</p></dd><dt><span class="term">-O, --stdout</span></dt><dd><p>Write the file that is being downloaded to standard output.</p></dd><dt><span class="term">-f, --rcfile</span></dt><dd><p>Use specified rcfile. This will be loaded in the order it was specified - e.g. if you specify any options before this one, they might get overridden by the contents of the rcfile.</p></dd><dt><span class="term">-q, --quiet</span></dt><dd><p>Be quiet</p></dd><dt><span class="term">-v, --verbose</span></dt><dd><p>Be verbose</p></dd><dt><span class="term">-b, --blocksize</span></dt><dd><p>Number of bytes to download in a block. Defaults to 64000.</p></dd><dt><span class="term">-?, --help</span></dt><dd><p>Show help message</p></dd><dt><span class="term">--usage</span></dt><dd><p>Display brief usage message</p></dd></div><div class="refsect1" title="SMB URLS"><a name="id307049"></a><h2>SMB URLS</h2><p> SMB URL's should be specified in the following format:</p><pre class="programlisting">
    66smb://[[[domain;]user[:password@]]server[/share[/path[/file]]]]
    77</pre><pre class="programlisting">
    … …  
    99</pre><pre class="programlisting">
    1010smb://name/ means, if <em class="replaceable"><code>name</code></em> is a workgroup, all the servers in this workgroup, or if <em class="replaceable"><code>name</code></em> is a server, all the shares on this server.
    11 </pre></div><div class="refsect1" title="EXAMPLES"><a name="id307084"></a><h2>EXAMPLES</h2><pre class="programlisting">
     11</pre></div><div class="refsect1" title="EXAMPLES"><a name="id307083"></a><h2>EXAMPLES</h2><pre class="programlisting">
    1212# Recursively download 'src' directory
    1313smbget -R smb://rhonwyn/jelmer/src
    … …  
    1818# Backup my data on rhonwyn
    1919smbget -Rr smb://rhonwyn/
    20 </pre></div><div class="refsect1" title="BUGS"><a name="id307098"></a><h2>BUGS</h2><p>Permission denied is returned in some cases where the cause of the error is unknown
     20</pre></div><div class="refsect1" title="BUGS"><a name="id307097"></a><h2>BUGS</h2><p>Permission denied is returned in some cases where the cause of the error is unknown
    2121(such as an illegally formatted smb:// url or trying to get a directory without -R
    22 turned on).</p></div><div class="refsect1" title="VERSION"><a name="id307110"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    23         the Samba suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id307119"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     22turned on).</p></div><div class="refsect1" title="VERSION"><a name="id307109"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     23        the Samba suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id307118"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    2424        were created by Andrew Tridgell. Samba is now developed
    2525        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/smbgetrc.5.html

    r599 r745  
    1010                        Whether aborted downloads should be automatically resumed.
    1111                        </p></dd><dt><span class="term">recursive on|off</span></dt><dd><p>Whether directories should be downloaded recursively</p></dd><dt><span class="term">username <em class="replaceable"><code>name</code></em></span></dt><dd><p>Username to use when logging in to the remote server. Use an empty string for anonymous access.
    12                         </p></dd><dt><span class="term">password <em class="replaceable"><code>pass</code></em></span></dt><dd><p>Password to use when logging in.</p></dd><dt><span class="term">workgroup <em class="replaceable"><code>wg</code></em></span></dt><dd><p>Workgroup to use when logging in</p></dd><dt><span class="term">nonprompt on|off</span></dt><dd><p>Turns off asking for username and password. Useful for scripts.</p></dd><dt><span class="term">debuglevel <em class="replaceable"><code>int</code></em></span></dt><dd><p>(Samba) debuglevel to run at. Useful for tracking down protocol level problems.</p></dd><dt><span class="term">dots on|off</span></dt><dd><p>Whether a single dot should be printed for each block that has been downloaded, instead of the default progress indicator.</p></dd><dt><span class="term">blocksize <em class="replaceable"><code>int</code></em></span></dt><dd><p>Number of bytes to put in a block. </p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id265735"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    13         the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id265745"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbget.1.html"><span class="citerefentry"><span class="refentrytitle">smbget</span>(1)</span></a> and <a class="citerefentry" href="Samba.7.html"><span class="citerefentry"><span class="refentrytitle">Samba</span>(7)</span></a>.
     12                        </p></dd><dt><span class="term">password <em class="replaceable"><code>pass</code></em></span></dt><dd><p>Password to use when logging in.</p></dd><dt><span class="term">workgroup <em class="replaceable"><code>wg</code></em></span></dt><dd><p>Workgroup to use when logging in</p></dd><dt><span class="term">nonprompt on|off</span></dt><dd><p>Turns off asking for username and password. Useful for scripts.</p></dd><dt><span class="term">debuglevel <em class="replaceable"><code>int</code></em></span></dt><dd><p>(Samba) debuglevel to run at. Useful for tracking down protocol level problems.</p></dd><dt><span class="term">dots on|off</span></dt><dd><p>Whether a single dot should be printed for each block that has been downloaded, instead of the default progress indicator.</p></dd><dt><span class="term">blocksize <em class="replaceable"><code>int</code></em></span></dt><dd><p>Number of bytes to put in a block. </p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id265734"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     13        the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id265744"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbget.1.html"><span class="citerefentry"><span class="refentrytitle">smbget</span>(1)</span></a> and <a class="citerefentry" href="Samba.7.html"><span class="citerefentry"><span class="refentrytitle">Samba</span>(7)</span></a>.
    1414        </p></div><div class="refsect1" title="AUTHOR"><a name="id265769"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    1515        were created by Andrew Tridgell. Samba is now developed

  • trunk/server/docs/htmldocs/manpages/smbpasswd.5.html

    r599 r745  
    7777                "Last Change Time") followed by a numeric encoding of the UNIX time
    7878                in seconds since the epoch (1970) that the last change was made.
    79                 </p></dd></dl></div><p>All other colon separated fields are ignored at this time.</p></div><div class="refsect1" title="VERSION"><a name="id265835"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    80         the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id265845"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a>, <a class="citerefentry" href="Samba.7.html"><span class="citerefentry"><span class="refentrytitle">Samba</span>(7)</span></a>, and
     79                </p></dd></dl></div><p>All other colon separated fields are ignored at this time.</p></div><div class="refsect1" title="VERSION"><a name="id265836"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     80        the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id265846"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a>, <a class="citerefentry" href="Samba.7.html"><span class="citerefentry"><span class="refentrytitle">Samba</span>(7)</span></a>, and
    8181        the Internet RFC1321 for details on the MD4 algorithm.
    82         </p></div><div class="refsect1" title="AUTHOR"><a name="id265870"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     82        </p></div><div class="refsect1" title="AUTHOR"><a name="id265871"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    8383        were created by Andrew Tridgell. Samba is now developed
    8484        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/smbpasswd.8.html

    r599 r745  
    152152                can specify this parameter as only root has the permission needed
    153153                to modify attributes directly in the local smbpasswd file.
    154                 </p></dd></dl></div></div><div class="refsect1" title="NOTES"><a name="id307548"></a><h2>NOTES</h2><p>Since <code class="literal">smbpasswd</code> works in client-server
     154                </p></dd></dl></div></div><div class="refsect1" title="NOTES"><a name="id307547"></a><h2>NOTES</h2><p>Since <code class="literal">smbpasswd</code> works in client-server
    155155        mode communicating  with a local smbd for a non-root user then
    156156        the smbd daemon must be running for this to work. A common problem
    … …  
    160160        the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file and neglecting to
    161161        allow "localhost" access to the smbd. </p><p>In addition, the smbpasswd command is only useful if Samba
    162         has been set up to use encrypted passwords. </p></div><div class="refsect1" title="VERSION"><a name="id307593"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id307604"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbpasswd.5.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(5)</span></a>, <a class="citerefentry" href="Samba.7.html"><span class="citerefentry"><span class="refentrytitle">Samba</span>(7)</span></a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id307627"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     162        has been set up to use encrypted passwords. </p></div><div class="refsect1" title="VERSION"><a name="id307592"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id307602"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbpasswd.5.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(5)</span></a>, <a class="citerefentry" href="Samba.7.html"><span class="citerefentry"><span class="refentrytitle">Samba</span>(7)</span></a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id307625"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    163163        were created by Andrew Tridgell. Samba is now developed
    164164        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/smbspool.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbspool</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbspool"><a name="smbspool.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbspool &#8212; send a print file to an SMB printer</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbspool</code> {job} {user} {title} {copies} {options} [filename]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266841"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>smbspool is a very small print spooling program that
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbspool</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbspool"><a name="smbspool.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbspool &#8212; send a print file to an SMB printer</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbspool</code> {job} {user} {title} {copies} {options} [filename]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266842"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>smbspool is a very small print spooling program that
    22        sends a print file to an SMB printer. The command-line arguments
    33        are position-dependent for compatibility with the Common UNIX
    … …  
    1111        pass the URI in argv[0], while shell scripts must set the
    1212        <code class="envar">DEVICE_URI</code> environment variable prior to
    13         running smbspool.</p></div><div class="refsect1" title="OPTIONS"><a name="id265718"></a><h2>OPTIONS</h2><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>The job argument (argv[1]) contains the
     13        running smbspool.</p></div><div class="refsect1" title="OPTIONS"><a name="id265719"></a><h2>OPTIONS</h2><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>The job argument (argv[1]) contains the
    1414                job ID number and is presently not used by smbspool.
    1515                </p></li><li class="listitem"><p>The user argument (argv[2]) contains the
    … …  
    2424                not used by smbspool.</p></li><li class="listitem"><p>The filename argument (argv[6]) contains the
    2525                name of the file to print. If this argument is not specified
    26                 then the print file is read from the standard input.</p></li></ul></div></div><div class="refsect1" title="VERSION"><a name="id265762"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id265772"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> and <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id265797"></a><h2>AUTHOR</h2><p><code class="literal">smbspool</code> was written by Michael Sweet
     26                then the print file is read from the standard input.</p></li></ul></div></div><div class="refsect1" title="VERSION"><a name="id265763"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id265773"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> and <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id265798"></a><h2>AUTHOR</h2><p><code class="literal">smbspool</code> was written by Michael Sweet
    2727        at Easy Software Products.</p><p>The original Samba software and related utilities
    2828        were created by Andrew Tridgell. Samba is now developed

  • trunk/server/docs/htmldocs/manpages/smbstatus.1.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbstatus</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbstatus"><a name="smbstatus.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbstatus &#8212; report on current Samba connections</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbstatus</code> [-P] [-b] [-d &lt;debug level&gt;] [-v] [-L] [-B] [-p] [-S] [-s &lt;configuration file&gt;] [-u &lt;username&gt;]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266873"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbstatus</code> is a very simple program to
    2         list the current Samba connections.</p></div><div class="refsect1" title="OPTIONS"><a name="id266899"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-P|--profile</span></dt><dd><p>If samba has been compiled with the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbstatus</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbstatus"><a name="smbstatus.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbstatus &#8212; report on current Samba connections</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbstatus</code> [-P] [-b] [-d &lt;debug level&gt;] [-v] [-L] [-B] [-p] [-S] [-s &lt;configuration file&gt;] [-u &lt;username&gt;]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266874"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbstatus</code> is a very simple program to
     2        list the current Samba connections.</p></div><div class="refsect1" title="OPTIONS"><a name="id265697"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-P|--profile</span></dt><dd><p>If samba has been compiled with the
    33                profiling option, print only the contents of the profiling
    44                shared memory area.</p></dd><dt><span class="term">-b|--brief</span></dt><dd><p>gives brief output.</p></dd><dt><span class="term">-d|--debuglevel=level</span></dt><dd><p><em class="replaceable"><code>level</code></em> is an integer
    … …  
    2929                </p></dd><dt><span class="term">-p|--processes</span></dt><dd><p>print a list of <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> processes and exit.
    3030                Useful for scripting.</p></dd><dt><span class="term">-S|--shares</span></dt><dd><p>causes smbstatus to only list shares.</p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    31 </p></dd><dt><span class="term">-u|--user=&lt;username&gt;</span></dt><dd><p>selects information relevant to <em class="parameter"><code>username</code></em> only.</p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id307074"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    32         the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id307084"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> and <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id307107"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     31</p></dd><dt><span class="term">-u|--user=&lt;username&gt;</span></dt><dd><p>selects information relevant to <em class="parameter"><code>username</code></em> only.</p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id307075"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     32        the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id307085"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> and <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id307108"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    3333        were created by Andrew Tridgell. Samba is now developed
    3434        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/smbtar.1.html

    r599 r745  
    11<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbtar</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbtar"><a name="smbtar.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbtar &#8212; shell script for backing up SMB/CIFS shares
    2         directly to UNIX tape drives</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbtar</code> [-r] [-i] [-a] [-v] {-s server} [-p password] [-x services] [-X] [-N filename] [-b blocksize] [-d directory] [-l loglevel] [-u user] [-t tape] {filenames}</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id265707"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbtar</code> is a very small shell script on top
    3         of <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a> which dumps SMB shares directly to tape.</p></div><div class="refsect1" title="OPTIONS"><a name="id265741"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-s server</span></dt><dd><p>The SMB/CIFS server that the share resides
     2        directly to UNIX tape drives</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbtar</code> [-r] [-i] [-a] [-v] {-s server} [-p password] [-x services] [-X] [-N filename] [-b blocksize] [-d directory] [-l loglevel] [-u user] [-t tape] {filenames}</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id265706"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbtar</code> is a very small shell script on top
     3        of <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a> which dumps SMB shares directly to tape.</p></div><div class="refsect1" title="OPTIONS"><a name="id265740"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-s server</span></dt><dd><p>The SMB/CIFS server that the share resides
    44                upon.</p></dd><dt><span class="term">-x service</span></dt><dd><p>The share name on the server to connect to.
    55                The default is "backup".</p></dd><dt><span class="term">-X</span></dt><dd><p>Exclude mode. Exclude filenames... from tar
    … …  
    2020                <em class="parameter"><code>-d</code></em> flag of <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>.</p></dd></dl></div></div><div class="refsect1" title="ENVIRONMENT VARIABLES"><a name="id265946"></a><h2>ENVIRONMENT VARIABLES</h2><p>The <em class="parameter"><code>$TAPE</code></em> variable specifies the
    2121        default tape device to write to. May be overridden
    22         with the -t option. </p></div><div class="refsect1" title="BUGS"><a name="id265963"></a><h2>BUGS</h2><p>The <code class="literal">smbtar</code> script has different
     22        with the -t option. </p></div><div class="refsect1" title="BUGS"><a name="id265962"></a><h2>BUGS</h2><p>The <code class="literal">smbtar</code> script has different
    2323        options from ordinary tar and from smbclient's tar command. </p></div><div class="refsect1" title="CAVEATS"><a name="id265979"></a><h2>CAVEATS</h2><p>Sites that are more careful about security may not like
    2424        the way the script handles PC passwords. Backup and restore work

  • trunk/server/docs/htmldocs/manpages/smbtree.1.html

    r599 r745  
    11<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbtree</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbtree"><a name="smbtree.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbtree &#8212; A text based smb network browser
    2         </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbtree</code> [-b] [-D] [-S]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266363"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbtree</code> is a smb browser program
     2        </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbtree</code> [-b] [-D] [-S]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266364"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbtree</code> is a smb browser program
    33        in text mode. It is similar to the "Network Neighborhood" found
    44        on Windows computers. It prints a tree with all
    55        the known domains, the servers in those domains and
    66        the shares on the servers.
    7         </p></div><div class="refsect1" title="OPTIONS"><a name="id266846"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-b|--broadcast</span></dt><dd><p>Query network nodes by sending requests
     7        </p></div><div class="refsect1" title="OPTIONS"><a name="id266847"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-b|--broadcast</span></dt><dd><p>Query network nodes by sending requests
    88                as broadcasts instead of querying the local master browser.
    99                </p></dd><dt><span class="term">-D|--domains</span></dt><dd><p>Only print a list of all

  • trunk/server/docs/htmldocs/manpages/swat.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>swat</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="swat"><a name="swat.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>swat &#8212; Samba Web Administration Tool</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">swat</code> [-s &lt;smb config file&gt;] [-a] [-P]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266364"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">swat</code> allows a Samba administrator to
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>swat</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="swat"><a name="swat.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>swat &#8212; Samba Web Administration Tool</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">swat</code> [-s &lt;smb config file&gt;] [-a] [-P]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266363"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">swat</code> allows a Samba administrator to
    22        configure the complex <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file via a Web browser. In addition,
    33        a <code class="literal">swat</code> configuration page has help links

  • trunk/server/docs/htmldocs/manpages/tdbbackup.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>tdbbackup</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="tdbbackup"><a name="tdbbackup.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>tdbbackup &#8212; tool for backing up and for validating the integrity of samba .tdb files</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">tdbbackup</code> [-s suffix] [-v] [-h]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266364"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.1.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(1)</span></a> suite.</p><p><code class="literal">tdbbackup</code> is a tool that may be used to backup samba .tdb
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>tdbbackup</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="tdbbackup"><a name="tdbbackup.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>tdbbackup &#8212; tool for backing up and for validating the integrity of samba .tdb files</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">tdbbackup</code> [-s suffix] [-v] [-h]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266363"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.1.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(1)</span></a> suite.</p><p><code class="literal">tdbbackup</code> is a tool that may be used to backup samba .tdb
    22        files. This tool may also be used to verify the integrity of the .tdb files prior
    33        to samba startup or during normal operation. If it finds file damage and it finds
    44        a prior backup the backup file will be restored.
    5         </p></div><div class="refsect1" title="OPTIONS"><a name="id266848"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h</span></dt><dd><p>
     5        </p></div><div class="refsect1" title="OPTIONS"><a name="id266847"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h</span></dt><dd><p>
    66                Get help information.
    77                </p></dd><dt><span class="term">-s suffix</span></dt><dd><p>
    … …  
    1212                The <code class="literal">-v</code> will check the database for damages (currupt data)
    1313                which if detected causes the backup to be restored.
    14                 </p></dd></dl></div></div><div class="refsect1" title="COMMANDS"><a name="id265702"></a><h2>COMMANDS</h2><p><span class="emphasis"><em>GENERAL INFORMATION</em></span></p><p>
     14                </p></dd></dl></div></div><div class="refsect1" title="COMMANDS"><a name="id265701"></a><h2>COMMANDS</h2><p><span class="emphasis"><em>GENERAL INFORMATION</em></span></p><p>
    1515        The <code class="literal">tdbbackup</code> utility can safely be run at any time. It was designed so
    1616        that it can be used at any time to validate the integrity of tdb files, even during Samba
    … …  
    3030                <code class="literal">*.tdb</code> located in the /usr/local/samba/var directory or on some
    3131                systems in the /var/cache or /var/lib/samba directories.
    32                 </p></li></ul></div></div><div class="refsect1" title="VERSION"><a name="id265776"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id265786"></a><h2>AUTHOR</h2><p>
     32                </p></li></ul></div></div><div class="refsect1" title="VERSION"><a name="id265775"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id265785"></a><h2>AUTHOR</h2><p>
    3333        The original Samba software and related utilities were created by Andrew Tridgell.
    3434        Samba is now developed by the Samba Team as an Open Source project similar to the way

  • trunk/server/docs/htmldocs/manpages/tdbdump.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>tdbdump</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="tdbdump"><a name="tdbdump.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>tdbdump &#8212; tool for printing the contents of a TDB file</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">tdbdump</code> {filename}</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266348"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.1.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(1)</span></a> suite.</p><p><code class="literal">tdbdump</code> is a very simple utility that 'dumps' the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>tdbdump</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="tdbdump"><a name="tdbdump.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>tdbdump &#8212; tool for printing the contents of a TDB file</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">tdbdump</code> {filename}</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266347"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.1.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(1)</span></a> suite.</p><p><code class="literal">tdbdump</code> is a very simple utility that 'dumps' the
    22                contents of a TDB (Trivial DataBase) file to standard output in a
    33                human-readable format.
    44        </p><p>This tool can be used when debugging problems with TDB files. It is
    55                intended for those who are somewhat familiar with Samba internals.
    6         </p></div><div class="refsect1" title="VERSION"><a name="id266836"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id266846"></a><h2>AUTHOR</h2><p>
     6        </p></div><div class="refsect1" title="VERSION"><a name="id266835"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id266844"></a><h2>AUTHOR</h2><p>
    77        The original Samba software and related utilities were created by Andrew Tridgell.
    88        Samba is now developed by the Samba Team as an Open Source project similar to the way

  • trunk/server/docs/htmldocs/manpages/tdbtool.8.html

    r599 r745  
    77        altering the contents of Samba TDB (Trivial DataBase) files. Each
    88        of the commands listed below can be entered interactively or
    9         provided on the command line.</p></div><div class="refsect1" title="COMMANDS"><a name="id266856"></a><h2>COMMANDS</h2><div class="variablelist"><dl><dt><span class="term"><code class="option">create</code>
     9        provided on the command line.</p></div><div class="refsect1" title="COMMANDS"><a name="id266857"></a><h2>COMMANDS</h2><div class="variablelist"><dl><dt><span class="term"><code class="option">create</code>
    1010                <em class="replaceable"><code>TDBFILE</code></em></span></dt><dd><p>Create a new database named
    1111                <em class="replaceable"><code>TDBFILE</code></em>.

  • trunk/server/docs/htmldocs/manpages/testparm.1.html

    r599 r745  
    11<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>testparm</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="testparm"><a name="testparm.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>testparm &#8212; check an smb.conf configuration file for
    2         internal correctness</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">testparm</code> [-s] [-h] [-v] [-L &lt;servername&gt;] [-t &lt;encoding&gt;] {config filename} [hostname hostIP]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266850"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">testparm</code> is a very simple test program
     2        internal correctness</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">testparm</code> [-s] [-h] [-v] [-t &lt;encoding&gt;] {config filename} [hostname hostIP]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266841"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">testparm</code> is a very simple test program
    33        to check an <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> configuration file for
    44        internal correctness. If this program reports no problems, you
    … …  
    1212        smb.conf</code> file it returns an exit code of 1 to the calling
    1313        program, else it returns an exit code of 0. This allows shell scripts
    14         to test the output from <code class="literal">testparm</code>.</p></div><div class="refsect1" title="OPTIONS"><a name="id265723"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-s</span></dt><dd><p>Without this option, <code class="literal">testparm</code>
     14        to test the output from <code class="literal">testparm</code>.</p></div><div class="refsect1" title="OPTIONS"><a name="id265713"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-s</span></dt><dd><p>Without this option, <code class="literal">testparm</code>
    1515                will prompt for a carriage return after printing the service
    1616                names and before dumping the service definitions.</p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    1717</p></dd><dt><span class="term">-V|--version</span></dt><dd><p>Prints the program version number.
    18 </p></dd><dt><span class="term">-L servername</span></dt><dd><p>Sets the value of the %L macro to <em class="replaceable"><code>servername</code></em>.
    19                 This is useful for testing include files specified with the
    20                 %L macro. </p></dd><dt><span class="term">-v</span></dt><dd><p>If this option is specified, testparm
     18</p></dd><dt><span class="term">-v</span></dt><dd><p>If this option is specified, testparm
    2119                will also output all options that were not used in <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> and are thus set to their defaults.</p></dd><dt><span class="term">-t encoding</span></dt><dd><p>
    2220                Output data in specified encoding.
    … …  
    4240                be supplied.</p></dd><dt><span class="term">hostIP</span></dt><dd><p>This is the IP address of the host specified
    4341                in the previous parameter.  This address must be supplied
    44                 if the hostname parameter is supplied. </p></dd></dl></div></div><div class="refsect1" title="FILES"><a name="id265924"></a><h2>FILES</h2><div class="variablelist"><dl><dt><span class="term"><a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a></span></dt><dd><p>This is usually the name of the configuration
     42                if the hostname parameter is supplied. </p></dd></dl></div></div><div class="refsect1" title="FILES"><a name="id265900"></a><h2>FILES</h2><div class="variablelist"><dl><dt><span class="term"><a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a></span></dt><dd><p>This is usually the name of the configuration
    4543                file used by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>.
    46                 </p></dd></dl></div></div><div class="refsect1" title="DIAGNOSTICS"><a name="id265958"></a><h2>DIAGNOSTICS</h2><p>The program will issue a message saying whether the
     44                </p></dd></dl></div></div><div class="refsect1" title="DIAGNOSTICS"><a name="id265934"></a><h2>DIAGNOSTICS</h2><p>The program will issue a message saying whether the
    4745        configuration file loaded OK or not. This message may be preceded by
    4846        errors and warnings if the file did not load. If the file was
    4947        loaded OK, the program then dumps all known service details
    50         to stdout. </p></div><div class="refsect1" title="VERSION"><a name="id265970"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    51         the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id265980"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>, <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a></p></div><div class="refsect1" title="AUTHOR"><a name="id307060"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     48        to stdout. </p></div><div class="refsect1" title="VERSION"><a name="id265946"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     49        the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id265956"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>, <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a></p></div><div class="refsect1" title="AUTHOR"><a name="id265981"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    5250        were created by Andrew Tridgell. Samba is now developed
    5351        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/vfs_acl_tdb.8.html

    r599 r745  
    99        </p><p>Please note that this module is
    1010        <span class="emphasis"><em>experimental</em></span>!
    11         </p><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id266844"></a><h2>OPTIONS</h2><p>
     11        </p><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id266845"></a><h2>OPTIONS</h2><p>
    1212        There are no options for <code class="literal">vfs_acl_tdb</code>.
    13         </p></div><div class="refsect1" title="AUTHOR"><a name="id266860"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     13        </p></div><div class="refsect1" title="AUTHOR"><a name="id266861"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    1414        were created by Andrew Tridgell. Samba is now developed
    1515        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/vfs_acl_xattr.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_acl_xattr</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_acl_xattr"><a name="vfs_acl_xattr.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_acl_xattr &#8212; Save NTFS-ACLs in Extended Attributes (EAs)</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = acl_xattr</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266340"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_acl_xattr</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_acl_xattr"><a name="vfs_acl_xattr.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_acl_xattr &#8212; Save NTFS-ACLs in Extended Attributes (EAs)</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = acl_xattr</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266339"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_acl_xattr</code> VFS module stores
    33        NTFS Access Control Lists (ACLs) in Extended Attributes (EAs).

  • trunk/server/docs/htmldocs/manpages/vfs_audit.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_audit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_audit"><a name="vfs_audit.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_audit &#8212; record selected Samba VFS operations in the system log</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = audit</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266340"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_audit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_audit"><a name="vfs_audit.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_audit &#8212; record selected Samba VFS operations in the system log</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = audit</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266339"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_audit</code> VFS module records selected
    33        client operations to the system log using
    4         <a class="citerefentry" href="syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>.</p><p>The following Samba VFS operations are recorded:</p><table border="0" summary="Simple list" class="simplelist"><tr><td>connect</td></tr><tr><td>disconnect</td></tr><tr><td>opendir</td></tr><tr><td>mkdir</td></tr><tr><td>rmdir</td></tr><tr><td>open</td></tr><tr><td>close</td></tr><tr><td>rename</td></tr><tr><td>unlink</td></tr><tr><td>chmod</td></tr><tr><td>fchmod</td></tr><tr><td>chmod_acl</td></tr><tr><td>fchmod_acl</td></tr></table><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id266888"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">audit:facility = FACILITY</span></dt><dd><p>Log messages to the named
     4        <a class="citerefentry" href="syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>.</p><p>The following Samba VFS operations are recorded:</p><table border="0" summary="Simple list" class="simplelist"><tr><td>connect</td></tr><tr><td>disconnect</td></tr><tr><td>opendir</td></tr><tr><td>mkdir</td></tr><tr><td>rmdir</td></tr><tr><td>open</td></tr><tr><td>close</td></tr><tr><td>rename</td></tr><tr><td>unlink</td></tr><tr><td>chmod</td></tr><tr><td>fchmod</td></tr><tr><td>chmod_acl</td></tr><tr><td>fchmod_acl</td></tr></table><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id266887"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">audit:facility = FACILITY</span></dt><dd><p>Log messages to the named
    55                <a class="citerefentry" href="syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a> facility.
    66
    … …  
    1313        <a class="link" href="smb.conf.5.html#AUDIT:FACILITY" target="_top">audit:facility = LOCAL1</a>
    1414        <a class="link" href="smb.conf.5.html#AUDIT:PRIORITY" target="_top">audit:priority = NOTICE</a>
    15 </pre></div><div class="refsect1" title="VERSION"><a name="id265894"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
     15</pre></div><div class="refsect1" title="VERSION"><a name="id265893"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    1616        </p></div><div class="refsect1" title="AUTHOR"><a name="id265903"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    1717        were created by Andrew Tridgell. Samba is now developed

  • trunk/server/docs/htmldocs/manpages/vfs_cacheprime.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_cacheprime</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_cacheprime"><a name="vfs_cacheprime.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_cacheprime &#8212; prime the kernel file data cache</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = cacheprime</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266340"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_cacheprime</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_cacheprime"><a name="vfs_cacheprime.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_cacheprime &#8212; prime the kernel file data cache</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = cacheprime</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266341"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_cacheprime</code> VFS module reads chunks
    33        of file data near the range requested by clients in order to
    … …  
    88        on boundaries that are a multiple of this size. Each range of
    99        the file data is primed at most once during the time the client
    10         has the file open. </p><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id266839"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">cacheprime:rsize = BYTES</span></dt><dd><p>The number of bytes with which to prime
     10        has the file open. </p><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id266840"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">cacheprime:rsize = BYTES</span></dt><dd><p>The number of bytes with which to prime
    1111                the kernel data cache.</p><p>The following suffixes may be applied to BYTES:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">K</code> - BYTES is a number of kilobytes</p></li><li class="listitem"><p><code class="literal">M</code> - BYTES is a number of megabytes</p></li><li class="listitem"><p><code class="literal">G</code> - BYTES is a number of gigabytes</p></li></ul></div></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id266897"></a><h2>EXAMPLES</h2><p>For a hypothetical disk array, it is necessary to ensure
    1212        that all read operations are of size 1 megabyte (1048576 bytes),

  • trunk/server/docs/htmldocs/manpages/vfs_cap.8.html

    r599 r745  
    1212        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = cap</a>
    1313</pre></div><div class="refsect1" title="VERSION"><a name="id266884"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    14         </p></div><div class="refsect1" title="AUTHOR"><a name="id266894"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     14        </p></div><div class="refsect1" title="AUTHOR"><a name="id266893"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    1515        were created by Andrew Tridgell. Samba is now developed
    1616        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/vfs_catia.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_catia</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_catia"><a name="vfs_catia.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_catia &#8212; translate illegal characters in Catia filenames</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = catia</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266340"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_catia</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_catia"><a name="vfs_catia.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_catia &#8212; translate illegal characters in Catia filenames</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = catia</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266339"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The Catia CAD package commonly creates filenames that
    33        use characters that are illegal in CIFS filenames. The
    44        <code class="literal">vfs_catia</code> VFS module implements a fixed character
    55        mapping so that these files can be shared with CIFS clients.
    6         </p><p>This module is stackable.</p></div><div class="refsect1" title="EXAMPLES"><a name="id266828"></a><h2>EXAMPLES</h2><p>Map Catia filenames on the [CAD] share:</p><pre class="programlisting">
     6        </p><p>This module is stackable.</p></div><div class="refsect1" title="EXAMPLES"><a name="id266827"></a><h2>EXAMPLES</h2><p>Map Catia filenames on the [CAD] share:</p><pre class="programlisting">
    77        <em class="parameter"><code>[CAD]</code></em>
    88        <a class="link" href="smb.conf.5.html#PATH" target="_top">path = /data/cad</a>
    99        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = catia</a>
    10 </pre></div><div class="refsect1" title="VERSION"><a name="id266871"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    11         </p></div><div class="refsect1" title="AUTHOR"><a name="id266880"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     10</pre></div><div class="refsect1" title="VERSION"><a name="id266870"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
     11        </p></div><div class="refsect1" title="AUTHOR"><a name="id266879"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    1212        were created by Andrew Tridgell. Samba is now developed
    1313        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/vfs_commit.8.html

    r599 r745  
    1010        regular intervals.</p><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id266838"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">commit:dthresh = BYTES</span></dt><dd><p>Synchronize file data each time the specified
    1111                number of bytes has been written.
    12                 </p><p>The following suffixes may be applied to BYTES:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">K</code> - BYTES is a number of kilobytes</p></li><li class="listitem"><p><code class="literal">M</code> - BYTES is a number of megabytes</p></li><li class="listitem"><p><code class="literal">G</code> - BYTES is a number of gigabytes</p></li></ul></div></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id266895"></a><h2>EXAMPLES</h2><p>Synchronize the file data on the [precious] share after
     12                </p><p>The following suffixes may be applied to BYTES:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">K</code> - BYTES is a number of kilobytes</p></li><li class="listitem"><p><code class="literal">M</code> - BYTES is a number of megabytes</p></li><li class="listitem"><p><code class="literal">G</code> - BYTES is a number of gigabytes</p></li></ul></div></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id266896"></a><h2>EXAMPLES</h2><p>Synchronize the file data on the [precious] share after
    1313        every 512 kilobytes (524288 bytes) of data is written:</p><pre class="programlisting">
    1414        <em class="parameter"><code>[precious]</code></em>
    … …  
    1616        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = commit</a>
    1717        <a class="link" href="smb.conf.5.html#COMMIT:DTHRESH" target="_top">commit:dthresh = 512K</a>
    18 </pre></div><div class="refsect1" title="CAVEATS"><a name="id265849"></a><h2>CAVEATS</h2><p>On some systems, the data synchronization performed by
     18</pre></div><div class="refsect1" title="CAVEATS"><a name="id265848"></a><h2>CAVEATS</h2><p>On some systems, the data synchronization performed by
    1919        <code class="literal">commit</code> may reduce performance.
    2020        </p></div><div class="refsect1" title="VERSION"><a name="id265864"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.

  • trunk/server/docs/htmldocs/manpages/vfs_default_quota.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_default_quota</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_default_quota"><a name="vfs_default_quota.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_default_quota &#8212; store default quota records for Windows clients</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = default_quota</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266341"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_default_quota</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_default_quota"><a name="vfs_default_quota.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_default_quota &#8212; store default quota records for Windows clients</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = default_quota</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266340"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>
    33        suite.</p><p>Many common quota implementations only store
    … …  
    1010        the default quota to the quota record of a user. By default the
    1111        root user is taken because quota limits for root are typically
    12         not enforced.</p><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id266839"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">default_quota:uid = UID</span></dt><dd><p>UID specifies the user ID of the quota record where the
     12        not enforced.</p><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id266838"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">default_quota:uid = UID</span></dt><dd><p>UID specifies the user ID of the quota record where the
    1313                default user quota values are stored.
    1414                </p></dd><dt><span class="term">default_quota:gid = GID</span></dt><dd><p>GID specifies the group ID of the quota record where the
    … …  
    2222                be reported as having a quota of NO_LIMIT. Otherwise,
    2323                the stored values will be reported.
    24                 </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id265703"></a><h2>EXAMPLES</h2><p>Store the default quota record in the quota record for
     24                </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id265701"></a><h2>EXAMPLES</h2><p>Store the default quota record in the quota record for
    2525        the user with ID 65535 and report that user as having no quota
    2626        limits:</p><pre class="programlisting">
    … …  
    2929        <a class="link" href="smb.conf.5.html#DEFAULT_QUOTA:UID" target="_top">default_quota:uid = 65535</a>
    3030        <a class="link" href="smb.conf.5.html#DEFAULT_QUOTA:UIDNOLIMIT" target="_top">default_quota:uid nolimit = yes</a>
    31 </pre></div><div class="refsect1" title="VERSION"><a name="id265860"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    32         </p></div><div class="refsect1" title="AUTHOR"><a name="id265870"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     31</pre></div><div class="refsect1" title="VERSION"><a name="id265859"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
     32        </p></div><div class="refsect1" title="AUTHOR"><a name="id265869"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    3333        were created by Andrew Tridgell. Samba is now developed
    3434        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/vfs_dirsort.8.html

    r599 r745  
    55        <em class="parameter"><code>[global]</code></em>
    66        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = dirsort</a>
    7 </pre></div><div class="refsect1" title="VERSION"><a name="id266859"></a><h2>VERSION</h2><p>This man page is correct for version 3.3 of the Samba suite.
    8         </p></div><div class="refsect1" title="AUTHOR"><a name="id266869"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     7</pre></div><div class="refsect1" title="VERSION"><a name="id266858"></a><h2>VERSION</h2><p>This man page is correct for version 3.3 of the Samba suite.
     8        </p></div><div class="refsect1" title="AUTHOR"><a name="id266868"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    99        were created by Andrew Tridgell. Samba is now developed
    1010        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/vfs_extd_audit.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_extd_audit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_extd_audit"><a name="vfs_extd_audit.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_extd_audit &#8212; record selected Samba VFS operations</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = extd_audit</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266340"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_extd_audit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_extd_audit"><a name="vfs_extd_audit.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_extd_audit &#8212; record selected Samba VFS operations</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = extd_audit</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266341"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">extd_audit</code> VFS module records selected
    33        client operations to both the

  • trunk/server/docs/htmldocs/manpages/vfs_fake_perms.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_fake_perms</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_fake_perms"><a name="vfs_fake_perms.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_fake_perms &#8212; enable read only Roaming Profiles</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = fake_perms</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266340"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_fake_perms</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_fake_perms"><a name="vfs_fake_perms.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_fake_perms &#8212; enable read only Roaming Profiles</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = fake_perms</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266341"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_fake_perms</code> VFS module was created
    33        to allow Roaming Profile files and directories to be set (on

  • trunk/server/docs/htmldocs/manpages/vfs_fileid.8.html

    r599 r745  
    11<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_fileid</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_fileid"><a name="vfs_fileid.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_fileid &#8212; Generates file_id structs with unique device id values for
    2         cluster setups</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = fileid</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266340"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     2        cluster setups</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = fileid</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266339"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    33        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>
    44        suite.</p><p>Samba uses file_id structs to uniquely identify files
    … …  
    1010        generates the device number based on the configured algorithm
    1111        (see the "fileid:algorithm" option).
    12         </p></div><div class="refsect1" title="OPTIONS"><a name="id266832"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">fileid:algorithm = ALGORITHM</span></dt><dd><p>Available algorithms are <code class="literal">fsname</code>
     12        </p></div><div class="refsect1" title="OPTIONS"><a name="id266831"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">fileid:algorithm = ALGORITHM</span></dt><dd><p>Available algorithms are <code class="literal">fsname</code>
    1313                and <code class="literal">fsid</code>. The default value is
    1414                <code class="literal">fsname</code>.
    … …  
    2121                <code class="literal">fileid:algorithm</code> option, which was used in earlier
    2222                versions of fileid mapping feature in custom Samba 3.0 versions.
    23                 </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id265720"></a><h2>EXAMPLES</h2><p>Usage of the <code class="literal">fileid</code> module with the
     23                </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id265719"></a><h2>EXAMPLES</h2><p>Usage of the <code class="literal">fileid</code> module with the
    2424        <code class="literal">fsid</code> algorithm:</p><pre class="programlisting">
    2525        <em class="parameter"><code>[global]</code></em>
    2626        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = fileid</a>
    2727        <a class="link" href="smb.conf.5.html#FILEID:ALGORITHM" target="_top">fileid:algorithm = fsid</a>
    28 </pre></div><div class="refsect1" title="VERSION"><a name="id265878"></a><h2>VERSION</h2><p>This man page is correct for version 3.2 of the Samba suite.
    29         </p></div><div class="refsect1" title="AUTHOR"><a name="id265888"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     28</pre></div><div class="refsect1" title="VERSION"><a name="id265877"></a><h2>VERSION</h2><p>This man page is correct for version 3.2 of the Samba suite.
     29        </p></div><div class="refsect1" title="AUTHOR"><a name="id265887"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    3030        were created by Andrew Tridgell. Samba is now developed
    3131        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/vfs_full_audit.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_full_audit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_full_audit"><a name="vfs_full_audit.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_full_audit &#8212; record Samba VFS operations in the system log</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = full_audit</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266341"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_full_audit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_full_audit"><a name="vfs_full_audit.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_full_audit &#8212; record Samba VFS operations in the system log</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = full_audit</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266340"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_full_audit</code> VFS module records selected
    33        client operations to the system log using
    … …  
    1111        format is: </p><pre class="programlisting">
    1212                smbd_audit: PREFIX|OPERATION|RESULT|FILE
    13         </pre><p>The record fields are:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">PREFIX</code> - the result of the full_audit:prefix string after variable substitutions</p></li><li class="listitem"><p><code class="literal">OPERATION</code> - the name of the VFS operation</p></li><li class="listitem"><p><code class="literal">RESULT</code> - whether the operation succeeded or failed</p></li><li class="listitem"><p><code class="literal">FILE</code> - the name of the file or directory the operation was performed on</p></li></ul></div><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id307090"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">vfs_full_audit:prefix = STRING</span></dt><dd><p>Prepend audit messages with STRING. STRING is
     13        </pre><p>The record fields are:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">PREFIX</code> - the result of the full_audit:prefix string after variable substitutions</p></li><li class="listitem"><p><code class="literal">OPERATION</code> - the name of the VFS operation</p></li><li class="listitem"><p><code class="literal">RESULT</code> - whether the operation succeeded or failed</p></li><li class="listitem"><p><code class="literal">FILE</code> - the name of the file or directory the operation was performed on</p></li></ul></div><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id307089"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">vfs_full_audit:prefix = STRING</span></dt><dd><p>Prepend audit messages with STRING. STRING is
    1414                processed for standard substitution variables listed in
    1515                <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>. The default
    1616                prefix is "%u|%I". </p></dd><dt><span class="term">vfs_full_audit:success = LIST</span></dt><dd><p>LIST is a list of VFS operations that should be
    1717                recorded if they succeed. Operations are specified using
    18                 the names listed above.
     18                the names listed above. Operations can be unset by prefixing
     19                the names with "!".
    1920                </p></dd><dt><span class="term">vfs_full_audit:failure = LIST</span></dt><dd><p>LIST is a list of VFS operations that should be
    2021                recorded if they failed. Operations are specified using
    21                 the names listed above.
     22                the names listed above. Operations can be unset by prefixing
     23                the names with "!".
    2224                </p></dd><dt><span class="term">full_audit:facility = FACILITY</span></dt><dd><p>Log messages to the named
    2325                <a class="citerefentry" href="syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a> facility.
    … …  
    2729                </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id307189"></a><h2>EXAMPLES</h2><p>Log file and directory open operations on the [records]
    2830        share using the LOCAL7 facility and ALERT priority, including
    29         the username and IP address:</p><pre class="programlisting">
     31        the username and IP address. Logging excludes the open VFS function
     32        on failures:</p><pre class="programlisting">
    3033        <em class="parameter"><code>[records]</code></em>
    3134        <a class="link" href="smb.conf.5.html#PATH" target="_top">path = /data/records</a>
    … …  
    3336        <a class="link" href="smb.conf.5.html#FULL_AUDIT:PREFIX" target="_top">full_audit:prefix = %u|%I</a>
    3437        <a class="link" href="smb.conf.5.html#FULL_AUDIT:SUCCESS" target="_top">full_audit:success = open opendir</a>
    35         <a class="link" href="smb.conf.5.html#FULL_AUDIT:FAILURE" target="_top">full_audit:failure = all</a>
     38        <a class="link" href="smb.conf.5.html#FULL_AUDIT:FAILURE" target="_top">full_audit:failure = all !open</a>
    3639        <a class="link" href="smb.conf.5.html#FULL_AUDIT:FACILITY" target="_top">full_audit:facility = LOCAL7</a>
    3740        <a class="link" href="smb.conf.5.html#FULL_AUDIT:PRIORITY" target="_top">full_audit:priority = ALERT</a>
    38 </pre></div><div class="refsect1" title="VERSION"><a name="id307365"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    39         </p></div><div class="refsect1" title="AUTHOR"><a name="id307374"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     41</pre></div><div class="refsect1" title="VERSION"><a name="id307366"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
     42        </p></div><div class="refsect1" title="AUTHOR"><a name="id307375"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    4043        were created by Andrew Tridgell. Samba is now developed
    4144        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/vfs_gpfs.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_gpfs</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_gpfs"><a name="vfs_gpfs.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_gpfs &#8212; gpfs specific samba extensions like acls and prealloc</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = gpfs</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266340"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_gpfs</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_gpfs"><a name="vfs_gpfs.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_gpfs &#8212; gpfs specific samba extensions like acls and prealloc</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = gpfs</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266339"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">gpfs</code> VFS module is the home
    33        for all gpfs extensions that Samba requires for proper integration
    … …  
    99        point in time, to restrict the chown via this module as such restrictions
    1010        are the responsibility of the underlying filesystem than of Samba.
    11         </p><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id266858"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">nfs4:mode = [ simple | special ]</span></dt><dd><p>
     11        </p><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id266858"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">gpfs:sharemodes = [ yes | no ]</span></dt><dd><p>
     12                Enable/Disable cross node sharemode handling for GPFS.
     13                </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     14                <code class="literal">yes(default)</code> - propagate sharemodes across all GPFS nodes.
     15                </p></li><li class="listitem"><p>
     16                <code class="literal">no</code> - do not propagate sharemodes across all GPFS nodes.
     17                This should only be used if the GPFS file system is
     18                exclusively exported by Samba. Access by local unix application or
     19                NFS exports could lead to corrupted files.
     20                </p></li></ul></div></dd><dt><span class="term">gpfs:leases = [ yes | no ]</span></dt><dd><p>
     21                Enable/Disable cross node leases (oplocks) for GPFS.
     22                You should also set the <code class="literal">oplocks</code> and <code class="literal">kernel oplocks</code>
     23                options to the same value.
     24                </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     25                <code class="literal">yes(default)</code> - propagate leases across all GPFS nodes.
     26                </p></li><li class="listitem"><p>
     27                <code class="literal">no</code> - do not propagate leases across all GPFS nodes.
     28                This should only be used if the GPFS file system is
     29                exclusively exported by Samba. Access by local unix application or
     30                NFS exports could lead to corrupted files.
     31                </p></li></ul></div></dd><dt><span class="term">gpfs:hsm = [ yes | no ]</span></dt><dd><p>
     32                Enable/Disable announcing if this FS has HSM enabled.
     33                </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     34                <code class="literal">no(default)</code> - Do not announce HSM.
     35                </p></li><li class="listitem"><p>
     36                <code class="literal">no</code> - Announce HSM.
     37                </p></li></ul></div></dd><dt><span class="term">gpfs:getrealfilename = [ yes | no ]</span></dt><dd><p>
     38                Enable/Disable usage of the <code class="literal">gpfs_get_realfilename_path()</code> function.
     39                This improves the casesensitive wildcard file name access.
     40                </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     41                <code class="literal">yes(default)</code> - use <code class="literal">gpfs_get_realfilename_path()</code>.
     42                </p></li><li class="listitem"><p>
     43                <code class="literal">no</code> - do not use <code class="literal">gpfs_get_realfilename_path()</code>.
     44                It seems that <code class="literal">gpfs_get_realfilename_path()</code> doesn't work on AIX.
     45                </p></li></ul></div></dd><dt><span class="term">gpfs:winattr = [ yes | no ]</span></dt><dd><p>
     46                Enable/Disable usage of the windows attributes in GPFS.
     47                GPFS is able to store windows file attributes e.g. HIDDEN,
     48                READONLY, SYSTEM and others natively. That means Samba doesn't
     49                need to map them to permission bits or extended attributes.
     50                </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     51                <code class="literal">no(default)</code> - do not use GPFS windows attributes.
     52                </p></li><li class="listitem"><p>
     53                <code class="literal">yes</code> - use GPFS windows attributes.
     54                </p></li></ul></div></dd><dt><span class="term">gpfs:merge_writeappend = [ yes | no ]</span></dt><dd><p>
     55                GPFS ACLs doesn't know about the 'APPEND' right.
     56                This optionen lets Samba map the 'APPEND' right to 'WRITE'.
     57                </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     58                <code class="literal">yes(default)</code> - map 'APPEND' to 'WRITE'.
     59                </p></li><li class="listitem"><p>
     60                <code class="literal">no</code> - do not map 'APPEND' to 'WRITE'.
     61                </p></li></ul></div></dd><dt><span class="term">gpfs:refuse_dacl_protected = [ yes | no ]</span></dt><dd><p>
     62                As GPFS does not support the ACE4_FLAG_NO_PROPAGATE NFSv4 flag (which would be
     63                the mapping for the DESC_DACL_PROTECTED flag), the status of this flag is
     64                currently silently ignored by Samba. That means that if you deselect the "Allow
     65                inheritable permissions..." checkbox in Windows' ACL dialog and then apply the
     66                ACL, the flag will be back immediately.
     67                </p><p>
     68                To make sure that automatic migration with e.g. robocopy does not lead to
     69                ACLs silently (and unintentionally) changed, you can set
     70                <code class="literal">gpfs:refuse_dacl_protected = yes</code> to enable an explicit
     71                check for this flag and if set, it will return NT_STATUS_NOT_SUPPORTED so
     72                errors are shown up on the Windows side and the Administrator is aware of
     73                the ACLs not being settable like intended
     74                </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     75                <code class="literal">no(default)</code> - ignore the DESC_DACL_PROTECTED flags.
     76                </p></li><li class="listitem"><p>
     77                <code class="literal">yes</code> - reject ACLs with DESC_DACL_PROTECTED.
     78                </p></li></ul></div></dd><dt><span class="term">nfs4:mode = [ simple | special ]</span></dt><dd><p>
    1279                Enable/Disable substitution of special IDs on GPFS. This parameter
    1380                should not affect the windows users in anyway. It only ensures that Samba
    … …  
    2087                by the underlying filesystem. This parameter should be enabled with
    2188                care as it might leave your system insecure.</p><p>Some filesystems allow chown as a) giving b) stealing. It is the latter
    22                 that is considered a risk.</p><p>Following is the behaviour of Samba for different values : </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">yes</code> - Enable chown if as supported by the under filesystem</p></li><li class="listitem"><p><code class="literal">no (default)</code> - Disable chown</p></li></ul></div></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id265808"></a><h2>EXAMPLES</h2><p>A GPFS mount can be exported via Samba as follows :</p><pre class="programlisting">
     89                that is considered a risk.</p><p>Following is the behaviour of Samba for different values : </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">yes</code> - Enable chown if as supported by the under filesystem</p></li><li class="listitem"><p><code class="literal">no (default)</code> - Disable chown</p></li></ul></div></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id307172"></a><h2>EXAMPLES</h2><p>A GPFS mount can be exported via Samba as follows :</p><pre class="programlisting">
    2390        <em class="parameter"><code>[samba_gpfs_share]</code></em>
    2491        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = gpfs</a>
    … …  
    2693        <a class="link" href="smb.conf.5.html#NFS4:MODE" target="_top">nfs4: mode = special</a>
    2794        <a class="link" href="smb.conf.5.html#NFS4:ACEDUP" target="_top">nfs4: acedup = merge</a>
    28 </pre></div><div class="refsect1" title="CAVEATS"><a name="id265973"></a><h2>CAVEATS</h2><p>The gpfs gpl libraries are required by <code class="literal">gpfs</code> VFS
    29         module during both compilation and runtime.
    30         Also this VFS module is tested to work on SLES 9/10 and RHEL 4.4
    31         </p></div><div class="refsect1" title="VERSION"><a name="id307045"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    32         </p></div><div class="refsect1" title="AUTHOR"><a name="id307055"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     95</pre></div><div class="refsect1" title="CAVEATS"><a name="id307325"></a><h2>CAVEATS</h2><p>
     96        Depending on the version of gpfs, the <code class="literal">libgpfs_gpl</code>
     97        library or the <code class="literal">libgpfs</code> library is needed at
     98        runtime by the <code class="literal">gpfs</code> VFS module:
     99        Starting with gpfs 3.2.1 PTF8, the complete <code class="literal">libgpfs</code>
     100        is available as open source and <code class="literal">libgpfs_gpl</code> does no
     101        longer exist. With earlier versions of gpfs, only the
     102        <code class="literal">libgpfs_gpl</code> library was open source and could be
     103        used at run time.
     104        </p><p>
     105        At build time, only the header file <code class="literal">gpfs_gpl.h</code>
     106        is required , which is a symlink to <code class="literal">gpfs.h</code> in
     107        gpfs versions newer than 3.2.1 PTF8.
     108        </p></div><div class="refsect1" title="VERSION"><a name="id307379"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
     109        </p></div><div class="refsect1" title="AUTHOR"><a name="id307389"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    33110        were created by Andrew Tridgell. Samba is now developed
    34111        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/vfs_netatalk.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_netatalk</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_netatalk"><a name="vfs_netatalk.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_netatalk &#8212; hide .AppleDouble files from CIFS clients</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = netatalk</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266340"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_netatalk</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_netatalk"><a name="vfs_netatalk.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_netatalk &#8212; hide .AppleDouble files from CIFS clients</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = netatalk</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266339"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_netatalk</code> VFS module dynamically
    33        hides .AppleDouble files, preventing spurious errors on some
    … …  
    66        <em class="parameter"><code>[data]</code></em>
    77        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = netatalk</a>
    8 </pre></div><div class="refsect1" title="CAVEATS"><a name="id266859"></a><h2>CAVEATS</h2><p>This module is largely historic and unlikely to be of use
     8</pre></div><div class="refsect1" title="CAVEATS"><a name="id266858"></a><h2>CAVEATS</h2><p>This module is largely historic and unlikely to be of use
    99        in modern networks since current Apple systems are able to mount CIFS
    1010        shares natively.
    11         </p></div><div class="refsect1" title="VERSION"><a name="id266870"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    12         </p></div><div class="refsect1" title="AUTHOR"><a name="id266880"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     11        </p></div><div class="refsect1" title="VERSION"><a name="id266869"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
     12        </p></div><div class="refsect1" title="AUTHOR"><a name="id266879"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    1313        were created by Andrew Tridgell. Samba is now developed
    1414        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/vfs_notify_fam.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_notify_fam</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_notify_fam"><a name="vfs_notify_fam.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_notify_fam &#8212; FAM support for file change notifications</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = notify_fam</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266341"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_notify_fam</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_notify_fam"><a name="vfs_notify_fam.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_notify_fam &#8212; FAM support for file change notifications</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = notify_fam</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266340"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_notify_fam</code> module makes use of
    33        the system FAM (File Alteration Monitor) daemon to implement
    44        file change notifications for Windows clients. FAM is generally
    5         present only on IRIX and some BSD systems.</p><p>This module is not stackable.</p></div><div class="refsect1" title="EXAMPLES"><a name="id266828"></a><h2>EXAMPLES</h2><p>Support FAM notifications globally:</p><pre class="programlisting">
     5        present only on IRIX and some BSD systems.</p><p>This module is not stackable.</p></div><div class="refsect1" title="EXAMPLES"><a name="id266827"></a><h2>EXAMPLES</h2><p>Support FAM notifications globally:</p><pre class="programlisting">
    66        <em class="parameter"><code>[global]</code></em>
    77        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = notify_fam</a>
    8 </pre></div><div class="refsect1" title="VERSION"><a name="id266860"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    9         </p></div><div class="refsect1" title="AUTHOR"><a name="id266870"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     8</pre></div><div class="refsect1" title="VERSION"><a name="id266859"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
     9        </p></div><div class="refsect1" title="AUTHOR"><a name="id266868"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    1010        were created by Andrew Tridgell. Samba is now developed
    1111        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/vfs_prealloc.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_prealloc</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_prealloc"><a name="vfs_prealloc.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_prealloc &#8212; preallocate matching files to a predetermined size</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = prealloc</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266340"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_prealloc</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_prealloc"><a name="vfs_prealloc.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_prealloc &#8212; preallocate matching files to a predetermined size</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = prealloc</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266339"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_prealloc</code> VFS module preallocates
    33        files to a specified size each time a new file is created. This
    … …  
    1313        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = prealloc</a>
    1414        <a class="link" href="smb.conf.5.html#PREALLOC:TIFF" target="_top">prealloc:tiff = 4M</a>
    15 </pre></div><div class="refsect1" title="CAVEATS"><a name="id265839"></a><h2>CAVEATS</h2><p><code class="literal">vfs_prealloc</code> is not supported on all
     15</pre></div><div class="refsect1" title="CAVEATS"><a name="id265838"></a><h2>CAVEATS</h2><p><code class="literal">vfs_prealloc</code> is not supported on all
    1616        platforms and filesystems. Currently only XFS filesystems on
    1717        Linux and IRIX are supported.
    18         </p></div><div class="refsect1" title="VERSION"><a name="id265855"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    19         </p></div><div class="refsect1" title="AUTHOR"><a name="id265864"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     18        </p></div><div class="refsect1" title="VERSION"><a name="id265853"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
     19        </p></div><div class="refsect1" title="AUTHOR"><a name="id265863"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    2020        were created by Andrew Tridgell. Samba is now developed
    2121        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/vfs_preopen.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_preopen</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_preopen"><a name="vfs_preopen.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_preopen &#8212; Hide read latencies for applications reading numbered files</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = preopen</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266340"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_preopen</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_preopen"><a name="vfs_preopen.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_preopen &#8212; Hide read latencies for applications reading numbered files</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = preopen</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266339"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>This module assists applications that want to read numbered
    33        files in sequence with very strict latency requirements. One area

  • trunk/server/docs/htmldocs/manpages/vfs_readahead.8.html

    r599 r745  
    1616                requested of the kernel buffer cache.</p></dd><dt><span class="term">readahead:length = BYTES</span></dt><dd><p>The number of bytes requested to be
    1717                read into the kernel buffer cache on each
    18                 readahead call.</p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id265716"></a><h2>EXAMPLES</h2><pre class="programlisting">
     18                readahead call.</p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id265717"></a><h2>EXAMPLES</h2><pre class="programlisting">
    1919        <em class="parameter"><code>[hypothetical]</code></em>
    2020        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = readahead</a>

  • trunk/server/docs/htmldocs/manpages/vfs_readonly.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_readonly</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_readonly"><a name="vfs_readonly.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_readonly &#8212; make a Samba share read only for a specified time period</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = readonly</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266340"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_readonly</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_readonly"><a name="vfs_readonly.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_readonly &#8212; make a Samba share read only for a specified time period</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = readonly</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266339"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_readonly</code> VFS module marks a share
    33        as read only for all clients connecting within the configured
    … …  
    1818        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = readonly</a>
    1919        <a class="link" href="smb.conf.5.html#READONLY:PERIOD" target="_top">readonly:period = readonly:period = "today 9:00","today 17:00"</a>
    20 </pre></div><div class="refsect1" title="VERSION"><a name="id265838"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    21         </p></div><div class="refsect1" title="AUTHOR"><a name="id265848"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     20</pre></div><div class="refsect1" title="VERSION"><a name="id265837"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
     21        </p></div><div class="refsect1" title="AUTHOR"><a name="id265847"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    2222        were created by Andrew Tridgell. Samba is now developed
    2323        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/vfs_scannedonly.8.html

    r599 r745  
    11<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_scannedonly</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_scannedonly"><a name="vfs_scannedonly.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_scannedonly &#8212; Ensures that only files that have been scanned for viruses are
    2         visible and accessible to the end user.</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = scannedonly</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266342"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     2        visible and accessible to the end user.</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = scannedonly</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266341"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    33        <a class="citerefentry" href="samba.8.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(8)</span></a> suite.</p><p>The <code class="literal">vfs_scannedonly</code> VFS module ensures that
    44        only files that have been scanned for viruses are visible and accessible
    … …  
    2626        Files with the <code class="filename">.virus:</code> prefix are never shown to
    2727        the user and all access is denied.
    28         </p><p>This module is stackable.</p></div><div class="refsect1" title="CONFIGURATION"><a name="id266872"></a><h2>CONFIGURATION</h2><p><code class="literal">vfs_scannedonly</code> relies on a anti-virus scanning
     28        </p><p>This module is stackable.</p></div><div class="refsect1" title="CONFIGURATION"><a name="id266871"></a><h2>CONFIGURATION</h2><p><code class="literal">vfs_scannedonly</code> relies on a anti-virus scanning
    2929        daemon that listens on the scannedonly socket (unix domain socket or UDP
    3030        socket).
    31         </p></div><div class="refsect1" title="OPTIONS"><a name="id266888"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">scannedonly:domain_socket = True </span></dt><dd><p>Whether to use a unix domain socket or not (false reverts
     31        </p></div><div class="refsect1" title="OPTIONS"><a name="id266886"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">scannedonly:domain_socket = True </span></dt><dd><p>Whether to use a unix domain socket or not (false reverts
    3232                to use udp)
    3333                </p></dd><dt><span class="term">scannedonly:socketname = /var/lib/scannedonly/scan</span></dt><dd><p>The location of the unix domain socket to connect to</p></dd><dt><span class="term">scannedonly:portnum = 2020</span></dt><dd><p>The udp port number to connect to
    … …  
    7777                files. <code class="filename">.virus:</code> files and
    7878                <code class="filename">.failed:</code> files are not listed.
    79                 </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id265909"></a><h2>EXAMPLES</h2><p>Enable anti-virus scanning:</p><pre class="programlisting">
     79                </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id265908"></a><h2>EXAMPLES</h2><p>Enable anti-virus scanning:</p><pre class="programlisting">
    8080        <em class="parameter"><code>[homes]</code></em>
    8181        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = scannedonly</a>
    8282        <a class="link" href="smb.conf.5.html#SCANNEDONLY:HIDE_NONSCANNED_FILES" target="_top">scannedonly:hide_nonscanned_files = False</a>
    83 </pre></div><div class="refsect1" title="CAVEATS"><a name="id265952"></a><h2>CAVEATS</h2><p>This is not true on-access scanning. However, it is very fast
     83</pre></div><div class="refsect1" title="CAVEATS"><a name="id265951"></a><h2>CAVEATS</h2><p>This is not true on-access scanning. However, it is very fast
    8484        for files that have been scanned already.
    85         </p></div><div class="refsect1" title="VERSION"><a name="id265962"></a><h2>VERSION</h2><p>This man page is correct for version 3.5.0 of the Samba suite.
     85        </p></div><div class="refsect1" title="VERSION"><a name="id265962"></a><h2>VERSION</h2><p>This man page is correct for version 3.6.0 of the Samba suite.
    8686        </p></div><div class="refsect1" title="AUTHOR"><a name="id265972"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    8787        were created by Andrew Tridgell. Scannedonly was

  • trunk/server/docs/htmldocs/manpages/vfs_shadow_copy.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_shadow_copy</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_shadow_copy"><a name="vfs_shadow_copy.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_shadow_copy &#8212; Make a Samba share read only for a specified time period</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = shadow_copy</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266341"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_shadow_copy</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_shadow_copy"><a name="vfs_shadow_copy.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_shadow_copy &#8212; Make a Samba share read only for a specified time period</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = shadow_copy</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266340"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_shadow_copy</code> VFS module functionality
    33        that is similar to Microsoft Shadow Copy services. When setup properly,
    44        this module allows Microsoft Shadow Copy clients to browse
    55        "shadow copies" on Samba shares.
    6         </p><p>This module is stackable.</p></div><div class="refsect1" title="CONFIGURATION"><a name="id266828"></a><h2>CONFIGURATION</h2><p><code class="literal">vfs_shadow_copy</code> relies on a filesystem
     6        </p><p>This module is stackable.</p></div><div class="refsect1" title="CONFIGURATION"><a name="id266827"></a><h2>CONFIGURATION</h2><p><code class="literal">vfs_shadow_copy</code> relies on a filesystem
    77        snapshot implementation. Many common filesystems have native
    88        support for this.
    … …  
    1717        </p><pre class="programlisting">
    1818        TZ=GMT date +@GMT-%Y.%m.%d-%H.%M.%S
    19         </pre></div><div class="refsect1" title="EXAMPLES"><a name="id265735"></a><h2>EXAMPLES</h2><p>Add shadow copy support to user home directories:</p><pre class="programlisting">
     19        </pre></div><div class="refsect1" title="EXAMPLES"><a name="id265734"></a><h2>EXAMPLES</h2><p>Add shadow copy support to user home directories:</p><pre class="programlisting">
    2020        <em class="parameter"><code>[homes]</code></em>
    2121        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = shadow_copy</a>
    22 </pre></div><div class="refsect1" title="CAVEATS"><a name="id265869"></a><h2>CAVEATS</h2><p>This is not a backup, archival, or version control solution.
     22</pre></div><div class="refsect1" title="CAVEATS"><a name="id265868"></a><h2>CAVEATS</h2><p>This is not a backup, archival, or version control solution.
    2323        </p><p>With Samba or Windows servers,
    2424        <code class="literal">vfs_shadow_copy</code> is designed to be an end-user
    … …  
    2626        archival solutions and should in no way be considered as
    2727        such. Additionally, if you need version control, implement a
    28         version control system.</p></div><div class="refsect1" title="VERSION"><a name="id265890"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    29         </p></div><div class="refsect1" title="AUTHOR"><a name="id265900"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     28        version control system.</p></div><div class="refsect1" title="VERSION"><a name="id265889"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
     29        </p></div><div class="refsect1" title="AUTHOR"><a name="id265899"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    3030        were created by Andrew Tridgell. Samba is now developed
    3131        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/vfs_shadow_copy2.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_shadow_copy2</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_shadow_copy2"><a name="vfs_shadow_copy2.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_shadow_copy2 &#8212; Expose snapshots to Windows clients as shadow copies.</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = shadow_copy2</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266341"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_shadow_copy2</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_shadow_copy2"><a name="vfs_shadow_copy2.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_shadow_copy2 &#8212; Expose snapshots to Windows clients as shadow copies.</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = shadow_copy2</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266340"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_shadow_copy2</code> VFS module functionality
    33        that is similar to Microsoft Shadow Copy services. When setup properly,
    … …  
    99        shares, or use [homes].</p></li><li class="listitem"><p>The inode number of the files is altered so it is different
    1010        from the original. This allows the 'restore' button to work
    11         without a sharing violation.</p></li></ol></div><p>This module is stackable.</p></div><div class="refsect1" title="CONFIGURATION"><a name="id266854"></a><h2>CONFIGURATION</h2><p><code class="literal">vfs_shadow_copy2</code> relies on a filesystem
     11        without a sharing violation.</p></li></ol></div><p>This module is stackable.</p></div><div class="refsect1" title="CONFIGURATION"><a name="id266853"></a><h2>CONFIGURATION</h2><p><code class="literal">vfs_shadow_copy2</code> relies on a filesystem
    1212        snapshot implementation. Many common filesystems have native
    1313        support for this.
    … …  
    2222        </p><pre class="programlisting">
    2323        TZ=GMT date +@GMT-%Y.%m.%d-%H.%M.%S
    24         </pre></div><div class="refsect1" title="OPTIONS"><a name="id265759"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">shadow:snapdir = SNAPDIR
     24        </pre></div><div class="refsect1" title="OPTIONS"><a name="id265758"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">shadow:snapdir = SNAPDIR
    2525                </span></dt><dd><p>Path to the directory where snapshots are kept.
    2626                </p></dd><dt><span class="term">shadow:basedir = BASEDIR
    2727                </span></dt><dd><p>Path to the base directory that snapshots are from.
     28                </p></dd><dt><span class="term">shadow:sort = asc/desc, or not specified for unsorted (default)
     29                </span></dt><dd><p>By this parameter one can specify that the shadow
     30                copy directories should be sorted before they are sent to the
     31                client.  This can be beneficial as unix filesystems are usually
     32                not listed alphabetically sorted. If enabled, you typically
     33                want to specify descending order.
     34                </p></dd><dt><span class="term">shadow:localtime = yes/no
     35                </span></dt><dd><p>This is an optional parameter that indicates whether the
     36                snapshot names are in UTC/GMT or in local time. By default
     37                UTC is expected.
     38                </p></dd><dt><span class="term">shadow:format = format specification for snapshot names
     39                </span></dt><dd><p>This is an optional parameter that specifies the format
     40                specification for the naming of snapshots.  The format must
     41                be compatible with the conversion specifications recognized
     42                by str[fp]time.  The default value is "@GMT-%Y.%m.%d-%H.%M.%S".
    2843                </p></dd><dt><span class="term">shadow:fixinodes = yes/no
    2944                </span></dt><dd><p>If you enable <code class="literal">shadow:fixinodes
    … …  
    3550                this option then the 'restore' button in the shadow copy UI
    3651                will fail with a sharing violation.
    37                 </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id265819"></a><h2>EXAMPLES</h2><p>Add shadow copy support to user home directories:</p><pre class="programlisting">
     52                </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id265863"></a><h2>EXAMPLES</h2><p>Add shadow copy support to user home directories:</p><pre class="programlisting">
    3853        <em class="parameter"><code>[homes]</code></em>
    3954        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = shadow_copy2</a>
    4055        <a class="link" href="smb.conf.5.html#SHADOW:SNAPDIR" target="_top">shadow:snapdir = /data/snaphots</a>
    4156        <a class="link" href="smb.conf.5.html#SHADOW:BASEDIR" target="_top">shadow:basedir = /data/home</a>
    42 </pre></div><div class="refsect1" title="CAVEATS"><a name="id265974"></a><h2>CAVEATS</h2><p>This is not a backup, archival, or version control solution.
     57        <a class="link" href="smb.conf.5.html#SHADOW:SORT" target="_top">shadow:sort = desc</a>
     58</pre></div><div class="refsect1" title="CAVEATS"><a name="id265927"></a><h2>CAVEATS</h2><p>This is not a backup, archival, or version control solution.
    4359        </p><p>With Samba or Windows servers,
    4460        <code class="literal">vfs_shadow_copy2</code> is designed to be an end-user
    … …  
    4662        archival solutions and should in no way be considered as
    4763        such. Additionally, if you need version control, implement a
    48         version control system.</p></div><div class="refsect1" title="VERSION"><a name="id307051"></a><h2>VERSION</h2><p>This man page is correct for version 3.2.7 of the Samba suite.
    49         </p></div><div class="refsect1" title="AUTHOR"><a name="id307060"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     64        version control system.</p></div><div class="refsect1" title="VERSION"><a name="id265949"></a><h2>VERSION</h2><p>This man page is correct for version 3.2.7 of the Samba suite.
     65        </p></div><div class="refsect1" title="AUTHOR"><a name="id265959"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    5066        were created by Andrew Tridgell. Samba is now developed
    5167        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/vfs_smb_traffic_analyzer.8.html

    r599 r745  
    11<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smb_traffic_analyzer</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smb_traffic_analyzer"><a name="vfs_smb_traffic_analyzer.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_smb_traffic_analyzer &#8212; log Samba VFS read and write operations through a socket
    2         to a helper application</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = smb_traffic_analyzer</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266338"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     2        to a helper application</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = smb_traffic_analyzer</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266337"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    33        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_smb_traffic_analyzer</code> VFS module logs
    4         client write and read operations on a Samba server and sends this data
    5         over a socket to a helper program, which feeds a SQL database. More
     4        client file operations on a Samba server and sends this data
     5        over a socket to a helper program (in the following the "Receiver"),
     6        which feeds a SQL database. More
    67        information on the helper programs can be obtained from the
    78        homepage of the project at:
    89        http://holger123.wordpress.com/smb-traffic-analyzer/
    9         </p><p><code class="literal">vfs_smb_traffic_analyzer</code> currently is aware
    10         of the following VFS operations:</p><table border="0" summary="Simple list" class="simplelist"><tr><td>write</td></tr><tr><td>pwrite</td></tr><tr><td>read</td></tr><tr><td>pread</td></tr></table><p><code class="literal">vfs_smb_traffic_analyzer</code> sends the following data
     10        Since the VFS module depends on a receiver that is doing something with
     11        the data, it is evolving in it's development. Therefore, the module
     12        works with different protocol versions, and the receiver has to be able
     13        to decode the protocol that is used. The protocol version 1 was
     14        introduced to Samba at September 25, 2008. It was a very simple
     15        protocol, supporting only a small list of VFS operations, and had
     16        several drawbacks. The protocol version 2 is a try to solve the
     17        problems version 1 had while at the same time adding new features.
     18        </p></div><div class="refsect1" title="Protocol version 1 documentation"><a name="id266829"></a><h2>Protocol version 1 documentation</h2><p><code class="literal">vfs_smb_traffic_analyzer</code> protocol version 1 is aware
     19                of the following VFS operations:</p><table border="0" summary="Simple list" class="simplelist"><tr><td>write</td></tr><tr><td>pwrite</td></tr><tr><td>read</td></tr><tr><td>pread</td></tr></table><p><code class="literal">vfs_smb_traffic_analyzer</code> sends the following data
    1120        in a fixed format seperated by a comma through either an internet or a
    1221        unix domain socket:</p><pre class="programlisting">
    … …  
    1625        </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">BYTES</code> - the length in bytes of the VFS operation</p></li><li class="listitem"><p><code class="literal">USER</code> - the user who initiated the operation</p></li><li class="listitem"><p><code class="literal">DOMAIN</code> - the domain of the user</p></li><li class="listitem"><p><code class="literal">READ/WRITE</code> - either "W" for a write operation or "R" for read</p></li><li class="listitem"><p><code class="literal">SHARE</code> - the name of the share on which the VFS operation occured</p></li><li class="listitem"><p><code class="literal">FILENAME</code> - the name of the file that was used by the VFS operation</p></li><li class="listitem"><p><code class="literal">TIMESTAMP</code> - a timestamp, formatted as "yyyy-mm-dd hh-mm-ss.ms" indicating when the VFS operation occured</p></li></ul></div><p>
    1726
    18         </p><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id265740"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">smb_traffic_analyzer:mode = STRING</span></dt><dd><p>If STRING matches to "unix_domain_socket", the module will
     27        </p><p>This module is stackable.</p></div><div class="refsect1" title="Drawbacks of protocol version 1"><a name="id265752"></a><h2>Drawbacks of protocol version 1</h2><p>Several drawbacks have been seen with protocol version 1 over time.</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     28                        <code class="literal">Problematic parsing - </code>
     29                        Protocol version 1 uses hyphen and comma to seperate blocks of data. Once there is a
     30                        filename with a hyphen, you will run into problems because the receiver decodes the
     31                        data in a wrong way.
     32                </p></li><li class="listitem"><p>
     33                        <code class="literal">Insecure network transfer - </code>
     34                        Protocol version 1 sends all it's data as plaintext over the network.
     35                </p></li><li class="listitem"><p>
     36                        <code class="literal">Limited set of supported VFS operations - </code>
     37                        Protocol version 1 supports only four VFS operations.
     38                </p></li><li class="listitem"><p>
     39                        <code class="literal">No subreleases of the protocol - </code>
     40                        Protocol version 1 is fixed on it's version, making it unable to introduce new
     41                        features or bugfixes through compatible sub-releases.
     42                </p></li></ul></div></div><div class="refsect1" title="Version 2 of the protocol"><a name="id265817"></a><h2>Version 2 of the protocol</h2><p>Protocol version 2 is an approach to solve the problems introduced with protcol v1.
     43        From the users perspective, the following changes are most prominent among other enhancements:
     44        </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     45                The data from the module may be send encrypted, with a key stored in secrets.tdb. The
     46                Receiver then has to use the same key. The module does AES block encryption over the
     47                data to send.
     48                </p></li><li class="listitem"><p>
     49                The module now can identify itself against the receiver with a sub-release number, where
     50                the receiver may run with a different sub-release number than the module. However, as
     51                long as both run on the V2.x protocol, the receiver will not crash, even if the module
     52                uses features only implemented in the newer subrelease. Ultimativly, if the module uses
     53                a new feature from a newer subrelease, and the receiver runs an older protocol, it is just
     54                ignoring the functionality. Of course it is best to have both the receiver and the module
     55                running the same subrelease of the protocol.
     56                </p></li><li class="listitem"><p>
     57                The parsing problems of protocol V1 can no longer happen, because V2 is marshalling the
     58                data packages in a proper way.
     59                </p></li><li class="listitem"><p>
     60                The module now potientially has the ability to create data on every VFS function. As of
     61                protocol V2.0, there is support for 8 VFS functions, namely write,read,pread,pwrite,
     62                rename,chdir,mkdir and rmdir. Supporting more VFS functions is one of the targets for the
     63                upcoming sub-releases.
     64                </p></li></ul></div><p>
     65                To enable protocol V2, the protocol_version vfs option has to be used (see OPTIONS).
     66        </p></div><div class="refsect1" title="OPTIONS with protocol V1 and V2.x"><a name="id265873"></a><h2>OPTIONS with protocol V1 and V2.x</h2><div class="variablelist"><dl><dt><span class="term">smb_traffic_analyzer:mode = STRING</span></dt><dd><p>If STRING matches to "unix_domain_socket", the module will
    1967                use a unix domain socket located at /var/tmp/stadsocket, if
    2068                STRING contains an different string or is not defined, the module will
    … …  
    2371                in STRING.
    2472                </p></dd><dt><span class="term">smb_traffic_analyzer:anonymize_prefix = STRING</span></dt><dd><p>The module will replace the user names with a prefix
    25                 given by STRING and a simple hash number.
     73                given by STRING and a simple hash number. In version 2.x
     74                of the protocol, the users SID will also be anonymized.
    2675                </p></dd><dt><span class="term">smb_traffic_analyzer:total_anonymization = STRING</span></dt><dd><p>If STRING matches to 'yes', the module will replace
    2776                any user name with the string given by the option
    … …  
    2978                an additional hash number. This means that any transfer data
    3079                will be mapped to a single user, leading to a total
    31                 anonymization of user related data.</p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id265823"></a><h2>EXAMPLES</h2><p>The module running on share "example_share", using a unix domain socket</p><pre class="programlisting">
     80                anonymization of user related data. In version 2.x of the
     81                protocol, the users SID will also be anonymized.</p></dd><dt><span class="term">smb_traffic_analyzer:protocol_version = STRING</span></dt><dd><p>If STRING matches to V1 or is not given at all, the module
     82                will use version 1 of the protocol. If STRING matches to "V2"
     83                the module will use version 2 of the protocol.
     84                </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id265974"></a><h2>EXAMPLES</h2><p>Running protocol V2 on share "example_share", using an internet socket.</p><pre class="programlisting">
     85        <em class="parameter"><code>[example_share]</code></em>
     86        <a class="link" href="smb.conf.5.html#PATH" target="_top">path = /data/example</a>
     87        <a class="link" href="smb.conf.5.html#VFS_OBJECTS" target="_top">vfs_objects = smb_traffic_analyzer</a>
     88        <a class="link" href="smb.conf.5.html#SMB_TRAFFIC_ANALYZER:PROTOCOL_VERSION" target="_top">smb_traffic_analyzer:protocol_version = V2</a>
     89        <a class="link" href="smb.conf.5.html#SMB_TRAFFIC_ANALYZER:HOST" target="_top">smb_traffic_analyzer:host = examplehost</a>
     90        <a class="link" href="smb.conf.5.html#SMB_TRAFFIC_ANALYZER:PORT" target="_top">smb_traffic_analyzer:port = 3491</a>
     91        </pre><p>The module running on share "example_share", using a unix domain socket</p><pre class="programlisting">
    3292        <em class="parameter"><code>[example_share]</code></em>
    3393        <a class="link" href="smb.conf.5.html#PATH" target="_top">path = /data/example</a>
    … …  
    50110        <a class="link" href="smb.conf.5.html#SMB_TRAFFIC_ANALYZER:PORT" target="_top">smb_traffic_analyzer:port = 3491</a>
    51111        <a class="link" href="smb.conf.5.html#SMB_TRAFFIC_ANALYZER:ANONYMIZE_PREFIX" target="_top">smb_traffic_analyzer:anonymize_prefix = User</a>
    52         </pre></div><div class="refsect1" title="VERSION"><a name="id307130"></a><h2>VERSION</h2><p>This man page is correct for version 3.3 of the Samba suite.
    53         </p></div><div class="refsect1" title="AUTHOR"><a name="id307139"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     112        </pre></div><div class="refsect1" title="VERSION"><a name="id307321"></a><h2>VERSION</h2><p>This man page is correct for version 3.3 of the Samba suite.
     113        </p></div><div class="refsect1" title="AUTHOR"><a name="id307331"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    54114        were created by Andrew Tridgell. Samba is now developed
    55115        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/vfs_streams_depot.8.html

    r599 r745  
    11<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_streams_depot</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_streams_depot"><a name="vfs_streams_depot.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_streams_depot &#8212; EXPERIMENTAL module to store alternate data streams in a
    22        central directory.
    3         </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = streams_depot</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266341"></a><h2>DESCRIPTION</h2><p>This <span class="emphasis"><em>EXPERIMENTAL</em></span> VFS module is part of the
     3        </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = streams_depot</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266340"></a><h2>DESCRIPTION</h2><p>This <span class="emphasis"><em>EXPERIMENTAL</em></span> VFS module is part of the
    44        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_streams_depot</code> enables storing of NTFS
    55        alternate data streams in the file system. As a normal posix file
    66        system does not support the concept of multiple data streams per file,
    77        the streams_depot module stores the data in files in a separate
    8         directory.</p></div><div class="refsect1" title="OPTIONS"><a name="id266829"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">streams_depot:directory = PATH</span></dt><dd><p>Path of the directory where the alternate data streams
    9                 should be stored. Defaults to the sharepath/.streams.</p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id266853"></a><h2>EXAMPLES</h2><pre class="programlisting">
     8        directory.</p></div><div class="refsect1" title="OPTIONS"><a name="id266827"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">streams_depot:directory = PATH</span></dt><dd><p>Path of the directory where the alternate data streams
     9                should be stored. Defaults to the sharepath/.streams.</p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id266852"></a><h2>EXAMPLES</h2><pre class="programlisting">
    1010        <em class="parameter"><code>[share]</code></em>
    1111        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = streams_depot</a>
    12 </pre></div><div class="refsect1" title="AUTHOR"><a name="id266882"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     12</pre></div><div class="refsect1" title="AUTHOR"><a name="id266881"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    1313        were created by Andrew Tridgell. Samba is now developed
    1414        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/vfs_streams_xattr.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_streams_xattr</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_streams_xattr"><a name="vfs_streams_xattr.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_streams_xattr &#8212; Store alternate data streams in posix xattrs</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = streams_xattr</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266341"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_streams_xattr</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_streams_xattr"><a name="vfs_streams_xattr.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_streams_xattr &#8212; Store alternate data streams in posix xattrs</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = streams_xattr</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266340"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_streams_xattr</code> enables storing of NTFS
    33        alternate data streams in the file system. As a normal posix file
    … …  
    99        the size of xattrs. So this module might work for applications like IE
    1010        that stores small zone information in streams but will fail for
    11         applications that store serious amounts of data in ADSs.</p></div><div class="refsect1" title="EXAMPLES"><a name="id266834"></a><h2>EXAMPLES</h2><pre class="programlisting">
     11        applications that store serious amounts of data in ADSs.</p></div><div class="refsect1" title="EXAMPLES"><a name="id266833"></a><h2>EXAMPLES</h2><pre class="programlisting">
    1212        <em class="parameter"><code>[share]</code></em>
    1313        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = streams_xattr</a>
    14 </pre></div><div class="refsect1" title="AUTHOR"><a name="id266863"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     14</pre></div><div class="refsect1" title="AUTHOR"><a name="id266862"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    1515        were created by Andrew Tridgell. Samba is now developed
    1616        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/vfs_xattr_tdb.8.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_xattr_tdb</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_xattr_tdb"><a name="vfs_xattr_tdb.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_xattr_tdb &#8212; Save Extended Attributes (EAs) in a tdb file</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = xattr_tdb</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266340"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_xattr_tdb</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_xattr_tdb"><a name="vfs_xattr_tdb.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_xattr_tdb &#8212; Save Extended Attributes (EAs) in a tdb file</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = xattr_tdb</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266339"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_xattr_tdb</code> VFS module stores
    33        Extended Attributes (EAs) in a tdb file.

  • trunk/server/docs/htmldocs/manpages/vfstest.1.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfstest</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfstest"><a name="vfstest.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfstest &#8212; tool for testing samba VFS modules </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfstest</code> [-d debuglevel] [-c command] [-l logdir] [-h]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266826"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">vfstest</code> is a small command line
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfstest</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfstest"><a name="vfstest.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfstest &#8212; tool for testing samba VFS modules </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfstest</code> [-d debuglevel] [-c command] [-l logdir] [-h]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266827"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">vfstest</code> is a small command line
    22        utility that has the ability to test dso samba VFS modules. It gives the
    33        user the ability to call the various VFS functions manually and
    … …  
    3333<code class="constant">".progname"</code> will be appended (e.g. log.smbclient,
    3434log.smbd, etc...). The log file is never removed by the client.
    35 </p></dd></dl></div></div><div class="refsect1" title="COMMANDS"><a name="id265894"></a><h2>COMMANDS</h2><p><span class="emphasis"><em>VFS COMMANDS</em></span></p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">load &lt;module.so&gt;</code> - Load specified VFS module </p></li><li class="listitem"><p><code class="literal">populate &lt;char&gt; &lt;size&gt;</code> - Populate a data buffer with the specified data
     35</p></dd></dl></div></div><div class="refsect1" title="COMMANDS"><a name="id265895"></a><h2>COMMANDS</h2><p><span class="emphasis"><em>VFS COMMANDS</em></span></p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">load &lt;module.so&gt;</code> - Load specified VFS module </p></li><li class="listitem"><p><code class="literal">populate &lt;char&gt; &lt;size&gt;</code> - Populate a data buffer with the specified data
    3636                </p></li><li class="listitem"><p><code class="literal">showdata [&lt;offset&gt; &lt;len&gt;]</code> - Show data currently in data buffer
    37                 </p></li><li class="listitem"><p><code class="literal">connect</code> - VFS connect()</p></li><li class="listitem"><p><code class="literal">disconnect</code> - VFS disconnect()</p></li><li class="listitem"><p><code class="literal">disk_free</code> - VFS disk_free()</p></li><li class="listitem"><p><code class="literal">opendir</code> - VFS opendir()</p></li><li class="listitem"><p><code class="literal">readdir</code> - VFS readdir()</p></li><li class="listitem"><p><code class="literal">mkdir</code> - VFS mkdir()</p></li><li class="listitem"><p><code class="literal">rmdir</code> - VFS rmdir()</p></li><li class="listitem"><p><code class="literal">closedir</code> - VFS closedir()</p></li><li class="listitem"><p><code class="literal">open</code> - VFS open()</p></li><li class="listitem"><p><code class="literal">close</code> - VFS close()</p></li><li class="listitem"><p><code class="literal">read</code> - VFS read()</p></li><li class="listitem"><p><code class="literal">write</code> - VFS write()</p></li><li class="listitem"><p><code class="literal">lseek</code> - VFS lseek()</p></li><li class="listitem"><p><code class="literal">rename</code> - VFS rename()</p></li><li class="listitem"><p><code class="literal">fsync</code> - VFS fsync()</p></li><li class="listitem"><p><code class="literal">stat</code> - VFS stat()</p></li><li class="listitem"><p><code class="literal">fstat</code> - VFS fstat()</p></li><li class="listitem"><p><code class="literal">lstat</code> - VFS lstat()</p></li><li class="listitem"><p><code class="literal">unlink</code> - VFS unlink()</p></li><li class="listitem"><p><code class="literal">chmod</code> - VFS chmod()</p></li><li class="listitem"><p><code class="literal">fchmod</code> - VFS fchmod()</p></li><li class="listitem"><p><code class="literal">chown</code> - VFS chown()</p></li><li class="listitem"><p><code class="literal">fchown</code> - VFS fchown()</p></li><li class="listitem"><p><code class="literal">chdir</code> - VFS chdir()</p></li><li class="listitem"><p><code class="literal">getwd</code> - VFS getwd()</p></li><li class="listitem"><p><code class="literal">utime</code> - VFS utime()</p></li><li class="listitem"><p><code class="literal">ftruncate</code> - VFS ftruncate()</p></li><li class="listitem"><p><code class="literal">lock</code> - VFS lock()</p></li><li class="listitem"><p><code class="literal">symlink</code> - VFS symlink()</p></li><li class="listitem"><p><code class="literal">readlink</code> - VFS readlink()</p></li><li class="listitem"><p><code class="literal">link</code> - VFS link()</p></li><li class="listitem"><p><code class="literal">mknod</code> - VFS mknod()</p></li><li class="listitem"><p><code class="literal">realpath</code> - VFS realpath()</p></li></ul></div><p><span class="emphasis"><em>GENERAL COMMANDS</em></span></p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">conf &lt;smb.conf&gt;</code> - Load a different configuration file</p></li><li class="listitem"><p><code class="literal">help [&lt;command&gt;]</code> - Get list of commands or info about specified command</p></li><li class="listitem"><p><code class="literal">debuglevel &lt;level&gt;</code> - Set debug level</p></li><li class="listitem"><p><code class="literal">freemem</code> - Free memory currently in use</p></li><li class="listitem"><p><code class="literal">exit</code> - Exit vfstest</p></li></ul></div></div><div class="refsect1" title="VERSION"><a name="id307323"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
    38         suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id307332"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     37                </p></li><li class="listitem"><p><code class="literal">connect</code> - VFS connect()</p></li><li class="listitem"><p><code class="literal">disconnect</code> - VFS disconnect()</p></li><li class="listitem"><p><code class="literal">disk_free</code> - VFS disk_free()</p></li><li class="listitem"><p><code class="literal">opendir</code> - VFS opendir()</p></li><li class="listitem"><p><code class="literal">readdir</code> - VFS readdir()</p></li><li class="listitem"><p><code class="literal">mkdir</code> - VFS mkdir()</p></li><li class="listitem"><p><code class="literal">rmdir</code> - VFS rmdir()</p></li><li class="listitem"><p><code class="literal">closedir</code> - VFS closedir()</p></li><li class="listitem"><p><code class="literal">open</code> - VFS open()</p></li><li class="listitem"><p><code class="literal">close</code> - VFS close()</p></li><li class="listitem"><p><code class="literal">read</code> - VFS read()</p></li><li class="listitem"><p><code class="literal">write</code> - VFS write()</p></li><li class="listitem"><p><code class="literal">lseek</code> - VFS lseek()</p></li><li class="listitem"><p><code class="literal">rename</code> - VFS rename()</p></li><li class="listitem"><p><code class="literal">fsync</code> - VFS fsync()</p></li><li class="listitem"><p><code class="literal">stat</code> - VFS stat()</p></li><li class="listitem"><p><code class="literal">fstat</code> - VFS fstat()</p></li><li class="listitem"><p><code class="literal">lstat</code> - VFS lstat()</p></li><li class="listitem"><p><code class="literal">unlink</code> - VFS unlink()</p></li><li class="listitem"><p><code class="literal">chmod</code> - VFS chmod()</p></li><li class="listitem"><p><code class="literal">fchmod</code> - VFS fchmod()</p></li><li class="listitem"><p><code class="literal">chown</code> - VFS chown()</p></li><li class="listitem"><p><code class="literal">fchown</code> - VFS fchown()</p></li><li class="listitem"><p><code class="literal">chdir</code> - VFS chdir()</p></li><li class="listitem"><p><code class="literal">getwd</code> - VFS getwd()</p></li><li class="listitem"><p><code class="literal">utime</code> - VFS utime()</p></li><li class="listitem"><p><code class="literal">ftruncate</code> - VFS ftruncate()</p></li><li class="listitem"><p><code class="literal">lock</code> - VFS lock()</p></li><li class="listitem"><p><code class="literal">symlink</code> - VFS symlink()</p></li><li class="listitem"><p><code class="literal">readlink</code> - VFS readlink()</p></li><li class="listitem"><p><code class="literal">link</code> - VFS link()</p></li><li class="listitem"><p><code class="literal">mknod</code> - VFS mknod()</p></li><li class="listitem"><p><code class="literal">realpath</code> - VFS realpath()</p></li></ul></div><p><span class="emphasis"><em>GENERAL COMMANDS</em></span></p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">conf &lt;smb.conf&gt;</code> - Load a different configuration file</p></li><li class="listitem"><p><code class="literal">help [&lt;command&gt;]</code> - Get list of commands or info about specified command</p></li><li class="listitem"><p><code class="literal">debuglevel &lt;level&gt;</code> - Set debug level</p></li><li class="listitem"><p><code class="literal">freemem</code> - Free memory currently in use</p></li><li class="listitem"><p><code class="literal">exit</code> - Exit vfstest</p></li></ul></div></div><div class="refsect1" title="VERSION"><a name="id307324"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
     38        suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id307333"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    3939        were created by Andrew Tridgell. Samba is now developed
    4040        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/wbinfo.1.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>wbinfo</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="wbinfo"><a name="wbinfo.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>wbinfo &#8212; Query information from winbind daemon</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">wbinfo</code> [-a user%password] [--all-domains] [--allocate-gid] [--allocate-uid] [-c] [--ccache-save] [--change-user-password] [-D domain] [--domain domain] [--dsgetdcname domain] [-g] [--getdcname domain] [--get-auth-user] [-G gid] [--gid-info] [--group-info] [--help|-?] [-i user] [-I ip] [-K user%password] [--lanman] [-m] [-n name] [-N netbios-name] [--ntlmv2] [--online-status] [--own-domain] [-p] [-P|--ping-dc] [-r user] [-R|--lookup-rids] [--remove-uid-mapping uid,sid] [--remove-gid-mapping gid,sid] [-s sid] [--separator] [--sequence] [--set-auth-user user%password] [--set-uid-mapping uid,sid] [--set-gid-mapping gid,sid] [-S sid] [--sid-aliases] [--sid-to-fullname] [-t] [-u] [--uid-info uid] [--usage] [--user-domgroups sid] [--user-sids sid] [-U uid] [-V] [--verbose] [-Y sid]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id307072"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">wbinfo</code> program queries and returns information
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>wbinfo</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="wbinfo"><a name="wbinfo.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>wbinfo &#8212; Query information from winbind daemon</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">wbinfo</code> [-a user%password] [--all-domains] [--allocate-gid] [--allocate-uid] [-c] [--ccache-save] [--change-user-password] [-D domain] [--domain domain] [--dsgetdcname domain] [-g] [--getdcname domain] [--get-auth-user] [-G gid] [--gid-info] [--group-info] [--help|-?] [-i user] [-I ip] [-K user%password] [--lanman] [-m] [-n name] [-N netbios-name] [--ntlmv2] [--online-status] [--own-domain] [-p] [-P|--ping-dc] [-r user] [-R|--lookup-rids] [-s sid] [--separator] [--set-auth-user user%password] [-S sid] [--sid-aliases] [--sid-to-fullname] [-t] [-u] [--uid-info uid] [--usage] [--user-domgroups sid] [--user-sids sid] [-U uid] [-V] [--verbose] [-Y sid]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id265981"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">wbinfo</code> program queries and returns information
    22        created and used by the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon. </p><p>The <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon must be configured
    33        and running for the <code class="literal">wbinfo</code> program to be able
    4         to return information.</p></div><div class="refsect1" title="OPTIONS"><a name="id307121"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-a|--authenticate <em class="replaceable"><code>username%password</code></em></span></dt><dd><p>Attempt to authenticate a user via <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a>.
     4        to return information.</p></div><div class="refsect1" title="OPTIONS"><a name="id307086"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-a|--authenticate <em class="replaceable"><code>username%password</code></em></span></dt><dd><p>Attempt to authenticate a user via <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a>.
    55                This checks both authentication methods and reports its results.
    66                </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Do not be tempted to use this
    … …  
    1818                operations will performed.  If special domain name '.' is used to represent
    1919                the current domain to which <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> belongs.  Currently only the
    20                 <code class="option">--sequence</code>,
    2120                <code class="option">-u</code>, and <code class="option">-g</code> options honor this parameter.
    2221                </p></dd><dt><span class="term">-D|--domain-info <em class="replaceable"><code>domain</code></em></span></dt><dd><p>Show most of the info we have about the
    … …  
    6564                </p></dd><dt><span class="term">-p|--ping</span></dt><dd><p>Check whether <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> is still alive.
    6665                Prints out either 'succeeded' or 'failed'.
     66                </p></dd><dt><span class="term">-P|--ping-dc</span></dt><dd><p>Issue a no-effect command to our DC. This
     67                    checks if our secure channel connection to our domain
     68                    controller is still alive. It has much less impact than
     69                    wbinfo -t.
    6770                </p></dd><dt><span class="term">-r|--user-groups <em class="replaceable"><code>username</code></em></span></dt><dd><p>Try to obtain the list of UNIX group ids
    6871                to which the user belongs.  This only works for users
    … …  
    7578                in the traditional Microsoft format. For example,
    7679                S-1-5-21-1455342024-3071081365-2475485837-500. </p></dd><dt><span class="term">--separator</span></dt><dd><p>Get the active winbind separator.
    77                 </p></dd><dt><span class="term">--sequence</span></dt><dd><p>Show sequence numbers of all known domains.
    7880                </p></dd><dt><span class="term">--set-auth-user <em class="replaceable"><code>username%password</code></em></span></dt><dd><p>Store username and password used by <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a>   during session setup to a domain controller.  This enables
    7981                winbindd to operate in a Windows 2000 domain with Restrict
    … …  
    102104                </p></dd><dt><span class="term">-Y|--sid-to-gid <em class="replaceable"><code>sid</code></em></span></dt><dd><p>Convert a SID to a UNIX group id.  If the SID
    103105                does not correspond to a UNIX group mapped by <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> then
    104                 the operation will fail. </p></dd><dt><span class="term">--remove-uid-mapping uid,sid</span></dt><dd><p>Remove an existing uid to sid mapping
    105                 entry from the IDmap backend.</p></dd><dt><span class="term">--remove-gid-mapping gid,sid</span></dt><dd><p>Remove an existing gid to sid
    106                 mapping entry from the IDmap backend.</p></dd><dt><span class="term">--set-uid-mapping uid,sid</span></dt><dd><p>Create a new or modify an existing uid to sid
    107                 mapping in the IDmap backend.</p></dd><dt><span class="term">--set-gid-mapping gid,sid</span></dt><dd><p>Create a new or modify an existing gid to sid
    108                 mapping in the IDmap backend.</p></dd><dt><span class="term">-V|--version</span></dt><dd><p>Prints the program version number.
     106                the operation will fail. </p></dd><dt><span class="term">-V|--version</span></dt><dd><p>Prints the program version number.
    109107</p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    110 </p></dd></dl></div></div><div class="refsect1" title="EXIT STATUS"><a name="id307968"></a><h2>EXIT STATUS</h2><p>The wbinfo program returns 0 if the operation
     108</p></dd></dl></div></div><div class="refsect1" title="EXIT STATUS"><a name="id307884"></a><h2>EXIT STATUS</h2><p>The wbinfo program returns 0 if the operation
    111109        succeeded, or 1 if the operation failed.  If the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon is not working <code class="literal">wbinfo</code> will always return
    112         failure. </p></div><div class="refsect1" title="VERSION"><a name="id307992"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    113         the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id308002"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> and <a class="citerefentry" href="ntlm_auth.1.html"><span class="citerefentry"><span class="refentrytitle">ntlm_auth</span>(1)</span></a></p></div><div class="refsect1" title="AUTHOR"><a name="id308025"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     110        failure. </p></div><div class="refsect1" title="VERSION"><a name="id307908"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     111        the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id307918"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> and <a class="citerefentry" href="ntlm_auth.1.html"><span class="citerefentry"><span class="refentrytitle">ntlm_auth</span>(1)</span></a></p></div><div class="refsect1" title="AUTHOR"><a name="id307941"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    114112        were created by Andrew Tridgell. Samba is now developed
    115113        by the Samba Team as an Open Source project similar

  • trunk/server/docs/htmldocs/manpages/winbind_krb5_locator.7.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>winbind_krb5_locator</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="winbind_krb5_locator"><a name="winbind_krb5_locator.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>winbind_krb5_locator &#8212; A plugin for MIT and Heimdal Kerberos for detecting KDCs using Windows semantics.</p></div><div class="refsect1" title="DESCRIPTION"><a name="id298152"></a><h2>DESCRIPTION</h2><p>
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>winbind_krb5_locator</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="winbind_krb5_locator"><a name="winbind_krb5_locator.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>winbind_krb5_locator &#8212; A plugin for MIT and Heimdal Kerberos for detecting KDCs using Windows semantics.</p></div><div class="refsect1" title="DESCRIPTION"><a name="id298151"></a><h2>DESCRIPTION</h2><p>
    22        This plugin is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.
    33        </p><p>
    … …  
    3333                environment without any modification or servers
    3434                being put manually into <code class="filename">/etc/krb5.conf</code>.
    35         </p></div><div class="refsect1" title="VERSION"><a name="id266873"></a><h2>VERSION</h2><p>
     35        </p></div><div class="refsect1" title="VERSION"><a name="id266874"></a><h2>VERSION</h2><p>
    3636        This man page is correct for version 3 of the Samba suite.
    37         </p></div><div class="refsect1" title="AUTHOR"><a name="id266883"></a><h2>AUTHOR</h2><p>
     37        </p></div><div class="refsect1" title="AUTHOR"><a name="id266884"></a><h2>AUTHOR</h2><p>
    3838                The original Samba software and related utilities were created by Andrew
    3939                Tridgell. Samba is now developed by the Samba Team as an Open Source

  • trunk/server/docs/htmldocs/manpages/winbindd.8.html

    r599 r745  
    11<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>winbindd</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="winbindd"><a name="winbindd.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>winbindd &#8212; Name Service Switch daemon for resolving names
    2         from NT servers</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">winbindd</code> [-D] [-F] [-S] [-i] [-Y] [-d &lt;debug level&gt;] [-s &lt;smb config file&gt;] [-n]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266857"></a><h2>DESCRIPTION</h2><p>This program is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">winbindd</code> is a daemon that provides
     2        from NT servers</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">winbindd</code> [-D] [-F] [-S] [-i] [-Y] [-d &lt;debug level&gt;] [-s &lt;smb config file&gt;] [-n]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266856"></a><h2>DESCRIPTION</h2><p>This program is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">winbindd</code> is a daemon that provides
    33        a number of services to the Name Service Switch capability found
    44        in most modern C libraries, to arbitrary applications via PAM
    … …  
    5656        WINS server.</p><pre class="programlisting">
    5757hosts:          files wins
    58 </pre></div><div class="refsect1" title="OPTIONS"><a name="id307078"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-D</span></dt><dd><p>If specified, this parameter causes
     58</pre></div><div class="refsect1" title="OPTIONS"><a name="id307077"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-D</span></dt><dd><p>If specified, this parameter causes
    5959                the server to operate as a daemon. That is, it detaches
    6060                itself and runs in the background on the appropriate port.
    … …  
    204204        be the same.  The user and group ids will only be valid for the local
    205205        machine, unless a shared <a class="link" href="smb.conf.5.html#IDMAPBACKEND" target="_top">idmap backend</a> is configured.</p><p>If the the Windows NT SID to UNIX user and group id mapping
    206         file is damaged or destroyed then the mappings will be lost. </p></div><div class="refsect1" title="SIGNALS"><a name="id307719"></a><h2>SIGNALS</h2><p>The following signals can be used to manipulate the
     206        file is damaged or destroyed then the mappings will be lost. </p></div><div class="refsect1" title="SIGNALS"><a name="id307718"></a><h2>SIGNALS</h2><p>The following signals can be used to manipulate the
    207207        <code class="literal">winbindd</code> daemon. </p><div class="variablelist"><dl><dt><span class="term">SIGHUP</span></dt><dd><p>Reload the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file and
    208208                apply any parameter changes to the running
Note: See TracChangeset for help on using the changeset viewer.