Ignore:
Timestamp:
May 20, 2009, 6:46:53 PM (16 years ago)
Author:
Herwig Bauernfeind
Message:

Update 3.2 branch to 3.2.4

Location:
branches/samba-3.2.x/docs/htmldocs/manpages
Files:
68 edited

Legend:

Unmodified
Added
Removed

  • branches/samba-3.2.x/docs/htmldocs/manpages/cifs.upcall.8.html

    r202 r204  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>cifs.upcall</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="cifs.upcall.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>cifs.upcall &#8212; Userspace upcall helper for Common Internet File System (CIFS)</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">cifs.upcall</code> [-c] [-v] {keyid}</p></div></div><div class="refsect1" lang="en"><a name="id2516113"></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>cifs.upcall is a userspace helper program for the linux CIFS client
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>cifs.upcall</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="cifs.upcall.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>cifs.upcall &#8212; Userspace upcall helper for Common Internet File System (CIFS)</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">cifs.upcall</code> [-c] [-v] {keyid}</p></div></div><div class="refsect1" lang="en"><a name="id2518334"></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>cifs.upcall is a userspace helper program for the linux CIFS client
    22filesystem. There are a number of activities that the kernel cannot easily
    33do itself. This program is a callout program that does these things for the
    … …  
    55request-key(8) for a particular key type. While it
    66can be run directly from the command-line, it's not generally intended
    7 to be run that way.</p></div><div class="refsect1" lang="en"><a name="id2479189"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-c</span></dt><dd><p>When handling a kerberos upcall, use a service principal that starts with "cifs/". The default is to use the "host/" service principal.
     7to be run that way.</p></div><div class="refsect1" lang="en"><a name="id2480147"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-c</span></dt><dd><p>When handling a kerberos upcall, use a service principal that starts with "cifs/". The default is to use the "host/" service principal.
    88                </p></dd><dt><span class="term">-v</span></dt><dd><p>Print version number and exit.
    9                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479223"></a><h2>CONFIGURATION FOR KEYCTL</h2><p>cifs.upcall is designed to be called from the kernel via the request-key callout program. This requres that request-key be told where and how to call this program. The current cifs.upcall program handles two different key types:</p><div class="variablelist"><dl><dt><span class="term">cifs.spnego</span></dt><dd><p>This keytype is for retrieving kerberos session keys
     9                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2480181"></a><h2>CONFIGURATION FOR KEYCTL</h2><p>cifs.upcall is designed to be called from the kernel via the
     10        request-key callout program. This requires that request-key be told
     11        where and how to call this program. The current cifs.upcall program
     12        handles two different key types:
     13        </p><div class="variablelist"><dl><dt><span class="term">cifs.spnego</span></dt><dd><p>This keytype is for retrieving kerberos session keys
    1014                </p></dd><dt><span class="term">dns_resolver</span></dt><dd><p>This key type is for resolving hostnames into IP addresses
    1115                </p></dd></dl></div><p>To make this program useful for CIFS, you'll need to set up entries for them in request-key.conf(5). Here's an example of an entry for each key type:</p><pre class="programlisting">
    … …  
    1620</pre><p>
    1721See <a class="citerefentry" href="request-key.conf5..html"><span class="citerefentry"><span class="refentrytitle">request-key.conf(5)</span></span></a> for more info on each field.
    18 </p></div><div class="refsect1" lang="en"><a name="id2479293"></a><h2>SEE ALSO</h2><p>
     22</p></div><div class="refsect1" lang="en"><a name="id2482494"></a><h2>SEE ALSO</h2><p>
    1923        <a class="citerefentry" href="request-key.conf.5.html"><span class="citerefentry"><span class="refentrytitle">request-key.conf</span>(5)</span></a>,
    2024        <a class="citerefentry" href="mount.cifs.8.html"><span class="citerefentry"><span class="refentrytitle">mount.cifs</span>(8)</span></a>
    21         </p></div><div class="refsect1" lang="en"><a name="id2479319"></a><h2>AUTHOR</h2><p>Igor Mammedov wrote the cifs.upcall program.</p><p>Jeff Layton authored this manpage.</p><p>The maintainer of the Linux CIFS VFS is Steve French.</p><p>The <a class="ulink" href="mailto:linux-cifs-client@lists.samba.org" target="_top">Linux
     25        </p></div><div class="refsect1" lang="en"><a name="id2482519"></a><h2>AUTHOR</h2><p>Igor Mammedov wrote the cifs.upcall program.</p><p>Jeff Layton authored this manpage.</p><p>The maintainer of the Linux CIFS VFS is Steve French.</p><p>The <a class="ulink" href="mailto:linux-cifs-client@lists.samba.org" target="_top">Linux
    2226                CIFS Mailing list</a> is the preferred place to ask
    2327                questions regarding these programs.

  • branches/samba-3.2.x/docs/htmldocs/manpages/eventlogadm.8.html

    r202 r204  
    77                <code class="literal">write</code>
    88                <em class="replaceable"><code>EVENTLOG</code></em>
    9                  </p></div></div><div class="refsect1" lang="en"><a name="id2479216"></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
     9                 </p></div></div><div class="refsect1" lang="en"><a name="id2480178"></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
    1010        formatted event log records on standard input and writes them
    1111        to the Samba event log store. Windows client can then manipulate
    12         these record using the usual administration tools.</p></div><div class="refsect1" lang="en"><a name="id2479245"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term"><code class="option">-d</code></span></dt><dd><p>
     12        these record using the usual administration tools.</p></div><div class="refsect1" lang="en"><a name="id2482447"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term"><code class="option">-d</code></span></dt><dd><p>
    1313                The <code class="literal">-d</code> option causes <code class="literal">eventlogadm</code> to emit debugging
    1414                information.
    … …  
    3232                </p></dd><dt><span class="term"><code class="option">-h</code></span></dt><dd><p>
    3333                Print usage information.
    34                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479361"></a><h2>EVENTLOG RECORD FORMAT</h2><p>For the write operation, <code class="literal">eventlogadm</code>
     34                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2482563"></a><h2>EVENTLOG RECORD FORMAT</h2><p>For the write operation, <code class="literal">eventlogadm</code>
    3535        expects to be able to read structured records from standard
    3636        input. These records are a sequence of lines, with the record key
    … …  
    8181                </p></li><li><p>
    8282                <code class="literal">DAT</code> - This field should be left unset.
    83                 </p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2478302"></a><h2>EXAMPLES</h2><p>An example of the record format accepted by <code class="literal">eventlogadm</code>:</p><pre class="programlisting">
     83                </p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2478290"></a><h2>EXAMPLES</h2><p>An example of the record format accepted by <code class="literal">eventlogadm</code>:</p><pre class="programlisting">
    8484        LEN: 0
    8585        RS1: 1699505740
    … …  
    104104                my_program_to_parse_into_eventlog_records | \\
    105105                eventlogadm SystemLogEvents
    106         </pre></div><div class="refsect1" lang="en"><a name="id2478351"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478362"></a><h2>AUTHOR</h2><p> The original Samba software and related utilities were
     106        </pre></div><div class="refsect1" lang="en"><a name="id2478340"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478351"></a><h2>AUTHOR</h2><p> The original Samba software and related utilities were
    107107        created by Andrew Tridgell.  Samba is now developed by the
    108108        Samba Team as an Open Source project similar to the way the

  • branches/samba-3.2.x/docs/htmldocs/manpages/findsmb.1.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">findsmb</code> [subnet broadcast address]</p></div></div><div class="refsect1" lang="en"><a name="id2516093"></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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">findsmb</code> [subnet broadcast address]</p></div></div><div class="refsect1" lang="en"><a name="id2516089"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/idmap_ad.8.html

    r202 r204  
    55        by the administrator by adding the posixAccount/posixGroup
    66        classess and relative attribute/value pairs to the users and
    7         groups objects in AD</p></div><div class="refsect1" lang="en"><a name="id2516089"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">range = low - high</span></dt><dd><p>
     7        groups objects in AD</p></div><div class="refsect1" lang="en"><a name="id2516083"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">range = low - high</span></dt><dd><p>
    88                        Defines the available matching uid and gid range for which the
    99                        backend is authoritative. Note that the range acts as a filter.
    … …  
    1717                        This can either the RFC2307 schema support included
    1818                        in Windows 2003 R2 or the Service for Unix (SFU) schema.
    19                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479163"></a><h2>EXAMPLES</h2><p>
     19                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479161"></a><h2>EXAMPLES</h2><p>
    2020        The following example shows how to retrieve idmappings from our principal and
    2121        and trusted AD domains. All is needed is to set default to yes. If trusted
    … …  
    3434        idmap alloc backend = tdb
    3535        idmap alloc config:range        = 5000 - 9999
    36         </pre></div><div class="refsect1" lang="en"><a name="id2479190"></a><h2>AUTHOR</h2><p>
     36        </pre></div><div class="refsect1" lang="en"><a name="id2479187"></a><h2>AUTHOR</h2><p>
    3737        The original Samba software and related utilities
    3838        were created by Andrew Tridgell. Samba is now developed

  • branches/samba-3.2.x/docs/htmldocs/manpages/idmap_ldap.8.html

    r202 r204  
    33        service.  The module implements both the "idmap" and
    44        "idmap alloc" APIs.
    5         </p></div><div class="refsect1" lang="en"><a name="id2516090"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">ldap_base_dn = DN</span></dt><dd><p>
     5        </p></div><div class="refsect1" lang="en"><a name="id2518311"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">ldap_base_dn = DN</span></dt><dd><p>
    66                        Defines the directory base suffix to use when searching for
    77                        SID/uid/gid mapping entries.  If not defined, idmap_ldap will default
    … …  
    2121                        is absent, Winbind fail over to use the "idmap uid" and
    2222                        "idmap gid" options from smb.conf.
    23                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479198"></a><h2>IDMAP ALLOC OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">ldap_base_dn = DN</span></dt><dd><p>
     23                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2480156"></a><h2>IDMAP ALLOC OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">ldap_base_dn = DN</span></dt><dd><p>
    2424                        Defines the directory base suffix under which new SID/uid/gid mapping
    2525                        entries should be stored.  If not defined, idmap_ldap will default
    … …  
    3737                        is absent, Winbind fail over to use the "idmap uid"
    3838                        and "idmap gid" options from smb.conf.
    39                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479264"></a><h2>EXAMPLES</h2><p>
     39                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2482463"></a><h2>EXAMPLES</h2><p>
    4040        The follow sets of a LDAP configuration which uses a slave server
    4141        running on localhost for fast fetching SID/gid/uid mappings, it
    … …  
    6262        store. The "net idmap " command is used to store a secret
    6363        for the DN specified in a specific idmap domain.
    64         </p></div><div class="refsect1" lang="en"><a name="id2479308"></a><h2>AUTHOR</h2><p>
     64        </p></div><div class="refsect1" lang="en"><a name="id2482509"></a><h2>AUTHOR</h2><p>
    6565        The original Samba software and related utilities
    6666        were created by Andrew Tridgell. Samba is now developed

  • branches/samba-3.2.x/docs/htmldocs/manpages/idmap_nss.8.html

    r202 r204  
    55        DOMAIN\jsmith which is necessary for reporting ACLs on files and printers
    66        stored on a Samba member server.
    7         </p></div><div class="refsect1" lang="en"><a name="id2516090"></a><h2>EXAMPLES</h2><p>
     7        </p></div><div class="refsect1" lang="en"><a name="id2516084"></a><h2>EXAMPLES</h2><p>
    88        This example shows how to use idmap_nss to check the local accounts for its
    99        own domain while using allocation to create new mappings for trusted domains
    … …  
    2121            idmap alloc backend      = tdb
    2222            idmap alloc config:range = 10000 - 50000
    23         </pre></div><div class="refsect1" lang="en"><a name="id2516113"></a><h2>AUTHOR</h2><p>
     23        </pre></div><div class="refsect1" lang="en"><a name="id2516107"></a><h2>AUTHOR</h2><p>
    2424        The original Samba software and related utilities
    2525        were created by Andrew Tridgell. Samba is now developed

  • branches/samba-3.2.x/docs/htmldocs/manpages/idmap_rid.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2516086"></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></div><div class="refsect1" lang="en"><a name="id2516080"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">range = low - high</span></dt><dd><p>
    44                        Defines the available matching uid and gid range for which the
    55                        backend is authoritative. Note that the range acts as a filter.
    … …  
    1414                        for base_rid can be 1000 as the resulting ID is calculated this way:
    1515                        ID = RID - BASE_RID + LOW RANGE ID.
    16                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479162"></a><h2>EXAMPLES</h2><p>This example shows how to configure 2 domains with idmap_rid</p><pre class="programlisting">
     16                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2516123"></a><h2>EXAMPLES</h2><p>This example shows how to configure 2 domains with idmap_rid</p><pre class="programlisting">
    1717        [global]
    1818            idmap domains = MAIN TRUSTED1
    … …  
    2525            idmap config TRUSTED1:base_rid = 1000
    2626            idmap config TRUSTED1:range    = 50000 - 99999
    27         </pre></div><div class="refsect1" lang="en"><a name="id2479183"></a><h2>AUTHOR</h2><p>
     27        </pre></div><div class="refsect1" lang="en"><a name="id2479180"></a><h2>AUTHOR</h2><p>
    2828        The original Samba software and related utilities
    2929        were created by Andrew Tridgell. Samba is now developed

  • branches/samba-3.2.x/docs/htmldocs/manpages/idmap_tdb.8.html

    r202 r204  
    22        for storing SID/uid/gid mapping tables and implements
    33        both the "idmap" and "idmap alloc" APIs.
    4         </p></div><div class="refsect1" lang="en"><a name="id2516086"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">range = low - high</span></dt><dd><p>
     4        </p></div><div class="refsect1" lang="en"><a name="id2516080"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">range = low - high</span></dt><dd><p>
    55                        Defines the available matching uid and gid range for which the
    66                        backend is authoritative.  Note that the range commonly matches
    … …  
    99                        is absent, Winbind fail over to use the "idmap uid" and
    1010                        "idmap gid" options from smb.conf.
    11                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2516113"></a><h2>IDMAP ALLOC OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">range = low - high</span></dt><dd><p>
     11                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2516107"></a><h2>IDMAP ALLOC OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">range = low - high</span></dt><dd><p>
    1212                        Defines the available matching uid and gid range from which
    1313                        winbindd can allocate for users and groups.  If the parameter
    1414                        is absent, Winbind fail over to use the "idmap uid"
    1515                        and "idmap gid" options from smb.conf.
    16                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479170"></a><h2>EXAMPLES</h2><p>
     16                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479169"></a><h2>EXAMPLES</h2><p>
    1717        The following example is equivalent to the pre-3.0.25 default idmap
    1818        configuration using the "idmap backend = tdb" setting.

  • branches/samba-3.2.x/docs/htmldocs/manpages/ldb.3.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="ldb.3"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ldb<p><b>The Samba Project</b></p> &#8212; A light-weight database library</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">#include &lt;ldb.h&gt;</pre></div><div class="refsect1" lang="en"><a name="id2516083"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="ldb.3"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ldb<p><b>The Samba Project</b></p> &#8212; A light-weight database library</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">#include &lt;ldb.h&gt;</pre></div><div class="refsect1" lang="en"><a name="id2516077"></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" lang="en"><a name="id2479177"></a><h2>TOOLS</h2><div class="itemizedlist"><ul type="disc"><li><p>
     37        </p></div><div class="refsect1" lang="en"><a name="id2479170"></a><h2>TOOLS</h2><div class="itemizedlist"><ul type="disc"><li><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" lang="en"><a name="id2479240"></a><h2>FUNCTIONS</h2><div class="itemizedlist"><ul type="disc"><li><p>
     52                </p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2479235"></a><h2>FUNCTIONS</h2><div class="itemizedlist"><ul type="disc"><li><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" lang="en"><a name="id2478260"></a><h2>Author</h2><p>
     127                </p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2478261"></a><h2>Author</h2><p>
    128128                ldb was written by
    129129                 <a class="ulink" href="http://samba.org/~tridge/" target="_top">Andrew Tridgell</a>.

  • branches/samba-3.2.x/docs/htmldocs/manpages/ldbadd.1.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2516122"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2516118"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/ldbdel.1.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">ldbdel</code> [-h] [-H LDB-URL] [dn] [...]</p></div></div><div class="refsect1" lang="en"><a name="id2516114"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">ldbdel</code> [-h] [-H LDB-URL] [dn] [...]</p></div></div><div class="refsect1" lang="en"><a name="id2516110"></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
    … …  
    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" lang="en"><a name="id2479196"></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" lang="en"><a name="id2479218"></a><h2>VERSION</h2><p>This man page is correct for version 4.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2479229"></a><h2>SEE ALSO</h2><p>ldb(7), ldbmodify, ldbadd, ldif(5)</p></div><div class="refsect1" lang="en"><a name="id2479238"></a><h2>AUTHOR</h2><p> ldb was written by
     8                        </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479198"></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" lang="en"><a name="id2479219"></a><h2>VERSION</h2><p>This man page is correct for version 4.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2479230"></a><h2>SEE ALSO</h2><p>ldb(7), ldbmodify, ldbadd, ldif(5)</p></div><div class="refsect1" lang="en"><a name="id2479240"></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>

  • branches/samba-3.2.x/docs/htmldocs/manpages/ldbmodify.1.html

    r202 r204  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ldbmodify</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="ldbmodify.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ldbmodify &#8212; Modify records in a LDB database</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">ldbmodify</code> [-H LDB-URL] [ldif-file]</p></div></div><div class="refsect1" lang="en"><a name="id2516098"></a><h2>DESCRIPTION</h2><p>
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ldbmodify</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="ldbmodify.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ldbmodify &#8212; Modify records in a LDB database</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">ldbmodify</code> [-H LDB-URL] [ldif-file]</p></div></div><div class="refsect1" lang="en"><a name="id2516095"></a><h2>DESCRIPTION</h2><p>
    22                ldbmodify changes, adds and deletes records in a LDB database.
    33                The changes that should be made to the LDB database are read from
    44                the specified LDIF-file. If - is specified as the filename, input is read from stdin.
    5         </p><p>For now, see ldapmodify(1) for details on the LDIF file format.</p></div><div class="refsect1" lang="en"><a name="id2516117"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-H &lt;ldb-url&gt;</span></dt><dd><p>
     5        </p><p>For now, see ldapmodify(1) for details on the LDIF file format.</p></div><div class="refsect1" lang="en"><a name="id2516113"></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.
    77                        </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479170"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/libsmbclient.7.html

    r202 r204  
    11<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>libsmbclient</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="libsmbclient.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>libsmbclient &#8212; An extension library for browsers and that can be used as a generic browsing API.</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">Browser URL:</code><p>
    22        smb://[[[domain:]user[:password@]]server[/share[/path[/file]]]] [?options]
    3     </p></p></div></div><div class="refsect1" lang="en"><a name="id2516094"></a><h2>DESCRIPTION</h2><p>
     3    </p></p></div></div><div class="refsect1" lang="en"><a name="id2518317"></a><h2>DESCRIPTION</h2><p>
    44        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.
    55        </p><p>
    … …  
    1313        extension of the capabilities of tools such as file managers and browsers.  This man page describes the
    1414        configuration options for this tool so that the user may obtain greatest utility of use.
    15         </p></div><div class="refsect1" lang="en"><a name="id2479180"></a><h2>OPTIONS</h2><p>
     15        </p></div><div class="refsect1" lang="en"><a name="id2480143"></a><h2>OPTIONS</h2><p>
    1616        What the URLs mean:
    1717        </p><div class="variablelist"><dl><dt><span class="term">smb://</span></dt><dd><p>
    … …  
    4545        parameter and will use its value when if the <code class="literal">user</code> parameter was not included
    4646        in the URL.
    47         </p></div><div class="refsect1" lang="en"><a name="id2479320"></a><h2>PROGRAMMERS GUIDE</h2><p>
     47        </p></div><div class="refsect1" lang="en"><a name="id2482522"></a><h2>PROGRAMMERS GUIDE</h2><p>
    4848        Watch this space for future updates.
    49         </p></div><div class="refsect1" lang="en"><a name="id2479331"></a><h2>VERSION</h2><p>
     49        </p></div><div class="refsect1" lang="en"><a name="id2482532"></a><h2>VERSION</h2><p>
    5050        This man page is correct for version 3 of the Samba suite.
    51         </p></div><div class="refsect1" lang="en"><a name="id2479342"></a><h2>AUTHOR</h2><p>
     51        </p></div><div class="refsect1" lang="en"><a name="id2482544"></a><h2>AUTHOR</h2><p>
    5252        The original Samba software and related utilities were created by Andrew Tridgell.
    5353        Samba is now developed by the Samba Team as an Open Source project similar to the way

  • branches/samba-3.2.x/docs/htmldocs/manpages/lmhosts.5.html

    r202 r204  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>lmhosts</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="lmhosts.5"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>lmhosts &#8212; The Samba NetBIOS hosts file</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">lmhosts</code> is the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> NetBIOS name to IP address mapping file.</p></div><div class="refsect1" lang="en"><a name="id2516091"></a><h2>DESCRIPTION</h2><p>This file 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="filename">lmhosts</code> is the <span class="emphasis"><em>Samba
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>lmhosts</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="lmhosts.5"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>lmhosts &#8212; The Samba NetBIOS hosts file</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">lmhosts</code> is the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> NetBIOS name to IP address mapping file.</p></div><div class="refsect1" lang="en"><a name="id2516085"></a><h2>DESCRIPTION</h2><p>This file 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="filename">lmhosts</code> is the <span class="emphasis"><em>Samba
    22        </em></span> NetBIOS name to IP address mapping file.  It
    33        is very similar to the <code class="filename">/etc/hosts</code> file
    44        format, except that the hostname component must correspond
    5         to the NetBIOS naming format.</p></div><div class="refsect1" lang="en"><a name="id2516128"></a><h2>FILE FORMAT</h2><p>It is an ASCII file containing one line for NetBIOS name.
     5        to the NetBIOS naming format.</p></div><div class="refsect1" lang="en"><a name="id2516123"></a><h2>FILE FORMAT</h2><p>It is an ASCII file containing one line for NetBIOS name.
    66        The two fields on each line are separated from each other by
    77        white space. Any entry beginning with '#' is ignored. Each line
    … …  
    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" lang="en"><a name="id2479238"></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" lang="en"><a name="id2479239"></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" lang="en"><a name="id2479261"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2479272"></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>
     30        </p></div><div class="refsect1" lang="en"><a name="id2479262"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2479273"></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>
    3131        </p></div><div class="refsect1" lang="en"><a name="id2479306"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    3232        were created by Andrew Tridgell. Samba is now developed

  • branches/samba-3.2.x/docs/htmldocs/manpages/log2pcap.1.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">log2pcap</code> [-h] [-q] [logfile] [pcap_file]</p></div></div><div class="refsect1" lang="en"><a name="id2516114"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">log2pcap</code> [-h] [-q] [logfile] [pcap_file]</p></div></div><div class="refsect1" lang="en"><a name="id2516110"></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" lang="en"><a name="id2479195"></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" lang="en"><a name="id2479196"></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" lang="en"><a name="id2479274"></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" lang="en"><a name="id2479275"></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" lang="en"><a name="id2479314"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2479325"></a><h2>BUGS</h2><p>Only SMB data is extracted from the samba logs, no LDAP,
     24        </pre></div><div class="refsect1" lang="en"><a name="id2479315"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2479326"></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" lang="en"><a name="id2479341"></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" lang="en"><a name="id2479364"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     26        checksum.</p></div><div class="refsect1" lang="en"><a name="id2479343"></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" lang="en"><a name="id2479365"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/mount.cifs.8.html

    r202 r204  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>mount.cifs</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="mount.cifs.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>mount.cifs &#8212; mount using the Common Internet File System (CIFS)</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">mount.cifs</code> {service} {mount-point} [-o options]</p></div></div><div class="refsect1" lang="en"><a name="id2516113"></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>mount.cifs mounts a Linux CIFS filesystem. It
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>mount.cifs</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="mount.cifs.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>mount.cifs &#8212; mount using the Common Internet File System (CIFS)</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">mount.cifs</code> {service} {mount-point} [-o options]</p></div></div><div class="refsect1" lang="en"><a name="id2518335"></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>mount.cifs mounts a Linux CIFS filesystem. It
    22is usually invoked indirectly by
    33the <a class="citerefentry" href="mount.8.html"><span class="citerefentry"><span class="refentrytitle">mount</span>(8)</span></a> command when using the
    … …  
    2121        </p><p><span class="emphasis"><em>mount.cifs</em></span> causes the cifs vfs to launch a thread named cifsd. After mounting it keeps running until
    2222                the mounted resource is unmounted (usually via the umount utility).
    23         </p></div><div class="refsect1" lang="en"><a name="id2479217"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">user=<em class="replaceable"><code>arg</code></em></span></dt><dd><p>specifies the username to connect as. If
     23        </p></div><div class="refsect1" lang="en"><a name="id2480179"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">user=<em class="replaceable"><code>arg</code></em></span></dt><dd><p>specifies the username to connect as. If
    2424                                this is not given, then the environment variable <span class="emphasis"><em>USER</em></span> is used. This option can also take the
    2525form "user%password" or "workgroup/user" or
    … …  
    214214                </p></dd><dt><span class="term">wsize=<em class="replaceable"><code>arg</code></em></span></dt><dd><p>default network write size (default 57344)
    215215                maximum wsize currently allowed by CIFS is 57344 (fourteen
    216                 4096 byte pages)</p></dd><dt><span class="term">--verbose</span></dt><dd><p>Print additional debugging information for the mount. Note that this parameter must be specified before the -o. For example:</p><p>mount -t cifs //server/share /mnt --verbose -o user=username</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2525594"></a><h2>SERVICE FORMATTING AND DELIMITERS</h2><p>
     216                4096 byte pages)</p></dd><dt><span class="term">--verbose</span></dt><dd><p>Print additional debugging information for the mount. Note that this parameter must be specified before the -o. For example:</p><p>mount -t cifs //server/share /mnt --verbose -o user=username</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2527776"></a><h2>SERVICE FORMATTING AND DELIMITERS</h2><p>
    217217                It's generally preferred to use forward slashes (/) as a delimiter in service names. They are considered to be the "universal delimiter" since they are generally not allowed to be embedded within path components on Windows machines and the client can convert them to blackslashes (\) unconditionally. Conversely, backslash characters are allowed by POSIX to be part of a path component, and can't be automatically converted in the same way.
    218218        </p><p>
    219219                mount.cifs will attempt to convert backslashes to forward slashes where it's able to do so, but it cannot do so in any path component following the sharename.
    220         </p></div><div class="refsect1" lang="en"><a name="id2525617"></a><h2>ENVIRONMENT VARIABLES</h2><p>
     220        </p></div><div class="refsect1" lang="en"><a name="id2527800"></a><h2>ENVIRONMENT VARIABLES</h2><p>
    221221                The variable <span class="emphasis"><em>USER</em></span> may contain the username of the
    222222person to be used to authenticate to the server.
    … …  
    230230of a file to read the password from. A single line of input is
    231231read and used as the password.
    232         </p></div><div class="refsect1" lang="en"><a name="id2525652"></a><h2>NOTES</h2><p>This command may be used only by root, unless installed setuid, in which case the noeexec and nosuid mount flags are enabled.</p></div><div class="refsect1" lang="en"><a name="id2525664"></a><h2>CONFIGURATION</h2><p>
     232        </p></div><div class="refsect1" lang="en"><a name="id2527835"></a><h2>NOTES</h2><p>This command may be used only by root, unless installed setuid, in which case the noeexec and nosuid mount flags are enabled.</p></div><div class="refsect1" lang="en"><a name="id2527847"></a><h2>CONFIGURATION</h2><p>
    233233The primary mechanism for making configuration changes and for reading
    234234debug information for the cifs vfs is via the Linux /proc filesystem.
    … …  
    241241installation (device driver load).
    242242For more information see the kernel file <code class="filename">fs/cifs/README</code>.
    243 </p></div><div class="refsect1" lang="en"><a name="id2525697"></a><h2>BUGS</h2><p>Mounting using the CIFS URL specification is currently not supported.
     243</p></div><div class="refsect1" lang="en"><a name="id2527879"></a><h2>BUGS</h2><p>Mounting using the CIFS URL specification is currently not supported.
    244244        </p><p>The credentials file does not handle usernames or passwords with
    245245                leading space.</p><p>
    … …  
    249249when reporting bugs (minimum: mount.cifs (try mount.cifs -V), kernel (see /proc/version) and
    250250server type you are trying to contact.
    251 </p></div><div class="refsect1" lang="en"><a name="id2525722"></a><h2>VERSION</h2><p>This man page is correct for version 1.52 of
    252         the cifs vfs filesystem (roughly Linux kernel 2.6.24).</p></div><div class="refsect1" lang="en"><a name="id2525733"></a><h2>SEE ALSO</h2><p>
     251</p></div><div class="refsect1" lang="en"><a name="id2527904"></a><h2>VERSION</h2><p>This man page is correct for version 1.52 of
     252        the cifs vfs filesystem (roughly Linux kernel 2.6.24).</p></div><div class="refsect1" lang="en"><a name="id2527916"></a><h2>SEE ALSO</h2><p>
    253253        Documentation/filesystems/cifs.txt and fs/cifs/README in the linux kernel
    254254        source tree may contain additional options and information.
    255 </p><p><a class="citerefentry" href="umount.cifs.8.html"><span class="citerefentry"><span class="refentrytitle">umount.cifs</span>(8)</span></a></p></div><div class="refsect1" lang="en"><a name="id2525754"></a><h2>AUTHOR</h2><p>Steve French</p><p>The syntax and manpage were loosely based on that of smbmount. It
     255</p><p><a class="citerefentry" href="umount.cifs.8.html"><span class="citerefentry"><span class="refentrytitle">umount.cifs</span>(8)</span></a></p></div><div class="refsect1" lang="en"><a name="id2527937"></a><h2>AUTHOR</h2><p>Steve French</p><p>The syntax and manpage were loosely based on that of smbmount. It
    256256                was converted to Docbook/XML by Jelmer Vernooij.</p><p>The maintainer of the Linux cifs vfs and the userspace
    257257                tool <span class="emphasis"><em>mount.cifs</em></span> is <a class="ulink" href="mailto:sfrench@samba.org" target="_top">Steve French</a>.

  • branches/samba-3.2.x/docs/htmldocs/manpages/net.8.html

    r202 r204  
    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" lang="en"><a name="id2479253"></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" lang="en"><a name="id2479254"></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
    … …  
    5555data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
    5656override the <a class="link" href="smb.conf.5.html#LOGLEVEL">log level</a> parameter
    57 in the <code class="filename">smb.conf</code> file.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478334"></a><h2>COMMANDS</h2><div class="refsect2" lang="en"><a name="id2478339"></a><h3>CHANGESECRETPW</h3><p>This command allows the Samba machine account password to be set from an external application
     57in the <code class="filename">smb.conf</code> file.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478336"></a><h2>COMMANDS</h2><div class="refsect2" lang="en"><a name="id2478341"></a><h3>CHANGESECRETPW</h3><p>This command allows the Samba machine account password to be set from an external application
    5858to a machine account password that has already been stored in Active Directory. DO NOT USE this command
    5959unless you know exactly what you are doing. The use of this command requires that the force flag (-f)
    … …  
    6262this without care and attention as it will overwrite a legitimate machine password without warning.
    6363YOU HAVE BEEN WARNED.
    64 </p></div><div class="refsect2" lang="en"><a name="id2478360"></a><h3>TIME</h3><p>The <code class="literal">NET TIME</code> command allows you to view the time on a remote server
    65         or synchronise the time on the local server with the time on the remote server.</p><div class="refsect3" lang="en"><a name="id2478377"></a><h4>TIME</h4><p>Without any options, the <code class="literal">NET TIME</code> command
     64</p></div><div class="refsect2" lang="en"><a name="id2478362"></a><h3>TIME</h3><p>The <code class="literal">NET TIME</code> command allows you to view the time on a remote server
     65        or synchronise the time on the local server with the time on the remote server.</p><div class="refsect3" lang="en"><a name="id2478379"></a><h4>TIME</h4><p>Without any options, the <code class="literal">NET TIME</code> command
    6666displays the time on the remote server.
    67 </p></div><div class="refsect3" lang="en"><a name="id2478394"></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" lang="en"><a name="id2478411"></a><h4>TIME SET</h4><p>Tries to set the date and time of the local server to that on
    68 the remote server using <code class="literal">/bin/date</code>. </p></div><div class="refsect3" lang="en"><a name="id2478429"></a><h4>TIME ZONE</h4><p>Displays the timezone in hours from GMT on the remote computer.</p></div></div><div class="refsect2" lang="en"><a name="id2478441"></a><h3>[RPC|ADS] JOIN [TYPE] [-U username[%password]] [createupn=UPN] [createcomputer=OU] [options]</h3><p>
     67</p></div><div class="refsect3" lang="en"><a name="id2478396"></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" lang="en"><a name="id2478413"></a><h4>TIME SET</h4><p>Tries to set the date and time of the local server to that on
     68the remote server using <code class="literal">/bin/date</code>. </p></div><div class="refsect3" lang="en"><a name="id2478430"></a><h4>TIME ZONE</h4><p>Displays the timezone in hours from GMT on the remote computer.</p></div></div><div class="refsect2" lang="en"><a name="id2478442"></a><h3>[RPC|ADS] JOIN [TYPE] [-U username[%password]] [createupn=UPN] [createcomputer=OU] [options]</h3><p>
    6969Join a domain.  If the account already exists on the server, and
    7070[TYPE] is MEMBER, the machine will attempt to join automatically.
    … …  
    8383and ldap, so it may need to be doubled or quadrupled to pass through,
    8484and it is not used as a delimiter.
    85 </p></div><div class="refsect2" lang="en"><a name="id2478475"></a><h3>[RPC] OLDJOIN [options]</h3><p>Join a domain. Use the OLDJOIN option to join the domain
     85</p></div><div class="refsect2" lang="en"><a name="id2478477"></a><h3>[RPC] OLDJOIN [options]</h3><p>Join a domain. Use the OLDJOIN option to join the domain
    8686using the old style of domain joining - you need to create a trust
    87 account in server manager first.</p></div><div class="refsect2" lang="en"><a name="id2478488"></a><h3>[RPC|ADS] USER</h3><div class="refsect3" lang="en"><a name="id2478494"></a><h4>[RPC|ADS] USER</h4><p>List all users</p></div><div class="refsect3" lang="en"><a name="id2478504"></a><h4>[RPC|ADS] USER DELETE <em class="replaceable"><code>target</code></em></h4><p>Delete specified user</p></div><div class="refsect3" lang="en"><a name="id2478517"></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" lang="en"><a name="id2478531"></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" lang="en"><a name="id2478547"></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" lang="en"><a name="id2478562"></a><h3>[RPC|ADS] GROUP</h3><div class="refsect3" lang="en"><a name="id2478568"></a><h4>[RPC|ADS] GROUP [misc options] [targets]</h4><p>List user groups.</p></div><div class="refsect3" lang="en"><a name="id2478579"></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" lang="en"><a name="id2478593"></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" lang="en"><a name="id2478609"></a><h3>[RAP|RPC] SHARE</h3><div class="refsect3" lang="en"><a name="id2478615"></a><h4>[RAP|RPC] SHARE [misc. options] [targets]</h4><p>Enumerates all exported resources (network shares) on target server.</p></div><div class="refsect3" lang="en"><a name="id2478626"></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
     87account in server manager first.</p></div><div class="refsect2" lang="en"><a name="id2478490"></a><h3>[RPC|ADS] USER</h3><div class="refsect3" lang="en"><a name="id2478496"></a><h4>[RPC|ADS] USER</h4><p>List all users</p></div><div class="refsect3" lang="en"><a name="id2478506"></a><h4>[RPC|ADS] USER DELETE <em class="replaceable"><code>target</code></em></h4><p>Delete specified user</p></div><div class="refsect3" lang="en"><a name="id2478519"></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" lang="en"><a name="id2478533"></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" lang="en"><a name="id2478549"></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" lang="en"><a name="id2478564"></a><h3>[RPC|ADS] GROUP</h3><div class="refsect3" lang="en"><a name="id2478570"></a><h4>[RPC|ADS] GROUP [misc options] [targets]</h4><p>List user groups.</p></div><div class="refsect3" lang="en"><a name="id2478581"></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" lang="en"><a name="id2478595"></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" lang="en"><a name="id2478611"></a><h3>[RAP|RPC] SHARE</h3><div class="refsect3" lang="en"><a name="id2478616"></a><h4>[RAP|RPC] SHARE [misc. options] [targets]</h4><p>Enumerates all exported resources (network shares) on target server.</p></div><div class="refsect3" lang="en"><a name="id2478628"></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
    8888specifies the number of users that can be connected to the
    89 share simultaneously.</p></div><div class="refsect3" lang="en"><a name="id2478644"></a><h4>SHARE DELETE <em class="replaceable"><code>sharename</code></em></h4><p>Delete specified share.</p></div></div><div class="refsect2" lang="en"><a name="id2478658"></a><h3>[RPC|RAP] FILE</h3><div class="refsect3" lang="en"><a name="id2478663"></a><h4>[RPC|RAP] FILE</h4><p>List all open files on remote server.</p></div><div class="refsect3" lang="en"><a name="id2478674"></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
    90 remote server.</p></div><div class="refsect3" lang="en"><a name="id2478691"></a><h4>[RPC|RAP] FILE INFO <em class="replaceable"><code>fileid</code></em></h4><p>
     89share simultaneously.</p></div><div class="refsect3" lang="en"><a name="id2478645"></a><h4>SHARE DELETE <em class="replaceable"><code>sharename</code></em></h4><p>Delete specified share.</p></div></div><div class="refsect2" lang="en"><a name="id2478659"></a><h3>[RPC|RAP] FILE</h3><div class="refsect3" lang="en"><a name="id2478665"></a><h4>[RPC|RAP] FILE</h4><p>List all open files on remote server.</p></div><div class="refsect3" lang="en"><a name="id2478676"></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
     90remote server.</p></div><div class="refsect3" lang="en"><a name="id2478693"></a><h4>[RPC|RAP] FILE INFO <em class="replaceable"><code>fileid</code></em></h4><p>
    9191Print information on specified <em class="replaceable"><code>fileid</code></em>.
    9292Currently listed are: file-id, username, locks, path, permissions.
    93 </p></div><div class="refsect3" lang="en"><a name="id2478709"></a><h4>[RAP|RPC] FILE USER <em class="replaceable"><code>user</code></em></h4><p>
     93</p></div><div class="refsect3" lang="en"><a name="id2478710"></a><h4>[RAP|RPC] FILE USER <em class="replaceable"><code>user</code></em></h4><p>
    9494List files opened by specified <em class="replaceable"><code>user</code></em>.
    9595Please note that <code class="literal">net rap file user</code> does not work
    9696against Samba servers.
    97 </p></div></div><div class="refsect2" lang="en"><a name="id2478734"></a><h3>SESSION</h3><div class="refsect3" lang="en"><a name="id2478739"></a><h4>RAP SESSION</h4><p>Without any other options, SESSION enumerates all active SMB/CIFS
    98 sessions on the target server.</p></div><div class="refsect3" lang="en"><a name="id2478751"></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" lang="en"><a name="id2478764"></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" lang="en"><a name="id2478779"></a><h3>RAP SERVER <em class="replaceable"><code>DOMAIN</code></em></h3><p>List all servers in specified domain or workgroup. Defaults
    99 to local domain.</p></div><div class="refsect2" lang="en"><a name="id2478792"></a><h3>RAP DOMAIN</h3><p>Lists all domains and workgroups visible on the
    100 current network.</p></div><div class="refsect2" lang="en"><a name="id2478804"></a><h3>RAP PRINTQ</h3><div class="refsect3" lang="en"><a name="id2525477"></a><h4>RAP PRINTQ LIST <em class="replaceable"><code>QUEUE_NAME</code></em></h4><p>Lists the specified print queue and print jobs on the server.
     97</p></div></div><div class="refsect2" lang="en"><a name="id2478735"></a><h3>SESSION</h3><div class="refsect3" lang="en"><a name="id2478740"></a><h4>RAP SESSION</h4><p>Without any other options, SESSION enumerates all active SMB/CIFS
     98sessions on the target server.</p></div><div class="refsect3" lang="en"><a name="id2478752"></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" lang="en"><a name="id2478765"></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" lang="en"><a name="id2478780"></a><h3>RAP SERVER <em class="replaceable"><code>DOMAIN</code></em></h3><p>List all servers in specified domain or workgroup. Defaults
     99to local domain.</p></div><div class="refsect2" lang="en"><a name="id2478794"></a><h3>RAP DOMAIN</h3><p>Lists all domains and workgroups visible on the
     100current network.</p></div><div class="refsect2" lang="en"><a name="id2478805"></a><h3>RAP PRINTQ</h3><div class="refsect3" lang="en"><a name="id2525473"></a><h4>RAP PRINTQ LIST <em class="replaceable"><code>QUEUE_NAME</code></em></h4><p>Lists the specified print queue and print jobs on the server.
    101101If the <em class="replaceable"><code>QUEUE_NAME</code></em> is omitted, all
    102 queues are listed.</p></div><div class="refsect3" lang="en"><a name="id2525495"></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" lang="en"><a name="id2525510"></a><h3>RAP VALIDATE <em class="replaceable"><code>user</code></em> [<em class="replaceable"><code>password</code></em>]</h3><p>
     102queues are listed.</p></div><div class="refsect3" lang="en"><a name="id2525491"></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" lang="en"><a name="id2525505"></a><h3>RAP VALIDATE <em class="replaceable"><code>user</code></em> [<em class="replaceable"><code>password</code></em>]</h3><p>
    103103Validate whether the specified user can log in to the
    104104remote server. If the password is not specified on the commandline, it
    105105will be prompted.
    106 </p><div class="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" lang="en"><a name="id2525534"></a><h3>RAP GROUPMEMBER</h3><div class="refsect3" lang="en"><a name="id2525540"></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" lang="en"><a name="id2525553"></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" lang="en"><a name="id2525569"></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" lang="en"><a name="id2525587"></a><h3>RAP ADMIN <em class="replaceable"><code>command</code></em></h3><p>Execute the specified <em class="replaceable"><code>command</code></em> on
     106</p><div class="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" lang="en"><a name="id2525529"></a><h3>RAP GROUPMEMBER</h3><div class="refsect3" lang="en"><a name="id2525535"></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" lang="en"><a name="id2525548"></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" lang="en"><a name="id2525565"></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" lang="en"><a name="id2525582"></a><h3>RAP ADMIN <em class="replaceable"><code>command</code></em></h3><p>Execute the specified <em class="replaceable"><code>command</code></em> on
    107107the remote server. Only works with OS/2 servers.
    108 </p><div class="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" lang="en"><a name="id2525609"></a><h3>RAP SERVICE</h3><div class="refsect3" lang="en"><a name="id2525615"></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" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div><div class="refsect3" lang="en"><a name="id2525635"></a><h4>RAP SERVICE STOP</h4><p>Stop the specified service on the remote server.</p><div class="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" lang="en"><a name="id2525652"></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>
     108</p><div class="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" lang="en"><a name="id2525604"></a><h3>RAP SERVICE</h3><div class="refsect3" lang="en"><a name="id2525610"></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" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div><div class="refsect3" lang="en"><a name="id2525630"></a><h4>RAP SERVICE STOP</h4><p>Stop the specified service on the remote server.</p><div class="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" lang="en"><a name="id2525647"></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>
    109109Change 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>.
    110 </p></div><div class="refsect2" lang="en"><a name="id2525682"></a><h3>LOOKUP</h3><div class="refsect3" lang="en"><a name="id2525688"></a><h4>LOOKUP HOST <em class="replaceable"><code>HOSTNAME</code></em> [<em class="replaceable"><code>TYPE</code></em>]</h4><p>
     110</p></div><div class="refsect2" lang="en"><a name="id2525678"></a><h3>LOOKUP</h3><div class="refsect3" lang="en"><a name="id2525683"></a><h4>LOOKUP HOST <em class="replaceable"><code>HOSTNAME</code></em> [<em class="replaceable"><code>TYPE</code></em>]</h4><p>
    111111Lookup the IP address of the given host with the specified type (netbios suffix).
    112112The type defaults to 0x20 (workstation).
    113 </p></div><div class="refsect3" lang="en"><a name="id2525707"></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" lang="en"><a name="id2525726"></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>.
    114 Defaults to local realm.</p></div><div class="refsect3" lang="en"><a name="id2525744"></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>
    115 DOMAIN</code></em>. Defaults to local domain.</p></div><div class="refsect3" lang="en"><a name="id2525762"></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>
    116 or workgroup. Defaults to local domain.</p></div></div><div class="refsect2" lang="en"><a name="id2525781"></a><h3>CACHE</h3><p>Samba uses a general caching interface called 'gencache'. It
     113</p></div><div class="refsect3" lang="en"><a name="id2525702"></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" lang="en"><a name="id2525721"></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>.
     114Defaults to local realm.</p></div><div class="refsect3" lang="en"><a name="id2525739"></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>
     115DOMAIN</code></em>. Defaults to local domain.</p></div><div class="refsect3" lang="en"><a name="id2525757"></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>
     116or workgroup. Defaults to local domain.</p></div></div><div class="refsect2" lang="en"><a name="id2525776"></a><h3>CACHE</h3><p>Samba uses a general caching interface called 'gencache'. It
    117117can be controlled using 'NET CACHE'.</p><p>All the timeout parameters support the suffixes:
    118118
    119119</p><table class="simplelist" border="0" summary="Simple list"><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>
    120120
    121 </p><div class="refsect3" lang="en"><a name="id2525818"></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" lang="en"><a name="id2525838"></a><h4>CACHE DEL <em class="replaceable"><code>key</code></em></h4><p>Delete key from the cache.</p></div><div class="refsect3" lang="en"><a name="id2525851"></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" lang="en"><a name="id2525870"></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" lang="en"><a name="id2525884"></a><h4>CACHE LIST</h4><p>
     121</p><div class="refsect3" lang="en"><a name="id2525813"></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" lang="en"><a name="id2525833"></a><h4>CACHE DEL <em class="replaceable"><code>key</code></em></h4><p>Delete key from the cache.</p></div><div class="refsect3" lang="en"><a name="id2525846"></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" lang="en"><a name="id2525866"></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" lang="en"><a name="id2525879"></a><h4>CACHE LIST</h4><p>
    122122List all current items in the cache.
    123 </p></div><div class="refsect3" lang="en"><a name="id2525894"></a><h4>CACHE FLUSH</h4><p>Remove all the current items from the cache.</p></div></div><div class="refsect2" lang="en"><a name="id2525906"></a><h3>GETLOCALSID [DOMAIN]</h3><p>Prints the SID of the specified domain, or if the parameter is
    124 omitted, the SID of the local server.</p></div><div class="refsect2" lang="en"><a name="id2525918"></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" lang="en"><a name="id2525929"></a><h3>GETDOMAINSID</h3><p>Prints the local machine SID and the SID of the current
    125 domain.</p></div><div class="refsect2" lang="en"><a name="id2525940"></a><h3>SETDOMAINSID</h3><p>Sets the SID of the current domain.</p></div><div class="refsect2" lang="en"><a name="id2525951"></a><h3>GROUPMAP</h3><p>Manage the mappings between Windows group SIDs and UNIX groups.
     123</p></div><div class="refsect3" lang="en"><a name="id2525890"></a><h4>CACHE FLUSH</h4><p>Remove all the current items from the cache.</p></div></div><div class="refsect2" lang="en"><a name="id2525902"></a><h3>GETLOCALSID [DOMAIN]</h3><p>Prints the SID of the specified domain, or if the parameter is
     124omitted, the SID of the local server.</p></div><div class="refsect2" lang="en"><a name="id2525914"></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" lang="en"><a name="id2525925"></a><h3>GETDOMAINSID</h3><p>Prints the local machine SID and the SID of the current
     125domain.</p></div><div class="refsect2" lang="en"><a name="id2525936"></a><h3>SETDOMAINSID</h3><p>Sets the SID of the current domain.</p></div><div class="refsect2" lang="en"><a name="id2525946"></a><h3>GROUPMAP</h3><p>Manage the mappings between Windows group SIDs and UNIX groups.
    126126Common options include:</p><div class="itemizedlist"><ul type="disc"><li><p>unixgroup - Name of the UNIX group</p></li><li><p>ntgroup - Name of the Windows NT group (must be
    127127  resolvable to a SID</p></li><li><p>rid - Unsigned 32-bit integer</p></li><li><p>sid - Full SID in the form of "S-1-..."</p></li><li><p>type - Type of the group; either 'domain', 'local',
    128   or 'builtin'</p></li><li><p>comment - Freeform text description of the group</p></li></ul></div><div class="refsect3" lang="en"><a name="id2525996"></a><h4>GROUPMAP ADD</h4><p>
     128  or 'builtin'</p></li><li><p>comment - Freeform text description of the group</p></li></ul></div><div class="refsect3" lang="en"><a name="id2525991"></a><h4>GROUPMAP ADD</h4><p>
    129129Add a new group mapping entry:
    130130</p><pre class="programlisting">
    … …  
    132132        [type={domain|local}] [ntgroup=string] [comment=string]
    133133</pre><p>
    134 </p></div><div class="refsect3" lang="en"><a name="id2526014"></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" lang="en"><a name="id2526030"></a><h4>GROUPMAP MODIFY</h4><p>Update en existing group entry.</p><p>
     134</p></div><div class="refsect3" lang="en"><a name="id2526010"></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" lang="en"><a name="id2526026"></a><h4>GROUPMAP MODIFY</h4><p>Update en existing group entry.</p><p>
    135135</p><pre class="programlisting">
    136136net groupmap modify {ntgroup=string|sid=SID} [unixgroup=string] \
    137137       [comment=string] [type={domain|local}]
    138138</pre><p>
    139 </p></div><div class="refsect3" lang="en"><a name="id2526052"></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" lang="en"><a name="id2526068"></a><h3>MAXRID</h3><p>Prints out the highest RID currently in use on the local
     139</p></div><div class="refsect3" lang="en"><a name="id2526047"></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" lang="en"><a name="id2526063"></a><h3>MAXRID</h3><p>Prints out the highest RID currently in use on the local
    140140server (by the active 'passdb backend').
    141 </p></div><div class="refsect2" lang="en"><a name="id2526079"></a><h3>RPC INFO</h3><p>Print information about the domain of the remote server,
     141</p></div><div class="refsect2" lang="en"><a name="id2526075"></a><h3>RPC INFO</h3><p>Print information about the domain of the remote server,
    142142such as domain name, domain sid and number of users and groups.
    143 </p></div><div class="refsect2" lang="en"><a name="id2526091"></a><h3>[RPC|ADS] TESTJOIN</h3><p>Check whether participation in a domain is still valid.</p></div><div class="refsect2" lang="en"><a name="id2526102"></a><h3>[RPC|ADS] CHANGETRUSTPW</h3><p>Force change of domain trust password.</p></div><div class="refsect2" lang="en"><a name="id2526113"></a><h3>RPC TRUSTDOM</h3><div class="refsect3" lang="en"><a name="id2526119"></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>.
     143</p></div><div class="refsect2" lang="en"><a name="id2526087"></a><h3>[RPC|ADS] TESTJOIN</h3><p>Check whether participation in a domain is still valid.</p></div><div class="refsect2" lang="en"><a name="id2526098"></a><h3>[RPC|ADS] CHANGETRUSTPW</h3><p>Force change of domain trust password.</p></div><div class="refsect2" lang="en"><a name="id2526109"></a><h3>RPC TRUSTDOM</h3><div class="refsect3" lang="en"><a name="id2526114"></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>.
    144144This is in fact a Samba account named <em class="replaceable"><code>DOMAIN$</code></em>
    145145with the account flag <code class="constant">'I'</code> (interdomain trust account).
    … …  
    147147<code class="literal">smbpasswd -a -i DOMAIN</code>. Please note that both commands
    148148expect a appropriate UNIX account.
    149 </p></div><div class="refsect3" lang="en"><a name="id2526153"></a><h4>RPC TRUSTDOM DEL <em class="replaceable"><code>DOMAIN</code></em></h4><p>Remove interdomain trust account for
     149</p></div><div class="refsect3" lang="en"><a name="id2526148"></a><h4>RPC TRUSTDOM DEL <em class="replaceable"><code>DOMAIN</code></em></h4><p>Remove interdomain trust account for
    150150<em class="replaceable"><code>DOMAIN</code></em>. If it is used against localhost
    151151it has the same effect as <code class="literal">smbpasswd -x DOMAIN$</code>.
    152 </p></div><div class="refsect3" lang="en"><a name="id2526177"></a><h4>RPC TRUSTDOM ESTABLISH <em class="replaceable"><code>DOMAIN</code></em></h4><p>
     152</p></div><div class="refsect3" lang="en"><a name="id2526172"></a><h4>RPC TRUSTDOM ESTABLISH <em class="replaceable"><code>DOMAIN</code></em></h4><p>
    153153Establish a trust relationship to a trusting domain.
    154154Interdomain account must already be created on the remote PDC.
    155 </p></div><div class="refsect3" lang="en"><a name="id2526191"></a><h4>RPC TRUSTDOM REVOKE <em class="replaceable"><code>DOMAIN</code></em></h4><p>Abandon relationship to trusted domain</p></div><div class="refsect3" lang="en"><a name="id2526205"></a><h4>RPC TRUSTDOM LIST</h4><p>List all current interdomain trust relationships.</p></div><div class="refsect3" lang="en"><a name="id2526216"></a><h4>RPC RIGHTS</h4><p>This subcommand is used to view and manage Samba's rights assignments (also
     155</p></div><div class="refsect3" lang="en"><a name="id2526187"></a><h4>RPC TRUSTDOM REVOKE <em class="replaceable"><code>DOMAIN</code></em></h4><p>Abandon relationship to trusted domain</p></div><div class="refsect3" lang="en"><a name="id2526200"></a><h4>RPC TRUSTDOM LIST</h4><p>List all current interdomain trust relationships.</p></div><div class="refsect3" lang="en"><a name="id2526211"></a><h4>RPC RIGHTS</h4><p>This subcommand is used to view and manage Samba's rights assignments (also
    156156referred to as privileges).  There are three options currently available:
    157157<em class="parameter"><code>list</code></em>, <em class="parameter"><code>grant</code></em>, and
    158158<em class="parameter"><code>revoke</code></em>.  More details on Samba's privilege model and its use
    159 can be found in the Samba-HOWTO-Collection.</p></div></div><div class="refsect2" lang="en"><a name="id2526249"></a><h3>RPC ABORTSHUTDOWN</h3><p>Abort the shutdown of a remote server.</p></div><div class="refsect2" lang="en"><a name="id2526260"></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>
     159can be found in the Samba-HOWTO-Collection.</p></div></div><div class="refsect2" lang="en"><a name="id2526244"></a><h3>RPC ABORTSHUTDOWN</h3><p>Abort the shutdown of a remote server.</p></div><div class="refsect2" lang="en"><a name="id2526255"></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>
    160160Reboot after shutdown.
    161161</p></dd><dt><span class="term">-f</span></dt><dd><p>
    … …  
    165165user of the system can use this time to cancel the shutdown.
    166166</p></dd><dt><span class="term">-C message</span></dt><dd><p>Display the specified message on the screen to
    167 announce the shutdown.</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2526322"></a><h3>RPC SAMDUMP</h3><p>Print out sam database of remote server. You need
    168 to run this against the PDC, from a Samba machine joined as a BDC. </p></div><div class="refsect2" lang="en"><a name="id2526334"></a><h3>RPC VAMPIRE</h3><p>Export users, aliases and groups from remote server to
     167announce the shutdown.</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2526318"></a><h3>RPC SAMDUMP</h3><p>Print out sam database of remote server. You need
     168to run this against the PDC, from a Samba machine joined as a BDC. </p></div><div class="refsect2" lang="en"><a name="id2526330"></a><h3>RPC VAMPIRE</h3><p>Export users, aliases and groups from remote server to
    169169local server.  You need to run this against the PDC, from a Samba machine joined as a BDC.
    170 </p></div><div class="refsect2" lang="en"><a name="id2526347"></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" lang="en"><a name="id2526363"></a><h3>ADS LEAVE</h3><p>Make the remote host leave the domain it is part of. </p></div><div class="refsect2" lang="en"><a name="id2526374"></a><h3>ADS STATUS</h3><p>Print out status of machine account of the local machine in ADS.
     170</p></div><div class="refsect2" lang="en"><a name="id2526342"></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" lang="en"><a name="id2526359"></a><h3>ADS LEAVE</h3><p>Make the remote host leave the domain it is part of. </p></div><div class="refsect2" lang="en"><a name="id2526370"></a><h3>ADS STATUS</h3><p>Print out status of machine account of the local machine in ADS.
    171171Prints out quite some debug info. Aimed at developers, regular
    172 users should use <code class="literal">NET ADS TESTJOIN</code>.</p></div><div class="refsect2" lang="en"><a name="id2526392"></a><h3>ADS PRINTER</h3><div class="refsect3" lang="en"><a name="id2526398"></a><h4>ADS PRINTER INFO [<em class="replaceable"><code>PRINTER</code></em>] [<em class="replaceable"><code>SERVER</code></em>]</h4><p>
     172users should use <code class="literal">NET ADS TESTJOIN</code>.</p></div><div class="refsect2" lang="en"><a name="id2526388"></a><h3>ADS PRINTER</h3><div class="refsect3" lang="en"><a name="id2526393"></a><h4>ADS PRINTER INFO [<em class="replaceable"><code>PRINTER</code></em>] [<em class="replaceable"><code>SERVER</code></em>]</h4><p>
    173173Lookup info for <em class="replaceable"><code>PRINTER</code></em> on <em class="replaceable"><code>SERVER</code></em>. The printer name defaults to "*", the
    174 server name defaults to the local host.</p></div><div class="refsect3" lang="en"><a name="id2526424"></a><h4>ADS PRINTER PUBLISH <em class="replaceable"><code>PRINTER</code></em></h4><p>Publish specified printer using ADS.</p></div><div class="refsect3" lang="en"><a name="id2526437"></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" lang="en"><a name="id2526452"></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
     174server name defaults to the local host.</p></div><div class="refsect3" lang="en"><a name="id2526419"></a><h4>ADS PRINTER PUBLISH <em class="replaceable"><code>PRINTER</code></em></h4><p>Publish specified printer using ADS.</p></div><div class="refsect3" lang="en"><a name="id2526433"></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" lang="en"><a name="id2526447"></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
    175175expression is a standard LDAP search expression, and the
    176176attributes 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>
    177 </p></div><div class="refsect2" lang="en"><a name="id2526481"></a><h3>ADS DN <em class="replaceable"><code>DN</code></em> <em class="replaceable"><code>(attributes)</code></em></h3><p>
     177</p></div><div class="refsect2" lang="en"><a name="id2526476"></a><h3>ADS DN <em class="replaceable"><code>DN</code></em> <em class="replaceable"><code>(attributes)</code></em></h3><p>
    178178Perform a raw LDAP search on a ADS server and dump the results. The
    179179DN standard LDAP DN, and the attributes are a list of LDAP fields
    180180to show in the result.
    181 </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" lang="en"><a name="id2526508"></a><h3>ADS WORKGROUP</h3><p>Print out workgroup name for specified kerberos realm.</p></div><div class="refsect2" lang="en"><a name="id2526520"></a><h3>SAM CREATEBUILTINGROUP &lt;NAME&gt;</h3><p>
     181</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" lang="en"><a name="id2526504"></a><h3>ADS WORKGROUP</h3><p>Print out workgroup name for specified kerberos realm.</p></div><div class="refsect2" lang="en"><a name="id2526515"></a><h3>SAM CREATEBUILTINGROUP &lt;NAME&gt;</h3><p>
    182182(Re)Create a BUILTIN group.
    183183Only a wellknown set of BUILTIN groups can be created with this command.
    … …  
    189189This command requires a running Winbindd with idmap allocation properly
    190190configured. The group gid will be allocated out of the winbindd range.
    191 </p></div><div class="refsect2" lang="en"><a name="id2526538"></a><h3>SAM CREATELOCALGROUP &lt;NAME&gt;</h3><p>
     191</p></div><div class="refsect2" lang="en"><a name="id2526534"></a><h3>SAM CREATELOCALGROUP &lt;NAME&gt;</h3><p>
    192192Create a LOCAL group (also known as Alias).
    193193
    194194This command requires a running Winbindd with idmap allocation properly
    195195configured. The group gid will be allocated out of the winbindd range.
    196 </p></div><div class="refsect2" lang="en"><a name="id2526552"></a><h3>SAM DELETELOCALGROUP &lt;NAME&gt;</h3><p>
     196</p></div><div class="refsect2" lang="en"><a name="id2526547"></a><h3>SAM DELETELOCALGROUP &lt;NAME&gt;</h3><p>
    197197Delete an existing LOCAL group (also known as Alias).
    198198
    199 </p></div><div class="refsect2" lang="en"><a name="id2526564"></a><h3>SAM MAPUNIXGROUP &lt;NAME&gt;</h3><p>
     199</p></div><div class="refsect2" lang="en"><a name="id2526559"></a><h3>SAM MAPUNIXGROUP &lt;NAME&gt;</h3><p>
    200200Map an existing Unix group and make it a Domain Group, the domain group
    201201will have the same name.
    202 </p></div><div class="refsect2" lang="en"><a name="id2526576"></a><h3>SAM UNMAPUNIXGROUP &lt;NAME&gt;</h3><p>
     202</p></div><div class="refsect2" lang="en"><a name="id2526571"></a><h3>SAM UNMAPUNIXGROUP &lt;NAME&gt;</h3><p>
    203203Remove an existing group mapping entry.
    204 </p></div><div class="refsect2" lang="en"><a name="id2526587"></a><h3>SAM ADDMEM &lt;GROUP&gt; &lt;MEMBER&gt;</h3><p>
     204</p></div><div class="refsect2" lang="en"><a name="id2526582"></a><h3>SAM ADDMEM &lt;GROUP&gt; &lt;MEMBER&gt;</h3><p>
    205205Add a member to a Local group. The group can be specified only by name,
    206206the member can be specified by name or SID.
    207 </p></div><div class="refsect2" lang="en"><a name="id2526600"></a><h3>SAM DELMEM  &lt;GROUP&gt; &lt;MEMBER&gt;</h3><p>
     207</p></div><div class="refsect2" lang="en"><a name="id2526595"></a><h3>SAM DELMEM  &lt;GROUP&gt; &lt;MEMBER&gt;</h3><p>
    208208Remove a member from a Local group. The group and the member must be
    209209specified by name.
    210 </p></div><div class="refsect2" lang="en"><a name="id2526612"></a><h3>SAM LISTMEM &lt;GROUP&gt;</h3><p>
     210</p></div><div class="refsect2" lang="en"><a name="id2526608"></a><h3>SAM LISTMEM &lt;GROUP&gt;</h3><p>
    211211List Local group members. The group must be specified by name.
    212 </p></div><div class="refsect2" lang="en"><a name="id2526624"></a><h3>SAM LIST &lt;users|groups|localgroups|builtin|workstations&gt; [verbose]</h3><p>
     212</p></div><div class="refsect2" lang="en"><a name="id2526619"></a><h3>SAM LIST &lt;users|groups|localgroups|builtin|workstations&gt; [verbose]</h3><p>
    213213List the specified set of accounts by name. If verbose is specified,
    214214the rid and description is also provided for each account.
    215 </p></div><div class="refsect2" lang="en"><a name="id2526638"></a><h3>SAM SHOW &lt;NAME&gt;</h3><p>
     215</p></div><div class="refsect2" lang="en"><a name="id2526633"></a><h3>SAM SHOW &lt;NAME&gt;</h3><p>
    216216Show the full DOMAIN\\NAME the SID and the type for the corresponding
    217217account.
    218 </p></div><div class="refsect2" lang="en"><a name="id2526649"></a><h3>SAM SET HOMEDIR &lt;NAME&gt; &lt;DIRECTORY&gt;</h3><p>
     218</p></div><div class="refsect2" lang="en"><a name="id2526645"></a><h3>SAM SET HOMEDIR &lt;NAME&gt; &lt;DIRECTORY&gt;</h3><p>
    219219Set the home directory for a user account.
    220 </p></div><div class="refsect2" lang="en"><a name="id2526661"></a><h3>SAM SET PROFILEPATH &lt;NAME&gt; &lt;PATH&gt;</h3><p>
     220</p></div><div class="refsect2" lang="en"><a name="id2526656"></a><h3>SAM SET PROFILEPATH &lt;NAME&gt; &lt;PATH&gt;</h3><p>
    221221Set the profile path for a user account.
    222 </p></div><div class="refsect2" lang="en"><a name="id2526672"></a><h3>SAM SET COMMENT &lt;NAME&gt; &lt;COMMENT&gt;</h3><p>
     222</p></div><div class="refsect2" lang="en"><a name="id2526667"></a><h3>SAM SET COMMENT &lt;NAME&gt; &lt;COMMENT&gt;</h3><p>
    223223Set the comment for a user or group account.
    224 </p></div><div class="refsect2" lang="en"><a name="id2526683"></a><h3>SAM SET FULLNAME &lt;NAME&gt; &lt;FULL NAME&gt;</h3><p>
     224</p></div><div class="refsect2" lang="en"><a name="id2526678"></a><h3>SAM SET FULLNAME &lt;NAME&gt; &lt;FULL NAME&gt;</h3><p>
    225225Set the full name for a user account.
    226 </p></div><div class="refsect2" lang="en"><a name="id2526694"></a><h3>SAM SET LOGONSCRIPT &lt;NAME&gt; &lt;SCRIPT&gt;</h3><p>
     226</p></div><div class="refsect2" lang="en"><a name="id2526690"></a><h3>SAM SET LOGONSCRIPT &lt;NAME&gt; &lt;SCRIPT&gt;</h3><p>
    227227Set the logon script for a user account.
    228 </p></div><div class="refsect2" lang="en"><a name="id2526705"></a><h3>SAM SET HOMEDRIVE &lt;NAME&gt; &lt;DRIVE&gt;</h3><p>
     228</p></div><div class="refsect2" lang="en"><a name="id2526701"></a><h3>SAM SET HOMEDRIVE &lt;NAME&gt; &lt;DRIVE&gt;</h3><p>
    229229Set the home drive for a user account.
    230 </p></div><div class="refsect2" lang="en"><a name="id2526717"></a><h3>SAM SET WORKSTATIONS &lt;NAME&gt; &lt;WORKSTATIONS&gt;</h3><p>
     230</p></div><div class="refsect2" lang="en"><a name="id2526712"></a><h3>SAM SET WORKSTATIONS &lt;NAME&gt; &lt;WORKSTATIONS&gt;</h3><p>
    231231Set the workstations a user account is allowed to log in from.
    232 </p></div><div class="refsect2" lang="en"><a name="id2526728"></a><h3>SAM SET DISABLE &lt;NAME&gt;</h3><p>
     232</p></div><div class="refsect2" lang="en"><a name="id2526724"></a><h3>SAM SET DISABLE &lt;NAME&gt;</h3><p>
    233233Set the "disabled" flag for a user account.
    234 </p></div><div class="refsect2" lang="en"><a name="id2526740"></a><h3>SAM SET PWNOTREQ &lt;NAME&gt;</h3><p>
     234</p></div><div class="refsect2" lang="en"><a name="id2526735"></a><h3>SAM SET PWNOTREQ &lt;NAME&gt;</h3><p>
    235235Set the "password not required" flag for a user account.
    236 </p></div><div class="refsect2" lang="en"><a name="id2526751"></a><h3>SAM SET AUTOLOCK &lt;NAME&gt;</h3><p>
     236</p></div><div class="refsect2" lang="en"><a name="id2526746"></a><h3>SAM SET AUTOLOCK &lt;NAME&gt;</h3><p>
    237237Set the "autolock" flag for a user account.
    238 </p></div><div class="refsect2" lang="en"><a name="id2526762"></a><h3>SAM SET PWNOEXP &lt;NAME&gt;</h3><p>
     238</p></div><div class="refsect2" lang="en"><a name="id2526758"></a><h3>SAM SET PWNOEXP &lt;NAME&gt;</h3><p>
    239239Set the "password do not expire" flag for a user account.
    240 </p></div><div class="refsect2" lang="en"><a name="id2526774"></a><h3>SAM SET PWDMUSTCHANGENOW &lt;NAME&gt; [yes|no]</h3><p>
     240</p></div><div class="refsect2" lang="en"><a name="id2526769"></a><h3>SAM SET PWDMUSTCHANGENOW &lt;NAME&gt; [yes|no]</h3><p>
    241241Set or unset the "password must change" flag for a user account.
    242 </p></div><div class="refsect2" lang="en"><a name="id2526786"></a><h3>SAM POLICY LIST</h3><p>
     242</p></div><div class="refsect2" lang="en"><a name="id2526781"></a><h3>SAM POLICY LIST</h3><p>
    243243List the available account policies.
    244 </p></div><div class="refsect2" lang="en"><a name="id2526796"></a><h3>SAM POLICY SHOW &lt;account policy&gt;</h3><p>
     244</p></div><div class="refsect2" lang="en"><a name="id2526792"></a><h3>SAM POLICY SHOW &lt;account policy&gt;</h3><p>
    245245Show the account policy value.
    246 </p></div><div class="refsect2" lang="en"><a name="id2526807"></a><h3>SAM POLICY SET &lt;account policy&gt; &lt;value&gt;</h3><p>
     246</p></div><div class="refsect2" lang="en"><a name="id2526803"></a><h3>SAM POLICY SET &lt;account policy&gt; &lt;value&gt;</h3><p>
    247247Set a value for the account policy.
    248248Valid values can be: "forever", "never", "off", or a number.
    249 </p></div><div class="refsect2" lang="en"><a name="id2526820"></a><h3>SAM PROVISION</h3><p>
     249</p></div><div class="refsect2" lang="en"><a name="id2526815"></a><h3>SAM PROVISION</h3><p>
    250250Only available if ldapsam:editposix is set and winbindd is running.
    251251Properly populates the ldap tree with the basic accounts (Administrator)
    252252and groups (Domain Users, Domain Admins, Domain Guests) on the ldap tree.
    253 </p></div><div class="refsect2" lang="en"><a name="id2526834"></a><h3>IDMAP DUMP &lt;local tdb file name&gt;</h3><p>
     253</p></div><div class="refsect2" lang="en"><a name="id2526829"></a><h3>IDMAP DUMP &lt;local tdb file name&gt;</h3><p>
    254254Dumps the mappings contained in the local tdb file specified.
    255255This command is useful to dump only the mappings produced by the idmap_tdb backend.
    256 </p></div><div class="refsect2" lang="en"><a name="id2526848"></a><h3>IDMAP RESTORE [input file]</h3><p>
     256</p></div><div class="refsect2" lang="en"><a name="id2526843"></a><h3>IDMAP RESTORE [input file]</h3><p>
    257257Restore the mappings from the specified file or stdin.
    258 </p></div><div class="refsect2" lang="en"><a name="id2526859"></a><h3>IDMAP SECRET &lt;DOMAIN&gt;|ALLOC &lt;secret&gt;</h3><p>
     258</p></div><div class="refsect2" lang="en"><a name="id2526854"></a><h3>IDMAP SECRET &lt;DOMAIN&gt;|ALLOC &lt;secret&gt;</h3><p>
    259259Store a secret for the specified domain, used primarily for domains
    260260that use idmap_ldap as a backend. In this case the secret is used
    261261as the password for the user DN used to bind to the ldap server.
    262 </p></div><div class="refsect2" lang="en"><a name="id2526873"></a><h3>USERSHARE</h3><p>Starting with version 3.0.23, a Samba server now supports the ability for
     262</p></div><div class="refsect2" lang="en"><a name="id2526868"></a><h3>USERSHARE</h3><p>Starting with version 3.0.23, a Samba server now supports the ability for
    263263non-root users to add user defined shares to be exported using the "net usershare"
    264264commands.
    … …  
    289289</p><table class="simplelist" border="0" summary="Simple list"><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>
    290290
    291 </p><div class="refsect3" lang="en"><a name="id2526931"></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>
     291</p><div class="refsect3" lang="en"><a name="id2526927"></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>
    292292Add or replace a new user defined share, with name "sharename".
    293293</p><p>
    … …  
    326326at connect time so will see the change immediately, there is no need
    327327to restart smbd on adding, deleting or changing a user defined share.
    328 </div><div class="refsect3" lang="en"><a name="id2527006"></a><h4>USERSHARE DELETE <em class="replaceable"><code>sharename</code></em></h4><p>
     328</div><div class="refsect3" lang="en"><a name="id2527001"></a><h4>USERSHARE DELETE <em class="replaceable"><code>sharename</code></em></h4><p>
    329329Deletes the user defined share by name. The Samba smbd daemon
    330330immediately notices this change, although it will not disconnect
    331331any users currently connected to the deleted share.
    332 </p></div><div class="refsect3" lang="en"><a name="id2527021"></a><h4>USERSHARE INFO <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>[wildcard sharename]</code></em></h4><p>
     332</p></div><div class="refsect3" lang="en"><a name="id2527016"></a><h4>USERSHARE INFO <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>[wildcard sharename]</code></em></h4><p>
    333333Get info on user defined shares owned by the current user matching the given pattern, or all users.
    334334</p><p>
    … …  
    349349And is a list of the current settings of the user defined share that can be
    350350modified by the "net usershare add" command.
    351 </p></div><div class="refsect3" lang="en"><a name="id2527056"></a><h4>USERSHARE LIST <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>wildcard sharename</code></em></h4><p>
     351</p></div><div class="refsect3" lang="en"><a name="id2527051"></a><h4>USERSHARE LIST <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>wildcard sharename</code></em></h4><p>
    352352List all the user defined shares owned by the current user matching the given pattern, or all users.
    353353</p><p>
    … …  
    357357If the '-l' or '--long' option is also given, it includes the names of user defined
    358358shares created by other users.
    359 </p></div></div><div class="refsect2" lang="en"><a name="id2527091"></a><h3>CONF</h3><p>Starting with version 3.2.0, a Samba server can be configured by data
     359</p></div></div><div class="refsect2" lang="en"><a name="id2527086"></a><h3>CONF</h3><p>Starting with version 3.2.0, a Samba server can be configured by data
    360360stored in registry. This configuration data can be edited with the new "net
    361361conf" commands.
    … …  
    375375format.</td></tr><tr><td>net conf listshares - List the registry shares.</td></tr><tr><td>net conf drop - Delete the complete configuration from
    376376registry.</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>
    377 </p><div class="refsect3" lang="en"><a name="id2527222"></a><h4>CONF LIST</h4><p>
     377</p><div class="refsect3" lang="en"><a name="id2527217"></a><h4>CONF LIST</h4><p>
    378378Print the configuration data stored in the registry in a smb.conf-like format to
    379379standard output.
    380 </p></div><div class="refsect3" lang="en"><a name="id2527234"></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>
     380</p></div><div class="refsect3" lang="en"><a name="id2527229"></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>
    381381This command imports configuration from a file in smb.conf format.
    382382If a section encountered in the input file is present in registry,
    … …  
    388388the parameter "-T" on the commandline. In test mode, no changes are made to the
    389389registry, and the resulting configuration is printed to standard output instead.
    390 </p></div><div class="refsect3" lang="en"><a name="id2527264"></a><h4>CONF LISTSHARES</h4><p>
     390</p></div><div class="refsect3" lang="en"><a name="id2527259"></a><h4>CONF LISTSHARES</h4><p>
    391391List the names of the shares defined in registry.
    392 </p></div><div class="refsect3" lang="en"><a name="id2527275"></a><h4>CONF DROP</h4><p>
     392</p></div><div class="refsect3" lang="en"><a name="id2527270"></a><h4>CONF DROP</h4><p>
    393393Delete the complete configuration data from registry.
    394 </p></div><div class="refsect3" lang="en"><a name="id2527286"></a><h4>CONF SHOWSHARE <em class="replaceable"><code>sharename</code></em></h4><p>
     394</p></div><div class="refsect3" lang="en"><a name="id2527281"></a><h4>CONF SHOWSHARE <em class="replaceable"><code>sharename</code></em></h4><p>
    395395Show the definition of the share or section specified. It is valid to specify
    396396"global" as sharename to retrieve the global configuration options from
    397397registry.
    398 </p></div><div class="refsect3" lang="en"><a name="id2527301"></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.
     398</p></div><div class="refsect3" lang="en"><a name="id2527296"></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.
    399399The sharename and path have to be given. The share name may
    400400<span class="emphasis"><em>not</em></span> be "global". Optionally, values for the very
    … …  
    402402The same result may be obtained by a sequence of "net conf setparm"
    403403commands.
    404 </p></div><div class="refsect3" lang="en"><a name="id2527337"></a><h4>CONF DELSHARE <em class="replaceable"><code>sharename</code></em></h4><p>
     404</p></div><div class="refsect3" lang="en"><a name="id2527333"></a><h4>CONF DELSHARE <em class="replaceable"><code>sharename</code></em></h4><p>
    405405Delete a share definition from registry.
    406 </p></div><div class="refsect3" lang="en"><a name="id2527351"></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>
     406</p></div><div class="refsect3" lang="en"><a name="id2527346"></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>
    407407Store a parameter in registry. The section may be global or a sharename.
    408408The section is created if it does not exist yet.
    409 </p></div><div class="refsect3" lang="en"><a name="id2527372"></a><h4>CONF GETPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em></h4><p>
     409</p></div><div class="refsect3" lang="en"><a name="id2527367"></a><h4>CONF GETPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em></h4><p>
    410410Show a parameter stored in registry.
    411 </p></div><div class="refsect3" lang="en"><a name="id2527389"></a><h4>CONF DELPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em></h4><p>
     411</p></div><div class="refsect3" lang="en"><a name="id2527384"></a><h4>CONF DELPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em></h4><p>
    412412Delete a parameter stored in registry.
    413 </p></div><div class="refsect3" lang="en"><a name="id2527405"></a><h4>CONF GETINCLUDES <em class="replaceable"><code>section</code></em></h4><p>
     413</p></div><div class="refsect3" lang="en"><a name="id2527401"></a><h4>CONF GETINCLUDES <em class="replaceable"><code>section</code></em></h4><p>
    414414Get the list of includes for the provided section (global or share).
    415415</p><p>
    … …  
    427427configuration. In the future, there will be the ability to include configuration
    428428data from other registry keys.
    429 </p></div><div class="refsect3" lang="en"><a name="id2527441"></a><h4>CONF SETINCLUDES <em class="replaceable"><code>section</code></em> [<em class="replaceable"><code>filename</code></em>]+</h4><p>
     429</p></div><div class="refsect3" lang="en"><a name="id2527436"></a><h4>CONF SETINCLUDES <em class="replaceable"><code>section</code></em> [<em class="replaceable"><code>filename</code></em>]+</h4><p>
    430430Set the list of includes for the provided section (global or share) to the given
    431431list of one or more filenames. The filenames may contain the usual smb.conf
    432432macros like %I.
    433 </p></div><div class="refsect3" lang="en"><a name="id2527461"></a><h4>CONF DELINCLUDES <em class="replaceable"><code>section</code></em></h4><p>
     433</p></div><div class="refsect3" lang="en"><a name="id2527456"></a><h4>CONF DELINCLUDES <em class="replaceable"><code>section</code></em></h4><p>
    434434Delete the list of includes from the provided section (global or share).
    435 </p></div></div><div class="refsect2" lang="en"><a name="id2527476"></a><h3>HELP [COMMAND]</h3><p>Gives usage information for the specified command.</p></div></div><div class="refsect1" lang="en"><a name="id2527488"></a><h2>VERSION</h2><p>This man page is complete for version 3 of the Samba
    436         suite.</p></div><div class="refsect1" lang="en"><a name="id2527499"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     435</p></div></div><div class="refsect2" lang="en"><a name="id2527471"></a><h3>HELP [COMMAND]</h3><p>Gives usage information for the specified command.</p></div></div><div class="refsect1" lang="en"><a name="id2527483"></a><h2>VERSION</h2><p>This man page is complete for version 3 of the Samba
     436        suite.</p></div><div class="refsect1" lang="en"><a name="id2527494"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    437437        were created by Andrew Tridgell. Samba is now developed
    438438        by the Samba Team as an Open Source project similar

  • branches/samba-3.2.x/docs/htmldocs/manpages/nmbd.8.html

    r202 r204  
    11<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>nmbd</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="nmbd.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>nmbd &#8212; NetBIOS name server to provide NetBIOS
    2         over IP naming services to clients</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">nmbd</code> [-D] [-F] [-S] [-a] [-i] [-o] [-h] [-V] [-d &lt;debug level&gt;] [-H &lt;lmhosts file&gt;] [-l &lt;log directory&gt;] [-p &lt;port number&gt;] [-s &lt;configuration file&gt;]</p></div></div><div class="refsect1" lang="en"><a name="id2479217"></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">nmbd</code> is a server that understands
     2        over IP naming services to clients</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">nmbd</code> [-D] [-F] [-S] [-a] [-i] [-o] [-h] [-V] [-d &lt;debug level&gt;] [-H &lt;lmhosts file&gt;] [-l &lt;log directory&gt;] [-p &lt;port number&gt;] [-s &lt;configuration file&gt;]</p></div></div><div class="refsect1" lang="en"><a name="id2479219"></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">nmbd</code> is a server that understands
    33        and can reply to NetBIOS over IP name service requests, like
    44        those produced by SMB/CIFS clients such as Windows 95/98/ME,
    … …  
    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" lang="en"><a name="id2479434"></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" lang="en"><a name="id2479435"></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" lang="en"><a name="id2478535"></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" lang="en"><a name="id2478536"></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
    … …  
    116116                </code> in the <code class="filename">var/locks</code> directory
    117117                configured under wherever Samba was configured to install itself.
    118                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478746"></a><h2>SIGNALS</h2><p>To shut down an <code class="literal">nmbd</code> process it is recommended
     118                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478748"></a><h2>SIGNALS</h2><p>To shut down an <code class="literal">nmbd</code> process it is recommended
    119119        that SIGKILL (-9) <span class="emphasis"><em>NOT</em></span> be used, except as a last
    120120        resort, as this may leave the name database in an inconsistent state.
    … …  
    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" lang="en"><a name="id2525500"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    133         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2525512"></a><h2>SEE ALSO</h2><p>
     132        at a normally low log level.</p></div><div class="refsect1" lang="en"><a name="id2525496"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     133        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2525507"></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
    135135        RFC's <code class="filename">rfc1001.txt</code>, <code class="filename">rfc1002.txt</code>.
    136136        In addition the CIFS (formerly SMB) specification is available
    137137        as a link from the Web page <a class="ulink" href="http://samba.org/cifs/" target="_top">
    138         http://samba.org/cifs/</a>.</p></div><div class="refsect1" lang="en"><a name="id2525591"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     138        http://samba.org/cifs/</a>.</p></div><div class="refsect1" lang="en"><a name="id2525586"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    139139        were created by Andrew Tridgell. Samba is now developed
    140140        by the Samba Team as an Open Source project similar

  • branches/samba-3.2.x/docs/htmldocs/manpages/nmblookup.1.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2479225"></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"><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" lang="en"><a name="id2479226"></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
    … …  
    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" lang="en"><a name="id2478547"></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" lang="en"><a name="id2478548"></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" lang="en"><a name="id2478599"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    96         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478610"></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" lang="en"><a name="id2478643"></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" lang="en"><a name="id2478601"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     96        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478612"></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" lang="en"><a name="id2478644"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/ntlm_auth.1.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2516109"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2516105"></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
    … …  
    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">unix charset</a>.
    68                 </p><div class="example"><a name="id2479482"></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="id2479486"></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">Username</span></dt><dd><p>The user's domain, expected to be in
     68                </p><div class="example"><a name="id2479481"></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="id2479486"></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">Username</span></dt><dd><p>The user's domain, expected to be in
    6969                Samba's <a class="link" href="smb.conf.5.html#UNIXCHARSET">unix charset</a>.
    70                 </p><div class="example"><a name="id2478356"></a><p class="title"><b>Example 3. </b></p><div class="example-contents">Domain: WORKGROUP</div></div><p><br class="example-break"></p><div class="example"><a name="id2478361"></a><p class="title"><b>Example 4. </b></p><div class="example-contents">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
     70                </p><div class="example"><a name="id2478357"></a><p class="title"><b>Example 3. </b></p><div class="example-contents">Domain: WORKGROUP</div></div><p><br class="example-break"></p><div class="example"><a name="id2478361"></a><p class="title"><b>Example 4. </b></p><div class="example-contents">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
    7171                Samba's <a class="link" href="smb.conf.5.html#UNIXCHARSET">unix charset</a> and qualified with the
    7272                <a class="link" href="smb.conf.5.html#WINBINDSEPARATOR">winbind separator</a>.
    73                 </p><div class="example"><a name="id2478401"></a><p class="title"><b>Example 5. </b></p><div class="example-contents">Full-Username: WORKGROUP\bob</div></div><p><br class="example-break"></p><div class="example"><a name="id2478406"></a><p class="title"><b>Example 6. </b></p><div class="example-contents">Full-Username:: V09SS0dST1VQYm9i</div></div><p><br class="example-break"></p></dd><dt><span class="term">LANMAN-Challenge</span></dt><dd><p>The 8 byte <code class="literal">LANMAN Challenge</code> value,
     73                </p><div class="example"><a name="id2478403"></a><p class="title"><b>Example 5. </b></p><div class="example-contents">Full-Username: WORKGROUP\bob</div></div><p><br class="example-break"></p><div class="example"><a name="id2478408"></a><p class="title"><b>Example 6. </b></p><div class="example-contents">Full-Username:: V09SS0dST1VQYm9i</div></div><p><br class="example-break"></p></dd><dt><span class="term">LANMAN-Challenge</span></dt><dd><p>The 8 byte <code class="literal">LANMAN Challenge</code> value,
    7474                generated randomly by the server, or (in cases such as
    7575                MSCHAPv2) generated in some way by both the server and
    7676                the client.
    77                 </p><div class="example"><a name="id2478431"></a><p class="title"><b>Example 7. </b></p><div class="example-contents">LANMAN-Challege: 0102030405060708</div></div><p><br class="example-break"></p></dd><dt><span class="term">LANMAN-Response</span></dt><dd><p>The 24 byte <code class="literal">LANMAN Response</code> value,
     77                </p><div class="example"><a name="id2478432"></a><p class="title"><b>Example 7. </b></p><div class="example-contents">LANMAN-Challege: 0102030405060708</div></div><p><br class="example-break"></p></dd><dt><span class="term">LANMAN-Response</span></dt><dd><p>The 24 byte <code class="literal">LANMAN Response</code> value,
    7878                calculated from the user's password and the supplied
    7979                <code class="literal">LANMAN Challenge</code>.  Typically, this
    8080                is provided over the network by a client wishing to authenticate.
    81                 </p><div class="example"><a name="id2478463"></a><p class="title"><b>Example 8. </b></p><div class="example-contents">LANMAN-Response: 0102030405060708090A0B0C0D0E0F101112131415161718</div></div><p><br class="example-break"></p></dd><dt><span class="term">NT-Response</span></dt><dd><p>The &gt;= 24 byte <code class="literal">NT Response</code>
     81                </p><div class="example"><a name="id2478464"></a><p class="title"><b>Example 8. </b></p><div class="example-contents">LANMAN-Response: 0102030405060708090A0B0C0D0E0F101112131415161718</div></div><p><br class="example-break"></p></dd><dt><span class="term">NT-Response</span></dt><dd><p>The &gt;= 24 byte <code class="literal">NT Response</code>
    8282                calculated from the user's password and the supplied
    8383                <code class="literal">LANMAN Challenge</code>.  Typically, this is
    8484                provided over the network by a client wishing to authenticate.
    85                  </p><div class="example"><a name="id2478496"></a><p class="title"><b>Example 9. </b></p><div class="example-contents">NT-Response: 0102030405060708090A0B0C0D0E0F101112131415161718</div></div><p><br class="example-break"></p></dd><dt><span class="term">Password</span></dt><dd><p>The user's password.  This would be
     85                 </p><div class="example"><a name="id2478497"></a><p class="title"><b>Example 9. </b></p><div class="example-contents">NT-Response: 0102030405060708090A0B0C0D0E0F101112131415161718</div></div><p><br class="example-break"></p></dd><dt><span class="term">Password</span></dt><dd><p>The user's password.  This would be
    8686                provided by a network client, if the helper is being
    8787                used in a legacy situation that exposes plaintext
    8888                passwords in this way.
    89                  </p><div class="example"><a name="id2478516"></a><p class="title"><b>Example 10. </b></p><div class="example-contents">Password: samba2</div></div><p><br class="example-break"></p><div class="example"><a name="id2478521"></a><p class="title"><b>Example 11. </b></p><div class="example-contents">Password:: c2FtYmEy</div></div><p><br class="example-break"></p></dd><dt><span class="term">Request-User-Session-Key</span></dt><dd><p>Apon sucessful authenticaiton, return
     89                 </p><div class="example"><a name="id2478517"></a><p class="title"><b>Example 10. </b></p><div class="example-contents">Password: samba2</div></div><p><br class="example-break"></p><div class="example"><a name="id2478522"></a><p class="title"><b>Example 11. </b></p><div class="example-contents">Password:: c2FtYmEy</div></div><p><br class="example-break"></p></dd><dt><span class="term">Request-User-Session-Key</span></dt><dd><p>Apon sucessful authenticaiton, return
    9090                the user session key associated with the login.
    91                  </p><div class="example"><a name="id2478539"></a><p class="title"><b>Example 12. </b></p><div class="example-contents">Request-User-Session-Key: Yes</div></div><p><br class="example-break"></p></dd><dt><span class="term">Request-LanMan-Session-Key</span></dt><dd><p>Apon sucessful authenticaiton, return
     91                 </p><div class="example"><a name="id2478540"></a><p class="title"><b>Example 12. </b></p><div class="example-contents">Request-User-Session-Key: Yes</div></div><p><br class="example-break"></p></dd><dt><span class="term">Request-LanMan-Session-Key</span></dt><dd><p>Apon sucessful authenticaiton, return
    9292                the LANMAN session key associated with the login.
    93                  </p><div class="example"><a name="id2478557"></a><p class="title"><b>Example 13. </b></p><div class="example-contents">Request-LanMan-Session-Key: Yes</div></div><p><br class="example-break"></p></dd></dl></div></dd></dl></div></dd><dt><span class="term">--username=USERNAME</span></dt><dd><p>
     93                 </p><div class="example"><a name="id2478558"></a><p class="title"><b>Example 13. </b></p><div class="example-contents">Request-LanMan-Session-Key: Yes</div></div><p><br class="example-break"></p></dd></dl></div></dd></dl></div></dd><dt><span class="term">--username=USERNAME</span></dt><dd><p>
    9494        Specify username of user to authenticate
    9595        </p></dd><dt><span class="term">--domain=DOMAIN</span></dt><dd><p>
    … …  
    129129log.smbd, etc...). The log file is never removed by the client.
    130130</p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    131 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2525520"></a><h2>EXAMPLE SETUP</h2><p>To setup ntlm_auth for use by squid 2.5, with both basic and
     131</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2525516"></a><h2>EXAMPLE SETUP</h2><p>To setup ntlm_auth for use by squid 2.5, with both basic and
    132132        NTLMSSP authentication, the following
    133133        should be placed in the <code class="filename">squid.conf</code> file.
    … …  
    145145auth_param ntlm program ntlm_auth --helper-protocol=squid-2.5-ntlmssp --require-membership-of='WORKGROUP\Domain Users'
    146146auth_param basic program ntlm_auth --helper-protocol=squid-2.5-basic --require-membership-of='WORKGROUP\Domain Users'
    147 </pre></div><div class="refsect1" lang="en"><a name="id2525581"></a><h2>TROUBLESHOOTING</h2><p>If you're experiencing problems with authenticating Internet Explorer running
     147</pre></div><div class="refsect1" lang="en"><a name="id2525577"></a><h2>TROUBLESHOOTING</h2><p>If you're experiencing problems with authenticating Internet Explorer running
    148148        under MS Windows 9X or Millenium Edition against ntlm_auth's NTLMSSP authentication
    149149        helper (--helper-protocol=squid-2.5-ntlmssp), then please read
    150150        <a class="ulink" href="http://support.microsoft.com/support/kb/articles/Q239/8/69.ASP" target="_top">
    151151        the Microsoft Knowledge Base article #239869 and follow instructions described there</a>.
    152         </p></div><div class="refsect1" lang="en"><a name="id2525603"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
    153         suite.</p></div><div class="refsect1" lang="en"><a name="id2525614"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     152        </p></div><div class="refsect1" lang="en"><a name="id2525599"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
     153        suite.</p></div><div class="refsect1" lang="en"><a name="id2525610"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    154154        were created by Andrew Tridgell. Samba is now developed
    155155        by the Samba Team as an Open Source project similar

  • branches/samba-3.2.x/docs/htmldocs/manpages/pam_winbind.7.html

    r202 r204  
    1 <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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="pam_winbind.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>pam_winbind &#8212; PAM module for Winbind</p></div><div class="refsect1" lang="en"><a name="id2516076"></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>
     1<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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="pam_winbind.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>pam_winbind &#8212; PAM module for Winbind</p></div><div class="refsect1" lang="en"><a name="id2518297"></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" lang="en"><a name="id2516099"></a><h2>OPTIONS</h2><p>
     3        </p></div><div class="refsect1" lang="en"><a name="id2518320"></a><h2>OPTIONS</h2><p>
    44       
    55                pam_winbind supports several options which can either be set in
    … …  
    5656
    5757
    58         </p></div><div class="refsect1" lang="en"><a name="id2479346"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="wbinfo.1.html"><span class="citerefentry"><span class="refentrytitle">wbinfo</span>(1)</span></a>, <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a>, <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" lang="en"><a name="id2479380"></a><h2>VERSION</h2><p>This man page is correct for version 3 of Samba.</p></div><div class="refsect1" lang="en"><a name="id2479391"></a><h2>AUTHOR</h2><p>
     58        </p></div><div class="refsect1" lang="en"><a name="id2482548"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="wbinfo.1.html"><span class="citerefentry"><span class="refentrytitle">wbinfo</span>(1)</span></a>, <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a>, <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" lang="en"><a name="id2482583"></a><h2>VERSION</h2><p>This man page is correct for version 3 of Samba.</p></div><div class="refsect1" lang="en"><a name="id2482593"></a><h2>AUTHOR</h2><p>
    5959        The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed by
    6060        the Samba Team as an Open Source project similar to the way the Linux kernel is developed.

  • branches/samba-3.2.x/docs/htmldocs/manpages/pdbedit.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">pdbedit</code> [-L] [-v] [-w] [-u username] [-f fullname] [-h homedir] [-D drive] [-S script] [-p profile] [-a] [-t, --password-from-stdin] [-m] [-r] [-x] [-i passdb-backend] [-e passdb-backend] [-b passdb-backend] [-g] [-d debuglevel] [-s configfile] [-P account-policy] [-C value] [-c account-control] [-y]</p></div></div><div class="refsect1" lang="en"><a name="id2479300"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">pdbedit</code> [-L] [-v] [-w] [-u username] [-f fullname] [-h homedir] [-D drive] [-S script] [-p profile] [-a] [-t, --password-from-stdin] [-m] [-r] [-x] [-i passdb-backend] [-e passdb-backend] [-b passdb-backend] [-g] [-d debuglevel] [-s configfile] [-P account-policy] [-C value] [-c account-control] [-y]</p></div></div><div class="refsect1" lang="en"><a name="id2479301"></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" lang="en"><a name="id2479336"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-L</span></dt><dd><p>This option lists all the user accounts
     7        accounts, importing users accounts.</p></div><div class="refsect1" lang="en"><a name="id2479338"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-L</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
    … …  
    145145<code class="constant">".progname"</code> will be appended (e.g. log.smbclient,
    146146log.smbd, etc...). The log file is never removed by the client.
    147 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2525736"></a><h2>NOTES</h2><p>This command may be used only by root.</p></div><div class="refsect1" lang="en"><a name="id2525747"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    148         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2525758"></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" lang="en"><a name="id2525782"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     147</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2525732"></a><h2>NOTES</h2><p>This command may be used only by root.</p></div><div class="refsect1" lang="en"><a name="id2525742"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     148        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2525753"></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" lang="en"><a name="id2525777"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    149149        were created by Andrew Tridgell. Samba is now developed
    150150        by the Samba Team as an Open Source project similar

  • branches/samba-3.2.x/docs/htmldocs/manpages/profiles.1.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">profiles</code> [-v] [-c SID] [-n SID] {file}</p></div></div><div class="refsect1" lang="en"><a name="id2516115"></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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">profiles</code> [-v] [-c SID] [-n SID] {file}</p></div></div><div class="refsect1" lang="en"><a name="id2516111"></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" lang="en"><a name="id2479174"></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" lang="en"><a name="id2479175"></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.
    8 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479235"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
    9         suite.</p></div><div class="refsect1" lang="en"><a name="id2479246"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     8</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479236"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
     9        suite.</p></div><div class="refsect1" lang="en"><a name="id2479247"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/rpcclient.1.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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] [-N] [-I destinationIP] {server}</p></div></div><div class="refsect1" lang="en"><a name="id2479209"></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"><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] [-N] [-I destinationIP] {server}</p></div></div><div class="refsect1" lang="en"><a name="id2479210"></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" lang="en"><a name="id2479240"></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" lang="en"><a name="id2479241"></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
    88                resolved using the <a class="link" href="smb.conf.5.html#NAMERESOLVEORDER">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
    … …  
    9090the <code class="filename">smb.conf</code> manual page for the list of valid
    9191options. </p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    92 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478523"></a><h2>COMMANDS</h2><div class="refsect2" lang="en"><a name="id2478528"></a><h3>LSARPC</h3><div class="variablelist"><dl><dt><span class="term">lsaquery</span></dt><dd><p>Query info policy</p></dd><dt><span class="term">lookupsids</span></dt><dd><p>Resolve a list
     92</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478524"></a><h2>COMMANDS</h2><div class="refsect2" lang="en"><a name="id2478530"></a><h3>LSARPC</h3><div class="variablelist"><dl><dt><span class="term">lsaquery</span></dt><dd><p>Query info policy</p></dd><dt><span class="term">lookupsids</span></dt><dd><p>Resolve a list
    9393                of SIDs to usernames.
    9494                </p></dd><dt><span class="term">lookupnames</span></dt><dd><p>Resolve a list
    9595                of usernames to SIDs.
    96                 </p></dd><dt><span class="term">enumtrusts</span></dt><dd><p>Enumerate trusted domains</p></dd><dt><span class="term">enumprivs</span></dt><dd><p>Enumerate privileges</p></dd><dt><span class="term">getdispname</span></dt><dd><p>Get the privilege name</p></dd><dt><span class="term">lsaenumsid</span></dt><dd><p>Enumerate the LSA SIDS</p></dd><dt><span class="term">lsaenumprivsaccount</span></dt><dd><p>Enumerate the privileges of an SID</p></dd><dt><span class="term">lsaenumacctrights</span></dt><dd><p>Enumerate the rights of an SID</p></dd><dt><span class="term">lsaenumacctwithright</span></dt><dd><p>Enumerate accounts with a right</p></dd><dt><span class="term">lsaaddacctrights</span></dt><dd><p>Add rights to an account</p></dd><dt><span class="term">lsaremoveacctrights</span></dt><dd><p>Remove rights from an account</p></dd><dt><span class="term">lsalookupprivvalue</span></dt><dd><p>Get a privilege value given its name</p></dd><dt><span class="term">lsaquerysecobj</span></dt><dd><p>Query LSA security object</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2478657"></a><h3>LSARPC-DS</h3><div class="variablelist"><dl><dt><span class="term">dsroledominfo</span></dt><dd><p>Get Primary Domain Information</p></dd></dl></div><p> </p><p><span class="emphasis"><em>DFS</em></span></p><div class="variablelist"><dl><dt><span class="term">dfsexist</span></dt><dd><p>Query DFS support</p></dd><dt><span class="term">dfsadd</span></dt><dd><p>Add a DFS share</p></dd><dt><span class="term">dfsremove</span></dt><dd><p>Remove a DFS share</p></dd><dt><span class="term">dfsgetinfo</span></dt><dd><p>Query DFS share info</p></dd><dt><span class="term">dfsenum</span></dt><dd><p>Enumerate dfs shares</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2478727"></a><h3>REG</h3><div class="variablelist"><dl><dt><span class="term">shutdown</span></dt><dd><p>Remote Shutdown</p></dd><dt><span class="term">abortshutdown</span></dt><dd><p>Abort Shutdown</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2478753"></a><h3>SRVSVC</h3><div class="variablelist"><dl><dt><span class="term">srvinfo</span></dt><dd><p>Server query info</p></dd><dt><span class="term">netshareenum</span></dt><dd><p>Enumerate shares</p></dd><dt><span class="term">netfileenum</span></dt><dd><p>Enumerate open files</p></dd><dt><span class="term">netremotetod</span></dt><dd><p>Fetch remote time of day</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2478796"></a><h3>SAMR</h3><div class="variablelist"><dl><dt><span class="term">queryuser</span></dt><dd><p>Query user info</p></dd><dt><span class="term">querygroup</span></dt><dd><p>Query group info</p></dd><dt><span class="term">queryusergroups</span></dt><dd><p>Query user groups</p></dd><dt><span class="term">querygroupmem</span></dt><dd><p>Query group membership</p></dd><dt><span class="term">queryaliasmem</span></dt><dd><p>Query alias membership</p></dd><dt><span class="term">querydispinfo</span></dt><dd><p>Query display info</p></dd><dt><span class="term">querydominfo</span></dt><dd><p>Query domain info</p></dd><dt><span class="term">enumdomusers</span></dt><dd><p>Enumerate domain users</p></dd><dt><span class="term">enumdomgroups</span></dt><dd><p>Enumerate domain groups</p></dd><dt><span class="term">enumalsgroups</span></dt><dd><p>Enumerate alias groups</p></dd><dt><span class="term">createdomuser</span></dt><dd><p>Create domain user</p></dd><dt><span class="term">samlookupnames</span></dt><dd><p>Look up names</p></dd><dt><span class="term">samlookuprids</span></dt><dd><p>Look up names</p></dd><dt><span class="term">deletedomuser</span></dt><dd><p>Delete domain user</p></dd><dt><span class="term">samquerysecobj</span></dt><dd><p>Query SAMR security object</p></dd><dt><span class="term">getdompwinfo</span></dt><dd><p>Retrieve domain password info</p></dd><dt><span class="term">lookupdomain</span></dt><dd><p>Look up domain</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2525616"></a><h3>SPOOLSS</h3><div class="variablelist"><dl><dt><span class="term">adddriver &lt;arch&gt; &lt;config&gt; [&lt;version&gt;]</span></dt><dd><p>
     96                </p></dd><dt><span class="term">enumtrusts</span></dt><dd><p>Enumerate trusted domains</p></dd><dt><span class="term">enumprivs</span></dt><dd><p>Enumerate privileges</p></dd><dt><span class="term">getdispname</span></dt><dd><p>Get the privilege name</p></dd><dt><span class="term">lsaenumsid</span></dt><dd><p>Enumerate the LSA SIDS</p></dd><dt><span class="term">lsaenumprivsaccount</span></dt><dd><p>Enumerate the privileges of an SID</p></dd><dt><span class="term">lsaenumacctrights</span></dt><dd><p>Enumerate the rights of an SID</p></dd><dt><span class="term">lsaenumacctwithright</span></dt><dd><p>Enumerate accounts with a right</p></dd><dt><span class="term">lsaaddacctrights</span></dt><dd><p>Add rights to an account</p></dd><dt><span class="term">lsaremoveacctrights</span></dt><dd><p>Remove rights from an account</p></dd><dt><span class="term">lsalookupprivvalue</span></dt><dd><p>Get a privilege value given its name</p></dd><dt><span class="term">lsaquerysecobj</span></dt><dd><p>Query LSA security object</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2478658"></a><h3>LSARPC-DS</h3><div class="variablelist"><dl><dt><span class="term">dsroledominfo</span></dt><dd><p>Get Primary Domain Information</p></dd></dl></div><p> </p><p><span class="emphasis"><em>DFS</em></span></p><div class="variablelist"><dl><dt><span class="term">dfsexist</span></dt><dd><p>Query DFS support</p></dd><dt><span class="term">dfsadd</span></dt><dd><p>Add a DFS share</p></dd><dt><span class="term">dfsremove</span></dt><dd><p>Remove a DFS share</p></dd><dt><span class="term">dfsgetinfo</span></dt><dd><p>Query DFS share info</p></dd><dt><span class="term">dfsenum</span></dt><dd><p>Enumerate dfs shares</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2478728"></a><h3>REG</h3><div class="variablelist"><dl><dt><span class="term">shutdown</span></dt><dd><p>Remote Shutdown</p></dd><dt><span class="term">abortshutdown</span></dt><dd><p>Abort Shutdown</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2478754"></a><h3>SRVSVC</h3><div class="variablelist"><dl><dt><span class="term">srvinfo</span></dt><dd><p>Server query info</p></dd><dt><span class="term">netshareenum</span></dt><dd><p>Enumerate shares</p></dd><dt><span class="term">netfileenum</span></dt><dd><p>Enumerate open files</p></dd><dt><span class="term">netremotetod</span></dt><dd><p>Fetch remote time of day</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2478797"></a><h3>SAMR</h3><div class="variablelist"><dl><dt><span class="term">queryuser</span></dt><dd><p>Query user info</p></dd><dt><span class="term">querygroup</span></dt><dd><p>Query group info</p></dd><dt><span class="term">queryusergroups</span></dt><dd><p>Query user groups</p></dd><dt><span class="term">querygroupmem</span></dt><dd><p>Query group membership</p></dd><dt><span class="term">queryaliasmem</span></dt><dd><p>Query alias membership</p></dd><dt><span class="term">querydispinfo</span></dt><dd><p>Query display info</p></dd><dt><span class="term">querydominfo</span></dt><dd><p>Query domain info</p></dd><dt><span class="term">enumdomusers</span></dt><dd><p>Enumerate domain users</p></dd><dt><span class="term">enumdomgroups</span></dt><dd><p>Enumerate domain groups</p></dd><dt><span class="term">enumalsgroups</span></dt><dd><p>Enumerate alias groups</p></dd><dt><span class="term">createdomuser</span></dt><dd><p>Create domain user</p></dd><dt><span class="term">samlookupnames</span></dt><dd><p>Look up names</p></dd><dt><span class="term">samlookuprids</span></dt><dd><p>Look up names</p></dd><dt><span class="term">deletedomuser</span></dt><dd><p>Delete domain user</p></dd><dt><span class="term">samquerysecobj</span></dt><dd><p>Query SAMR security object</p></dd><dt><span class="term">getdompwinfo</span></dt><dd><p>Retrieve domain password info</p></dd><dt><span class="term">lookupdomain</span></dt><dd><p>Look up domain</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2525611"></a><h3>SPOOLSS</h3><div class="variablelist"><dl><dt><span class="term">adddriver &lt;arch&gt; &lt;config&gt; [&lt;version&gt;]</span></dt><dd><p>
    9797                Execute an AddPrinterDriver() RPC to install the printer driver
    9898                information on the server.  Note that the driver files should
    … …  
    179179                <code class="literal">enumdrivers</code> commands for obtaining a list of
    180180                of installed printers and drivers.</p></dd><dt><span class="term">addform</span></dt><dd><p>Add form</p></dd><dt><span class="term">setform</span></dt><dd><p>Set form</p></dd><dt><span class="term">getform</span></dt><dd><p>Get form</p></dd><dt><span class="term">deleteform</span></dt><dd><p>Delete form</p></dd><dt><span class="term">enumforms</span></dt><dd><p>Enumerate form</p></dd><dt><span class="term">setprinter</span></dt><dd><p>Set printer comment</p></dd><dt><span class="term">setprinterdata</span></dt><dd><p>Set REG_SZ printer data</p></dd><dt><span class="term">setprintername &lt;printername&gt;
    181                 &lt;newprintername&gt;</span></dt><dd><p>Set printer name</p></dd><dt><span class="term">rffpcnex</span></dt><dd><p>Rffpcnex test</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2526034"></a><h3>NETLOGON</h3><div class="variablelist"><dl><dt><span class="term">logonctrl2</span></dt><dd><p>Logon Control 2</p></dd><dt><span class="term">logonctrl</span></dt><dd><p>Logon Control</p></dd><dt><span class="term">samsync</span></dt><dd><p>Sam Synchronisation</p></dd><dt><span class="term">samdeltas</span></dt><dd><p>Query Sam Deltas</p></dd><dt><span class="term">samlogon</span></dt><dd><p>Sam Logon</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2526095"></a><h3>GENERAL COMMANDS</h3><div class="variablelist"><dl><dt><span class="term">debuglevel</span></dt><dd><p>Set the current
     181                &lt;newprintername&gt;</span></dt><dd><p>Set printer name</p></dd><dt><span class="term">rffpcnex</span></dt><dd><p>Rffpcnex test</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2526029"></a><h3>NETLOGON</h3><div class="variablelist"><dl><dt><span class="term">logonctrl2</span></dt><dd><p>Logon Control 2</p></dd><dt><span class="term">logonctrl</span></dt><dd><p>Logon Control</p></dd><dt><span class="term">samsync</span></dt><dd><p>Sam Synchronisation</p></dd><dt><span class="term">samdeltas</span></dt><dd><p>Query Sam Deltas</p></dd><dt><span class="term">samlogon</span></dt><dd><p>Sam Logon</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2526090"></a><h3>GENERAL COMMANDS</h3><div class="variablelist"><dl><dt><span class="term">debuglevel</span></dt><dd><p>Set the current
    182182                debug level used to log information.</p></dd><dt><span class="term">help (?)</span></dt><dd><p>Print a listing of all
    183183                known commands or extended help  on a particular command.
    184184                </p></dd><dt><span class="term">quit (exit)</span></dt><dd><p>Exit <code class="literal">rpcclient
    185                 </code>.</p></dd></dl></div></div></div><div class="refsect1" lang="en"><a name="id2526138"></a><h2>BUGS</h2><p><code class="literal">rpcclient</code> is designed as a developer testing tool
     185                </code>.</p></dd></dl></div></div></div><div class="refsect1" lang="en"><a name="id2526133"></a><h2>BUGS</h2><p><code class="literal">rpcclient</code> is designed as a developer testing tool
    186186        and may not be robust in certain areas (such as command line parsing). 
    187187        It has been known to  generate a core dump upon failures when invalid
    … …  
    196196        the developers are sending reports to Microsoft,  and problems found
    197197        or reported to Microsoft are fixed in Service Packs,  which may
    198         result in incompatibilities.</p></div><div class="refsect1" lang="en"><a name="id2526197"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
    199         suite.</p></div><div class="refsect1" lang="en"><a name="id2526208"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     198        result in incompatibilities.</p></div><div class="refsect1" lang="en"><a name="id2526193"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
     199        suite.</p></div><div class="refsect1" lang="en"><a name="id2526204"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    200200        were created by Andrew Tridgell. Samba is now developed
    201201        by the Samba Team as an Open Source project similar

  • branches/samba-3.2.x/docs/htmldocs/manpages/samba.7.html

    r202 r204  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>samba</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="samba.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>samba &#8212; A Windows SMB/CIFS fileserver for UNIX</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">samba</code></p></div></div><div class="refsect1" lang="en"><a name="id2516083"></a><h2>DESCRIPTION</h2><p>The Samba software suite is a collection of programs
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>samba</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="samba.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>samba &#8212; A Windows SMB/CIFS fileserver for UNIX</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">samba</code></p></div></div><div class="refsect1" lang="en"><a name="id2516078"></a><h2>DESCRIPTION</h2><p>The Samba software suite is a collection of programs
    22        that implements the Server Message Block (commonly abbreviated
    33        as SMB) protocol for UNIX systems. This protocol is sometimes
    … …  
    6464                mount CIFS/SMB shares on Linux.
    6565                </p></dd><dt><span class="term"><a class="citerefentry" href="smbcquotas.1.html"><span class="citerefentry"><span class="refentrytitle">smbcquotas</span>(1)</span></a></span></dt><dd><p><code class="literal">smbcquotas</code> is a tool that
    66                 can set remote QUOTA's on server with NTFS 5. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478577"></a><h2>COMPONENTS</h2><p>The Samba suite is made up of several components. Each
     66                can set remote QUOTA's on server with NTFS 5. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478579"></a><h2>COMPONENTS</h2><p>The Samba suite is made up of several components. Each
    6767        component is described in a separate manual page. It is strongly
    6868        recommended that you read the documentation that comes with Samba
    … …  
    7373        <a class="ulink" href="http://samba.org/" target="_top">http://www.samba.org/</a> and
    7474        explore the many option available to you.
    75         </p></div><div class="refsect1" lang="en"><a name="id2478611"></a><h2>AVAILABILITY</h2><p>The Samba software suite is licensed under the
     75        </p></div><div class="refsect1" lang="en"><a name="id2478613"></a><h2>AVAILABILITY</h2><p>The Samba software suite is licensed under the
    7676        GNU Public License(GPL). A copy of that license should
    7777        have come with the package in the file COPYING. You are
    … …  
    8787        or Konqueror) then you will also find lots of useful information,
    8888        including back issues of the Samba mailing list, at
    89         <a class="ulink" href="http://lists.samba.org/" target="_top">http://lists.samba.org</a>.</p></div><div class="refsect1" lang="en"><a name="id2478657"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the
    90         Samba suite. </p></div><div class="refsect1" lang="en"><a name="id2478668"></a><h2>CONTRIBUTIONS</h2><p>If you wish to contribute to the Samba project,
     89        <a class="ulink" href="http://lists.samba.org/" target="_top">http://lists.samba.org</a>.</p></div><div class="refsect1" lang="en"><a name="id2478659"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the
     90        Samba suite. </p></div><div class="refsect1" lang="en"><a name="id2478670"></a><h2>CONTRIBUTIONS</h2><p>If you wish to contribute to the Samba project,
    9191        then I suggest you join the Samba mailing list at
    9292        <a class="ulink" href="http://lists.samba.org/" target="_top">http://lists.samba.org</a>.
    … …  
    9494        <a class="ulink" href="http://devel.samba.org/" target="_top">http://devel.samba.org/</a>
    9595        for information on how to do it properly. We prefer patches
    96         in <code class="literal">diff -u</code> format.</p></div><div class="refsect1" lang="en"><a name="id2478704"></a><h2>CONTRIBUTORS</h2><p>Contributors to the project are now too numerous
     96        in <code class="literal">diff -u</code> format.</p></div><div class="refsect1" lang="en"><a name="id2478706"></a><h2>CONTRIBUTORS</h2><p>Contributors to the project are now too numerous
    9797        to mention here but all deserve the thanks of all Samba
    9898        users. To see a full list, look at the
    … …  
    102102        for the contributors to Samba post-CVS. CVS is the Open Source
    103103        source code control system used by the Samba Team to develop
    104         Samba. The project would have been unmanageable without it.</p></div><div class="refsect1" lang="en"><a name="id2478733"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     104        Samba. The project would have been unmanageable without it.</p></div><div class="refsect1" lang="en"><a name="id2478735"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    105105        were created by Andrew Tridgell. Samba is now developed
    106106        by the Samba Team as an Open Source project similar

  • branches/samba-3.2.x/docs/htmldocs/manpages/smb.conf.5.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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" lang="en"><a name="id2516075"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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" lang="en"><a name="id2516069"></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" lang="en"><a name="id2479224"></a><h2>SECTION DESCRIPTIONS</h2><p>
     29        </p></div><div class="refsect1" lang="en"><a name="id2479226"></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 &#8220;<span class="quote">share</span>&#8221;). 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">guest ok = yes</a>
    7171</pre><p>
    72         </p></div><div class="refsect1" lang="en"><a name="id2478265"></a><h2>SPECIAL SECTIONS</h2><div class="refsect2" lang="en"><a name="id2478271"></a><h3>The [global] section</h3><p>
     72        </p></div><div class="refsect1" lang="en"><a name="id2478266"></a><h2>SPECIAL SECTIONS</h2><div class="refsect2" lang="en"><a name="id2478272"></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" lang="en"><a name="id2478594"></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" lang="en"><a name="id2478595"></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" lang="en"><a name="id2525495"></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" lang="en"><a name="id2525490"></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" lang="en"><a name="id2525544"></a><h2>VARIABLE SUBSTITUTIONS</h2><p>
     199        </p></div><div class="refsect1" lang="en"><a name="id2525539"></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        &#8220;<span class="quote">path = /tmp/%u</span>&#8221; is interpreted as &#8220;<span class="quote">path = /tmp/john</span>&#8221; if the user connected with the
    … …  
    306306                If the service is a guest service, a connection is made as the username given in the <code class="literal">guest account
    307307                =</code> for the service, irrespective of the supplied password.
    308                 </p></li></ol></div></div><div class="refsect1" lang="en"><a name="id2526286"></a><h2>REGISTRY-BASED CONFIGURATION</h2><p>
     308                </p></li></ol></div></div><div class="refsect1" lang="en"><a name="id2526282"></a><h2>REGISTRY-BASED CONFIGURATION</h2><p>
    309309                Starting with Samba version 3.2.0, the capability to
    310310                store Samba configuration in the registry is available.
    … …  
    361361                accessing the database file, circumventing the
    362362                server.
    363         </p></div><div class="refsect1" lang="en"><a name="id2526480"></a><h2>EXPLANATION OF EACH PARAMETER</h2><div class="section" lang="en"><div class="titlepage"></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2526492"></a>
     363        </p></div><div class="refsect1" lang="en"><a name="id2526475"></a><h2>EXPLANATION OF EACH PARAMETER</h2><div class="section" lang="en"><div class="titlepage"></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2526488"></a>
    364364
    365365abort shutdown script (G)
    366 </h3></div></div></div><a class="indexterm" name="id2526493"></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
     366</h3></div></div></div><a class="indexterm" name="id2526489"></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
    367367        should stop a shutdown procedure issued by the <a class="link" href="smb.conf.5.html#SHUTDOWNSCRIPT">shutdown script</a>.</p><p>If the connected user posseses the <code class="constant">SeRemoteShutdownPrivilege</code>,
    368368        right, this command will be run as user.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>abort shutdown script</code></em> = <code class="literal">""</code>
    … …  
    370370</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>abort shutdown script</code></em> = <code class="literal">/sbin/shutdown -c</code>
    371371</em></span>
    372 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2526581"></a>
     372</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2526577"></a>
    373373
    374374acl check permissions (S)
    375 </h3></div></div></div><a class="indexterm" name="id2526582"></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"
     375</h3></div></div></div><a class="indexterm" name="id2526578"></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"
    376376    from a Windows client. If a Windows client doesn't have permissions to delete a file then they
    377377    expect this to be denied at open time. POSIX systems normally only detect restrictions on delete by
    … …  
    393393    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>acl check permissions</code></em> = <code class="literal">True</code>
    394394</em></span>
    395 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2478120"></a>
     395</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2478121"></a>
    396396
    397397acl compatibility (S)
    398 </h3></div></div></div><a class="indexterm" name="id2478121"></a><a name="ACLCOMPATIBILITY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies what OS ACL semantics should
     398</h3></div></div></div><a class="indexterm" name="id2478122"></a><a name="ACLCOMPATIBILITY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies what OS ACL semantics should
    399399        be compatible with. Possible values are <span class="emphasis"><em>winnt</em></span> for Windows NT 4,
    400400        <span class="emphasis"><em>win2k</em></span> for Windows 2000 and above and <span class="emphasis"><em>auto</em></span>.
    … …  
    435435        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>acl group control</code></em> = <code class="literal">no</code>
    436436</em></span>
    437 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2526983"></a>
     437</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2526979"></a>
    438438
    439439acl map full control (S)
    440 </h3></div></div></div><a class="indexterm" name="id2526984"></a><a name="ACLMAPFULLCONTROL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     440</h3></div></div></div><a class="indexterm" name="id2526980"></a><a name="ACLMAPFULLCONTROL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    441441        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
    442442        allowed POSIX permission set, into a Windows ACL of "FULL CONTROL". If this parameter is set to true any POSIX
    … …  
    446446        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>acl map full control</code></em> = <code class="literal">True</code>
    447447</em></span>
    448 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527040"></a>
     448</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527035"></a>
    449449
    450450add group script (G)
    451 </h3></div></div></div><a class="indexterm" name="id2527041"></a><a name="ADDGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     451</h3></div></div></div><a class="indexterm" name="id2527036"></a><a name="ADDGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    452452        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
    453453        will expand any <em class="parameter"><code>%g</code></em> to the group name passed. This script is only useful
    … …  
    459459</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>add group script</code></em> = <code class="literal">/usr/sbin/groupadd %g</code>
    460460</em></span>
    461 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527121"></a>
     461</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527116"></a>
    462462
    463463add machine script (G)
    464 </h3></div></div></div><a class="indexterm" name="id2527122"></a><a name="ADDMACHINESCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     464</h3></div></div></div><a class="indexterm" name="id2527117"></a><a name="ADDMACHINESCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    465465        This is the full pathname to a script that will  be run by
    466466         <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when a machine is
    … …  
    473473</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>
    474474</em></span>
    475 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527209"></a>
     475</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527204"></a>
    476476
    477477add port command (G)
    478 </h3></div></div></div><a class="indexterm" name="id2527210"></a><a name="ADDPORTCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>Samba 3.0.23 introduced support for adding printer ports
     478</h3></div></div></div><a class="indexterm" name="id2527205"></a><a name="ADDPORTCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>Samba 3.0.23 introduced support for adding printer ports
    479479        remotely using the Windows "Add Standard TCP/IP Port Wizard".
    480480        This option defines an external program to be executed when
    … …  
    485485</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>
    486486</em></span>
    487 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527298"></a>
     487</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527294"></a>
    488488
    489489addprinter command (G)
    490 </h3></div></div></div><a class="indexterm" name="id2527299"></a><a name="ADDPRINTERCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printing
     490</h3></div></div></div><a class="indexterm" name="id2527295"></a><a name="ADDPRINTERCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printing
    491491    support for Windows NT/2000 clients in Samba 2.2, The MS Add
    492492    Printer Wizard (APW) icon is now also available in the
    … …  
    519519</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>addprinter command</code></em> = <code class="literal">/usr/bin/addprinter</code>
    520520</em></span>
    521 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527503"></a>
     521</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527499"></a>
    522522
    523523add share command (G)
    524 </h3></div></div></div><a class="indexterm" name="id2527504"></a><a name="ADDSHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     524</h3></div></div></div><a class="indexterm" name="id2527500"></a><a name="ADDSHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    525525        Samba 2.2.0 introduced the ability to dynamically add and delete shares via the Windows NT 4.0 Server
    526526        Manager.  The <em class="parameter"><code>add share command</code></em> is used to define an external program
    … …  
    549549</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>add share command</code></em> = <code class="literal">/usr/local/bin/addshare</code>
    550550</em></span>
    551 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527708"></a>
     551</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527703"></a>
    552552
    553553add user script (G)
    554 </h3></div></div></div><a class="indexterm" name="id2527709"></a><a name="ADDUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     554</h3></div></div></div><a class="indexterm" name="id2527704"></a><a name="ADDUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    555555        This is the full pathname to a script that will be run <span class="emphasis"><em>AS ROOT</em></span> by
    556556        <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>
    … …  
    587587</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>
    588588</em></span>
    589 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527952"></a>
     589</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527947"></a>
    590590
    591591add user to group script (G)
    592 </h3></div></div></div><a class="indexterm" name="id2527953"></a><a name="ADDUSERTOGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     592</h3></div></div></div><a class="indexterm" name="id2527948"></a><a name="ADDUSERTOGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    593593        Full path to the script that will be called when a user is added to a group using the Windows NT domain administration
    594594        tools. It will be run by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>
    … …  
    602602</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>
    603603</em></span>
    604 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528046"></a>
     604</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528042"></a>
    605605
    606606administrative share (S)
    607 </h3></div></div></div><a class="indexterm" name="id2528047"></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
     607</h3></div></div></div><a class="indexterm" name="id2528043"></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
    608608      a share, then the share will be an administrative share. The Administrative
    609609      Shares are the default network shares created by all Windows NT-based
    … …  
    612612      information about this option.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>administrative share</code></em> = <code class="literal">no</code>
    613613</em></span>
    614 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528113"></a>
     614</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528108"></a>
    615615
    616616admin users (S)
    617 </h3></div></div></div><a class="indexterm" name="id2528114"></a><a name="ADMINUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of users who will be granted
     617</h3></div></div></div><a class="indexterm" name="id2528109"></a><a name="ADMINUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of users who will be granted
    618618    administrative privileges on the share. This means that they
    619619    will do all file operations as the super-user (root).</p><p>You should use this option very carefully, as any user in
    … …  
    624624</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>admin users</code></em> = <code class="literal">jason</code>
    625625</em></span>
    626 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528192"></a>
     626</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528188"></a>
    627627
    628628afs share (S)
    629 </h3></div></div></div><a class="indexterm" name="id2528194"></a><a name="AFSSHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether special AFS features are enabled
     629</h3></div></div></div><a class="indexterm" name="id2528189"></a><a name="AFSSHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether special AFS features are enabled
    630630        for this share. If enabled, it assumes that the directory exported via
    631631        the <em class="parameter"><code>path</code></em> parameter is a local AFS import. The
    … …  
    634634        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>afs share</code></em> = <code class="literal">no</code>
    635635</em></span>
    636 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528243"></a>
     636</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528239"></a>
    637637
    638638afs username map (G)
    639 </h3></div></div></div><a class="indexterm" name="id2528244"></a><a name="AFSUSERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>If you are using the fake kaserver AFS feature, you might
     639</h3></div></div></div><a class="indexterm" name="id2528240"></a><a name="AFSUSERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>If you are using the fake kaserver AFS feature, you might
    640640        want to hand-craft the usernames you are creating tokens for.
    641641        For example this is necessary if you have users from several domain
    … …  
    647647</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>afs username map</code></em> = <code class="literal">%u@afs.samba.org</code>
    648648</em></span>
    649 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528311"></a>
     649</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528306"></a>
    650650
    651651aio read size (S)
    652 </h3></div></div></div><a class="indexterm" name="id2528312"></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
     652</h3></div></div></div><a class="indexterm" name="id2528308"></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
    653653    integer parameter is set to non-zero value,
    654654    Samba will read from file asynchronously when size of request is bigger
    … …  
    661661    request size</code>
    662662</em></span>
    663 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528410"></a>
     663</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528406"></a>
    664664
    665665aio write size (S)
    666 </h3></div></div></div><a class="indexterm" name="id2528412"></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
     666</h3></div></div></div><a class="indexterm" name="id2528407"></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
    667667    integer parameter is set to non-zero value,
    668668    Samba will write to file asynchronously when size of request is bigger
    … …  
    675675    request size</code>
    676676</em></span>
    677 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528508"></a>
     677</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528504"></a>
    678678
    679679algorithmic rid base (G)
    680 </h3></div></div></div><a class="indexterm" name="id2528509"></a><a name="ALGORITHMICRIDBASE"></a><div class="variablelist"><dl><dt></dt><dd><p>This determines how Samba will use its
     680</h3></div></div></div><a class="indexterm" name="id2528505"></a><a name="ALGORITHMICRIDBASE"></a><div class="variablelist"><dl><dt></dt><dd><p>This determines how Samba will use its
    681681    algorithmic mapping from uids/gid to the RIDs needed to construct
    682682    NT Security Identifiers.
    … …  
    693693</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>algorithmic rid base</code></em> = <code class="literal">100000</code>
    694694</em></span>
    695 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528585"></a>
     695</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528580"></a>
    696696
    697697allocation roundup size (S)
    698 </h3></div></div></div><a class="indexterm" name="id2528586"></a><a name="ALLOCATIONROUNDUPSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows an administrator to tune the
     698</h3></div></div></div><a class="indexterm" name="id2528581"></a><a name="ALLOCATIONROUNDUPSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows an administrator to tune the
    699699    allocation size reported to Windows clients.  The default
    700700    size of 1Mb generally results in improved Windows client
    … …  
    708708# (to disable roundups)</code>
    709709</em></span>
    710 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528656"></a>
     710</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528651"></a>
    711711
    712712allow trusted domains (G)
    713 </h3></div></div></div><a class="indexterm" name="id2528657"></a><a name="ALLOWTRUSTEDDOMAINS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     713</h3></div></div></div><a class="indexterm" name="id2528652"></a><a name="ALLOWTRUSTEDDOMAINS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    714714    This option only takes effect when the <a class="link" href="smb.conf.5.html#SECURITY">security</a> option is set to
    715715    <code class="constant">server</code>, <code class="constant">domain</code> or <code class="constant">ads</code>. 
    … …  
    726726    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>
    727727</em></span>
    728 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528734"></a>
     728</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528729"></a>
    729729
    730730announce as (G)
    731 </h3></div></div></div><a class="indexterm" name="id2528735"></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
     731</h3></div></div></div><a class="indexterm" name="id2528730"></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
    732732    list. By default this is set to Windows NT. The valid options
    733733    are : "NT Server" (which can also be written as "NT"),
    … …  
    741741</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>announce as</code></em> = <code class="literal">Win95</code>
    742742</em></span>
    743 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528809"></a>
     743</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528804"></a>
    744744
    745745announce version (G)
    746 </h3></div></div></div><a class="indexterm" name="id2528810"></a><a name="ANNOUNCEVERSION"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the major and minor version numbers
     746</h3></div></div></div><a class="indexterm" name="id2528805"></a><a name="ANNOUNCEVERSION"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the major and minor version numbers
    747747    that nmbd will use when announcing itself as a server. The default
    748748    is 4.9.  Do not change this parameter unless you have a specific
    … …  
    751751</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>announce version</code></em> = <code class="literal">2.0</code>
    752752</em></span>
    753 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528871"></a>
     753</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528866"></a>
    754754
    755755auth methods (G)
    756 </h3></div></div></div><a class="indexterm" name="id2528872"></a><a name="AUTHMETHODS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     756</h3></div></div></div><a class="indexterm" name="id2528867"></a><a name="AUTHMETHODS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    757757    This option allows the administrator to chose what authentication methods <code class="literal">smbd</code>
    758758    will use when authenticating a user. This option defaults to sensible values based on <a class="link" href="smb.conf.5.html#SECURITY">security</a>. 
    … …  
    775775</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>auth methods</code></em> = <code class="literal">guest sam winbind</code>
    776776</em></span>
    777 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528987"></a>
     777</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528982"></a>
    778778
    779779available (S)
    780 </h3></div></div></div><a class="indexterm" name="id2528988"></a><a name="AVAILABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter lets you "turn off" a service. If
     780</h3></div></div></div><a class="indexterm" name="id2528984"></a><a name="AVAILABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter lets you "turn off" a service. If
    781781        <em class="parameter"><code>available = no</code></em>, then <span class="emphasis"><em>ALL</em></span>
    782782        attempts to connect to the service will fail. Such failures are
    783783        logged.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>available</code></em> = <code class="literal">yes</code>
    784784</em></span>
    785 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529039"></a>
     785</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529034"></a>
    786786
    787787bind interfaces only (G)
    788 </h3></div></div></div><a class="indexterm" name="id2529040"></a><a name="BINDINTERFACESONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This global parameter allows the Samba admin
     788</h3></div></div></div><a class="indexterm" name="id2529036"></a><a name="BINDINTERFACESONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This global parameter allows the Samba admin
    789789        to limit what interfaces on a machine will serve SMB requests. It
    790790        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>
    … …  
    827827        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>bind interfaces only</code></em> = <code class="literal">no</code>
    828828</em></span>
    829 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529417"></a>
     829</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529412"></a>
    830830
    831831blocking locks (S)
    832 </h3></div></div></div><a class="indexterm" name="id2529418"></a><a name="BLOCKINGLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls the behavior
     832</h3></div></div></div><a class="indexterm" name="id2529413"></a><a name="BLOCKINGLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls the behavior
    833833        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
    834834        to obtain a byte range lock on a region of an open file, and the
    … …  
    841841        cannot be obtained.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>blocking locks</code></em> = <code class="literal">yes</code>
    842842</em></span>
    843 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529485"></a>
     843</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529481"></a>
    844844
    845845block size (S)
    846 </h3></div></div></div><a class="indexterm" name="id2529486"></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
     846</h3></div></div></div><a class="indexterm" name="id2529482"></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
    847847    sizes. By default, this reports a disk block size of 1024 bytes.
    848848    </p><p>Changing this parameter may have some effect on the
    … …  
    858858</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>block size</code></em> = <code class="literal">4096</code>
    859859</em></span>
    860 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529568"></a>
     860</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529564"></a>
    861861
    862862<a name="BROWSABLE"></a>browsable
    863 </h3></div></div></div><a class="indexterm" name="id2529569"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529599"></a>
     863</h3></div></div></div><a class="indexterm" name="id2529565"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529595"></a>
    864864
    865865browseable (S)
    866 </h3></div></div></div><a class="indexterm" name="id2529600"></a><a name="BROWSEABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether this share is seen in
     866</h3></div></div></div><a class="indexterm" name="id2529596"></a><a name="BROWSEABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether this share is seen in
    867867        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>
    868868</em></span>
    869 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529641"></a>
     869</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529636"></a>
    870870
    871871browse list (G)
    872 </h3></div></div></div><a class="indexterm" name="id2529642"></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
     872</h3></div></div></div><a class="indexterm" name="id2529638"></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
    873873        a client doing a <code class="literal">NetServerEnum</code> call. Normally
    874874        set to <code class="constant">yes</code>. You should never need to change
    875875        this.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>browse list</code></em> = <code class="literal">yes</code>
    876876</em></span>
    877 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529702"></a>
     877</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529697"></a>
    878878
    879879<a name="CASESIGNAMES"></a>casesignames
    880 </h3></div></div></div><a class="indexterm" name="id2529703"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529733"></a>
     880</h3></div></div></div><a class="indexterm" name="id2529698"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529728"></a>
    881881
    882882case sensitive (S)
    883 </h3></div></div></div><a class="indexterm" name="id2529734"></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">name mangling</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>case sensitive</code></em> = <code class="literal">no</code>
    884 </em></span>
    885 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529787"></a>
     883</h3></div></div></div><a class="indexterm" name="id2529730"></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">name mangling</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>case sensitive</code></em> = <code class="literal">no</code>
     884</em></span>
     885</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529782"></a>
    886886
    887887change notify (S)
    888 </h3></div></div></div><a class="indexterm" name="id2529788"></a><a name="CHANGENOTIFY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should reply
     888</h3></div></div></div><a class="indexterm" name="id2529783"></a><a name="CHANGENOTIFY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should reply
    889889        to a client's file change notify requests.
    890890        </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>
    891891</em></span>
    892 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529833"></a>
     892</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529829"></a>
    893893
    894894change share command (G)
    895 </h3></div></div></div><a class="indexterm" name="id2529834"></a><a name="CHANGESHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     895</h3></div></div></div><a class="indexterm" name="id2529830"></a><a name="CHANGESHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    896896        Samba 2.2.0 introduced the ability to dynamically add and delete shares via the Windows NT 4.0 Server
    897897Manager.  The <em class="parameter"><code>change share command</code></em> is used to define an external
    … …  
    924924</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>change share command</code></em> = <code class="literal">/usr/local/bin/addshare</code>
    925925</em></span>
    926 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530029"></a>
     926</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530025"></a>
    927927
    928928check password script (G)
    929 </h3></div></div></div><a class="indexterm" name="id2530030"></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
     929</h3></div></div></div><a class="indexterm" name="id2530026"></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
    930930    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
    931931    if the password is bad.
    … …  
    936936</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>check password script</code></em> = <code class="literal">check password script = /usr/local/sbin/crackcheck</code>
    937937</em></span>
    938 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530109"></a>
     938</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530105"></a>
    939939
    940940client lanman auth (G)
    941 </h3></div></div></div><a class="indexterm" name="id2530110"></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
     941</h3></div></div></div><a class="indexterm" name="id2530106"></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
    942942    tools will attempt to authenticate itself to servers using the
    943943    weaker LANMAN password hash. If disabled, only server which support NT
    … …  
    950950    attempted.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client lanman auth</code></em> = <code class="literal">no</code>
    951951</em></span>
    952 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530191"></a>
     952</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530187"></a>
    953953
    954954client ldap sasl wrapping (G)
    955 </h3></div></div></div><a class="indexterm" name="id2530192"></a><a name="CLIENTLDAPSASLWRAPPING"></a><div class="variablelist"><dl><dt></dt><dd><p>
     955</h3></div></div></div><a class="indexterm" name="id2530188"></a><a name="CLIENTLDAPSASLWRAPPING"></a><div class="variablelist"><dl><dt></dt><dd><p>
    956956        The <a class="link" href="smb.conf.5.html#CLIENTLDAPSASLWRAPPING">client ldap sasl wrapping</a> defines whether
    957957        ldap traffic will be signed or signed and encrypted (sealed).
    … …  
    981981        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client ldap sasl wrapping</code></em> = <code class="literal">plain</code>
    982982</em></span>
    983 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530321"></a>
     983</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530316"></a>
    984984
    985985client ntlmv2 auth (G)
    986 </h3></div></div></div><a class="indexterm" name="id2530322"></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
     986</h3></div></div></div><a class="indexterm" name="id2530317"></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
    987987    authenticate itself to servers using the NTLMv2 encrypted password
    988988    response.</p><p>If enabled, only an NTLMv2 and LMv2 response (both much more
    … …  
    996996        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>
    997997</em></span>
    998 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530415"></a>
     998</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530410"></a>
    999999
    10001000client plaintext auth (G)
    1001 </h3></div></div></div><a class="indexterm" name="id2530416"></a><a name="CLIENTPLAINTEXTAUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies whether a client should send a plaintext
     1001</h3></div></div></div><a class="indexterm" name="id2530411"></a><a name="CLIENTPLAINTEXTAUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies whether a client should send a plaintext
    10021002                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>
    10031003</em></span>
    1004 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530458"></a>
     1004</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530453"></a>
    10051005
    10061006client schannel (G)
    1007 </h3></div></div></div><a class="indexterm" name="id2530459"></a><a name="CLIENTSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1007</h3></div></div></div><a class="indexterm" name="id2530454"></a><a name="CLIENTSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    10081008    This controls whether the client offers or even demands the use of the netlogon schannel.
    10091009    <a class="link" href="smb.conf.5.html#CLIENTSCHANNEL">client schannel = no</a> does not offer the schannel,
    … …  
    10151015</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>client schannel</code></em> = <code class="literal">yes</code>
    10161016</em></span>
    1017 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530556"></a>
     1017</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530551"></a>
    10181018
    10191019client signing (G)
    1020 </h3></div></div></div><a class="indexterm" name="id2530557"></a><a name="CLIENTSIGNING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether the client offers or requires
     1020</h3></div></div></div><a class="indexterm" name="id2530552"></a><a name="CLIENTSIGNING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether the client offers or requires
    10211021    the server it talks to to use SMB signing. Possible values
    10221022    are <span class="emphasis"><em>auto</em></span>, <span class="emphasis"><em>mandatory</em></span>
    … …  
    10271027</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client signing</code></em> = <code class="literal">auto</code>
    10281028</em></span>
    1029 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530617"></a>
     1029</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530612"></a>
    10301030
    10311031client use spnego (G)
    1032 </h3></div></div></div><a class="indexterm" name="id2530618"></a><a name="CLIENTUSESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p> This variable controls whether Samba clients will try
     1032</h3></div></div></div><a class="indexterm" name="id2530613"></a><a name="CLIENTUSESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p> This variable controls whether Samba clients will try
    10331033    to use Simple and Protected NEGOciation (as specified by rfc2478) with
    10341034    supporting servers (including WindowsXP, Windows2000 and Samba
    … …  
    10361036    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>
    10371037</em></span>
    1038 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530663"></a>
     1038</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530658"></a>
    10391039
    10401040cluster addresses (G)
    1041 </h3></div></div></div><a class="indexterm" name="id2530664"></a><a name="CLUSTERADDRESSES"></a><div class="variablelist"><dl><dt></dt><dd><p>With this parameter you can add additional addresses
     1041</h3></div></div></div><a class="indexterm" name="id2530660"></a><a name="CLUSTERADDRESSES"></a><div class="variablelist"><dl><dt></dt><dd><p>With this parameter you can add additional addresses
    10421042        nmbd will register with a WINS server. These addresses are not
    10431043        necessarily present on all nodes simultaneously, but they will
    … …  
    10481048</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>
    10491049</em></span>
    1050 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530725"></a>
     1050</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530720"></a>
    10511051
    10521052clustering (G)
    1053 </h3></div></div></div><a class="indexterm" name="id2530726"></a><a name="CLUSTERING"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should contact
     1053</h3></div></div></div><a class="indexterm" name="id2530722"></a><a name="CLUSTERING"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should contact
    10541054        ctdb for accessing its tdb files and use ctdb as a backend
    10551055        for its messaging backend.
    … …  
    10581058        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>clustering</code></em> = <code class="literal">no</code>
    10591059</em></span>
    1060 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530779"></a>
     1060</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530774"></a>
    10611061
    10621062comment (S)
    1063 </h3></div></div></div><a class="indexterm" name="id2530780"></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
     1063</h3></div></div></div><a class="indexterm" name="id2530775"></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
    10641064        when a client does a queries the server, either via the network
    10651065        neighborhood or via <code class="literal">net view</code> to list what shares
    … …  
    10701070</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>comment</code></em> = <code class="literal">Fred's Files</code>
    10711071</em></span>
    1072 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530862"></a>
     1072</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530857"></a>
    10731073
    10741074config backend (G)
    1075 </h3></div></div></div><a class="indexterm" name="id2530863"></a><a name="CONFIGBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1075</h3></div></div></div><a class="indexterm" name="id2530858"></a><a name="CONFIGBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    10761076                This controls the backend for storing the configuration.
    10771077                Possible values are <span class="emphasis"><em>file</em></span> (the default)
    … …  
    10911091</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>config backend</code></em> = <code class="literal">registry</code>
    10921092</em></span>
    1093 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530962"></a>
     1093</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530958"></a>
    10941094
    10951095config file (G)
    1096 </h3></div></div></div><a class="indexterm" name="id2530963"></a><a name="CONFIGFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the config file
     1096</h3></div></div></div><a class="indexterm" name="id2530959"></a><a name="CONFIGFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the config file
    10971097        to use, instead of the default (usually <code class="filename">smb.conf</code>).
    10981098        There is a chicken and egg problem here as this option is set
    … …  
    11041104        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>
    11051105</em></span>
    1106 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531032"></a>
     1106</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531027"></a>
    11071107
    11081108copy (S)
    1109 </h3></div></div></div><a class="indexterm" name="id2531033"></a><a name="COPY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows you to "clone" service
     1109</h3></div></div></div><a class="indexterm" name="id2531028"></a><a name="COPY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows you to "clone" service
    11101110        entries. The specified service is simply duplicated under the
    11111111        current service's name. Any parameters specified in the current
    … …  
    11171117</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>copy</code></em> = <code class="literal">otherservice</code>
    11181118</em></span>
    1119 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531099"></a>
     1119</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531094"></a>
    11201120
    11211121<a name="CREATEMODE"></a>create mode
    1122 </h3></div></div></div><a class="indexterm" name="id2531100"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531131"></a>
     1122</h3></div></div></div><a class="indexterm" name="id2531096"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531126"></a>
    11231123
    11241124create mask (S)
    1125 </h3></div></div></div><a class="indexterm" name="id2531132"></a><a name="CREATEMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1125</h3></div></div></div><a class="indexterm" name="id2531127"></a><a name="CREATEMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
    11261126        When a file is created, the necessary permissions are calculated according to the mapping from DOS modes to
    11271127        UNIX permissions, and the resulting UNIX mode is then bit-wise 'AND'ed with this parameter. This parameter may
    … …  
    11441144</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>create mask</code></em> = <code class="literal">0775</code>
    11451145</em></span>
    1146 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531268"></a>
     1146</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531264"></a>
    11471147
    11481148csc policy (S)
    1149 </h3></div></div></div><a class="indexterm" name="id2531270"></a><a name="CSCPOLICY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1149</h3></div></div></div><a class="indexterm" name="id2531265"></a><a name="CSCPOLICY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    11501150        This stands for <span class="emphasis"><em>client-side caching policy</em></span>, and specifies how clients capable of offline
    11511151        caching will cache the files in the share. The valid values are: manual, documents, programs, disable.
    … …  
    11591159</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>csc policy</code></em> = <code class="literal">programs</code>
    11601160</em></span>
    1161 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531354"></a>
     1161</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531349"></a>
    11621162
    11631163ctdbd socket (G)
    1164 </h3></div></div></div><a class="indexterm" name="id2531355"></a><a name="CTDBDSOCKET"></a><div class="variablelist"><dl><dt></dt><dd><p>If you set <code class="literal">clustering=yes</code>,
     1164</h3></div></div></div><a class="indexterm" name="id2531350"></a><a name="CTDBDSOCKET"></a><div class="variablelist"><dl><dt></dt><dd><p>If you set <code class="literal">clustering=yes</code>,
    11651165        you need to tell Samba where ctdbd listens on its unix domain
    11661166        socket. The default path as of ctdb 1.0 is /tmp/ctdb.socket which
    … …  
    11701170</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ctdbd socket</code></em> = <code class="literal">/tmp/ctdb.socket</code>
    11711171</em></span>
    1172 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531420"></a>
     1172</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531415"></a>
    11731173
    11741174cups options (S)
    1175 </h3></div></div></div><a class="indexterm" name="id2531421"></a><a name="CUPSOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1175</h3></div></div></div><a class="indexterm" name="id2531416"></a><a name="CUPSOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    11761176    This parameter is only applicable if <a class="link" href="smb.conf.5.html#PRINTING">printing</a> is
    11771177    set to <code class="constant">cups</code>.  Its value is a free form string of options
    … …  
    11951195</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>cups options</code></em> = <code class="literal">"raw media=a4"</code>
    11961196</em></span>
    1197 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531537"></a>
     1197</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531533"></a>
    11981198
    11991199cups server (G)
    1200 </h3></div></div></div><a class="indexterm" name="id2531538"></a><a name="CUPSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1200</h3></div></div></div><a class="indexterm" name="id2531534"></a><a name="CUPSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12011201    This parameter is only applicable if <a class="link" href="smb.conf.5.html#PRINTING">printing</a> is set to <code class="constant">cups</code>.
    12021202    </p><p>
    … …  
    12121212</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>cups server</code></em> = <code class="literal">mycupsserver:1631</code>
    12131213</em></span>
    1214 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531645"></a>
     1214</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531641"></a>
    12151215
    12161216deadtime (G)
    1217 </h3></div></div></div><a class="indexterm" name="id2531646"></a><a name="DEADTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a decimal integer)
     1217</h3></div></div></div><a class="indexterm" name="id2531642"></a><a name="DEADTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a decimal integer)
    12181218    represents the number of minutes of inactivity before a connection
    12191219    is considered dead, and it is disconnected. The deadtime only takes
    … …  
    12271227</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>deadtime</code></em> = <code class="literal">15</code>
    12281228</em></span>
    1229 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531727"></a>
     1229</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531722"></a>
    12301230
    12311231debug class (G)
    1232 </h3></div></div></div><a class="indexterm" name="id2531728"></a><a name="DEBUGCLASS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1232</h3></div></div></div><a class="indexterm" name="id2531723"></a><a name="DEBUGCLASS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12331233    With this boolean parameter enabled, the debug class (DBGC_CLASS)
    12341234    will be displayed in the debug header.
    … …  
    12381238    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug class</code></em> = <code class="literal">no</code>
    12391239</em></span>
    1240 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531786"></a>
     1240</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531781"></a>
    12411241
    12421242debug hires timestamp (G)
    1243 </h3></div></div></div><a class="indexterm" name="id2531787"></a><a name="DEBUGHIRESTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1243</h3></div></div></div><a class="indexterm" name="id2531782"></a><a name="DEBUGHIRESTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12441244    Sometimes the timestamps in the log messages are needed with a resolution of higher that seconds, this
    12451245    boolean parameter adds microsecond resolution to the timestamp  message header when turned on.
    … …  
    12481248    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug hires timestamp</code></em> = <code class="literal">no</code>
    12491249</em></span>
    1250 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531847"></a>
     1250</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531842"></a>
    12511251
    12521252debug pid (G)
    1253 </h3></div></div></div><a class="indexterm" name="id2531848"></a><a name="DEBUGPID"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1253</h3></div></div></div><a class="indexterm" name="id2531844"></a><a name="DEBUGPID"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12541254    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
    12551255    message. This boolean parameter is adds the process-id to the timestamp message headers in the
    … …  
    12591259    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug pid</code></em> = <code class="literal">no</code>
    12601260</em></span>
    1261 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531916"></a>
     1261</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531911"></a>
    12621262
    12631263debug prefix timestamp (G)
    1264 </h3></div></div></div><a class="indexterm" name="id2531917"></a><a name="DEBUGPREFIXTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1264</h3></div></div></div><a class="indexterm" name="id2531912"></a><a name="DEBUGPREFIXTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12651265    With this option enabled, the timestamp message header is prefixed to the debug message without the
    12661266    filename and function information that is included with the <a class="link" href="smb.conf.5.html#DEBUGTIMESTAMP">debug timestamp</a>
    … …  
    12701270    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug prefix timestamp</code></em> = <code class="literal">no</code>
    12711271</em></span>
    1272 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531989"></a>
     1272</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2531984"></a>
    12731273
    12741274<a name="TIMESTAMPLOGS"></a>timestamp logs
    1275 </h3></div></div></div><a class="indexterm" name="id2531990"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532021"></a>
     1275</h3></div></div></div><a class="indexterm" name="id2531985"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532016"></a>
    12761276
    12771277debug timestamp (G)
    1278 </h3></div></div></div><a class="indexterm" name="id2532022"></a><a name="DEBUGTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1278</h3></div></div></div><a class="indexterm" name="id2532017"></a><a name="DEBUGTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12791279    Samba debug log messages are timestamped by default. If you are running at a high
    12801280    <a class="link" href="smb.conf.5.html#DEBUGLEVEL">debug level</a> these timestamps can be distracting. This
    … …  
    12821282        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug timestamp</code></em> = <code class="literal">yes</code>
    12831283</em></span>
    1284 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532077"></a>
     1284</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532072"></a>
    12851285
    12861286debug uid (G)
    1287 </h3></div></div></div><a class="indexterm" name="id2532078"></a><a name="DEBUGUID"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1287</h3></div></div></div><a class="indexterm" name="id2532073"></a><a name="DEBUGUID"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12881288    Samba is sometimes run as root and sometime run as the connected user, this boolean parameter inserts the
    12891289    current euid, egid, uid and gid to the timestamp message headers in the log file if turned on.
    … …  
    12921292    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug uid</code></em> = <code class="literal">no</code>
    12931293</em></span>
    1294 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532136"></a>
     1294</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532132"></a>
    12951295
    12961296default case (S)
    1297 </h3></div></div></div><a class="indexterm" name="id2532138"></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">name mangling</a>.
     1297</h3></div></div></div><a class="indexterm" name="id2532133"></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">name mangling</a>.
    12981298        Also note the <a class="link" href="smb.conf.5.html#SHORTPRESERVECASE">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>
    12991299</em></span>
    1300 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532201"></a>
     1300</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532196"></a>
    13011301
    13021302default devmode (S)
    1303 </h3></div></div></div><a class="indexterm" name="id2532202"></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">printable</a> services.
     1303</h3></div></div></div><a class="indexterm" name="id2532197"></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">printable</a> services.
    13041304    When smbd is serving Printer Drivers to Windows NT/2k/XP clients, each printer on the Samba
    13051305    server has a Device Mode which defines things such as paper size and
    … …  
    13241324</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>default devmode</code></em> = <code class="literal">yes</code>
    13251325</em></span>
    1326 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532298"></a>
     1326</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532293"></a>
    13271327
    13281328<a name="DEFAULT"></a>default
    1329 </h3></div></div></div><a class="indexterm" name="id2532299"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532330"></a>
     1329</h3></div></div></div><a class="indexterm" name="id2532294"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532325"></a>
    13301330
    13311331default service (G)
    1332 </h3></div></div></div><a class="indexterm" name="id2532331"></a><a name="DEFAULTSERVICE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the name of a service
     1332</h3></div></div></div><a class="indexterm" name="id2532326"></a><a name="DEFAULTSERVICE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the name of a service
    13331333        which will be connected to if the service actually requested cannot
    13341334        be found. Note that the square brackets are <span class="emphasis"><em>NOT</em></span>
    … …  
    13441344</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>default service</code></em> = <code class="literal">pub</code>
    13451345</em></span>
    1346 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532444"></a>
     1346</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532439"></a>
    13471347
    13481348defer sharing violations (G)
    1349 </h3></div></div></div><a class="indexterm" name="id2532445"></a><a name="DEFERSHARINGVIOLATIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1349</h3></div></div></div><a class="indexterm" name="id2532440"></a><a name="DEFERSHARINGVIOLATIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    13501350        Windows allows specifying how a file will be shared with
    13511351        other processes when it is opened. Sharing violations occur when
    … …  
    13601360        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>defer sharing violations</code></em> = <code class="literal">True</code>
    13611361</em></span>
    1362 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532502"></a>
     1362</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532498"></a>
    13631363
    13641364delete group script (G)
    1365 </h3></div></div></div><a class="indexterm" name="id2532503"></a><a name="DELETEGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the full pathname to a script that will
     1365</h3></div></div></div><a class="indexterm" name="id2532499"></a><a name="DELETEGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the full pathname to a script that will
    13661366        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.
    13671367        It will expand any <em class="parameter"><code>%g</code></em> to the group name passed. 
    … …  
    13691369        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>delete group script</code></em> = <code class="literal"></code>
    13701370</em></span>
    1371 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532563"></a>
     1371</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532559"></a>
    13721372
    13731373deleteprinter command (G)
    1374 </h3></div></div></div><a class="indexterm" name="id2532564"></a><a name="DELETEPRINTERCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printer
     1374</h3></div></div></div><a class="indexterm" name="id2532560"></a><a name="DELETEPRINTERCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printer
    13751375    support for Windows NT/2000 clients in Samba 2.2, it is now
    13761376    possible to delete a printer at run time by issuing the
    … …  
    13901390</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>deleteprinter command</code></em> = <code class="literal">/usr/bin/removeprinter</code>
    13911391</em></span>
    1392 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532715"></a>
     1392</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532710"></a>
    13931393
    13941394delete readonly (S)
    1395 </h3></div></div></div><a class="indexterm" name="id2532716"></a><a name="DELETEREADONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows readonly files to be deleted. 
     1395</h3></div></div></div><a class="indexterm" name="id2532712"></a><a name="DELETEREADONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows readonly files to be deleted. 
    13961396        This is not normal DOS semantics, but is allowed by UNIX.</p><p>This option may be useful for running applications such
    13971397        as rcs, where UNIX file ownership prevents changing file
    13981398        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>
    13991399</em></span>
    1400 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532764"></a>
     1400</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532760"></a>
    14011401
    14021402delete share command (G)
    1403 </h3></div></div></div><a class="indexterm" name="id2532766"></a><a name="DELETESHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1403</h3></div></div></div><a class="indexterm" name="id2532761"></a><a name="DELETESHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    14041404        Samba 2.2.0 introduced the ability to dynamically add and delete shares via the Windows NT 4.0 Server
    14051405        Manager.  The <em class="parameter"><code>delete share command</code></em> is used to define an external
    … …  
    14251425</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>delete share command</code></em> = <code class="literal">/usr/local/bin/delshare</code>
    14261426</em></span>
    1427 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532936"></a>
     1427</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2532931"></a>
    14281428
    14291429delete user from group script (G)
    1430 </h3></div></div></div><a class="indexterm" name="id2532937"></a><a name="DELETEUSERFROMGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>Full path to the script that will be called when
     1430</h3></div></div></div><a class="indexterm" name="id2532932"></a><a name="DELETEUSERFROMGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>Full path to the script that will be called when
    14311431        a user is removed from a group using the Windows NT domain administration
    14321432        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>.
    … …  
    14371437</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>
    14381438</em></span>
    1439 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533021"></a>
     1439</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533016"></a>
    14401440
    14411441delete user script (G)
    1442 </h3></div></div></div><a class="indexterm" name="id2533022"></a><a name="DELETEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the full pathname to a script that will
     1442</h3></div></div></div><a class="indexterm" name="id2533017"></a><a name="DELETEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the full pathname to a script that will
    14431443        be run by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when managing users
    14441444        with remote RPC (NT) tools.
    … …  
    14491449</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>
    14501450</em></span>
    1451 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533103"></a>
     1451</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533099"></a>
    14521452
    14531453delete veto files (S)
    1454 </h3></div></div></div><a class="indexterm" name="id2533104"></a><a name="DELETEVETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used when Samba is attempting to
     1454</h3></div></div></div><a class="indexterm" name="id2533100"></a><a name="DELETEVETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used when Samba is attempting to
    14551455        delete a directory that contains one or more vetoed directories
    14561456        (see the <a class="link" href="smb.conf.5.html#VETOFILES">veto files</a>
    … …  
    14661466        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>
    14671467</em></span>
    1468 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533201"></a>
     1468</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533196"></a>
    14691469
    14701470dfree cache time (S)
    1471 </h3></div></div></div><a class="indexterm" name="id2533202"></a><a name="DFREECACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1471</h3></div></div></div><a class="indexterm" name="id2533197"></a><a name="DFREECACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    14721472        The <em class="parameter"><code>dfree cache time</code></em> should only be used on systems where a problem
    14731473        occurs with the internal disk space calculations. This has been known to happen with Ultrix, but may occur
    … …  
    14821482        </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>
    14831483</em></span>
    1484 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533283"></a>
     1484</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533279"></a>
    14851485
    14861486dfree command (S)
    1487 </h3></div></div></div><a class="indexterm" name="id2533284"></a><a name="DFREECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1487</h3></div></div></div><a class="indexterm" name="id2533280"></a><a name="DFREECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    14881488        The <em class="parameter"><code>dfree command</code></em> setting should only be used on systems where a
    14891489        problem occurs with the internal disk space calculations. This has been known to happen with Ultrix, but may
    … …  
    15231523        </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>
    15241524</em></span>
    1525 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533416"></a>
     1525</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533411"></a>
    15261526
    15271527<a name="DIRECTORYMODE"></a>directory mode
    1528 </h3></div></div></div><a class="indexterm" name="id2533417"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533448"></a>
     1528</h3></div></div></div><a class="indexterm" name="id2533412"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533443"></a>
    15291529
    15301530directory mask (S)
    1531 </h3></div></div></div><a class="indexterm" name="id2533449"></a><a name="DIRECTORYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is the octal modes which are
     1531</h3></div></div></div><a class="indexterm" name="id2533444"></a><a name="DIRECTORYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is the octal modes which are
    15321532    used when converting DOS modes to UNIX modes when creating UNIX
    15331533    directories.</p><p>When a directory is created, the necessary permissions are
    … …  
    15471547</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>directory mask</code></em> = <code class="literal">0775</code>
    15481548</em></span>
    1549 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533566"></a>
     1549</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533561"></a>
    15501550
    15511551directory security mask (S)
    1552 </h3></div></div></div><a class="indexterm" name="id2533567"></a><a name="DIRECTORYSECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls what UNIX permission bits
     1552</h3></div></div></div><a class="indexterm" name="id2533562"></a><a name="DIRECTORYSECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls what UNIX permission bits
    15531553    will be set when a Windows NT client is manipulating the UNIX
    15541554    permission on a directory using the native NT security dialog
    … …  
    15701570</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>directory security mask</code></em> = <code class="literal">0700</code>
    15711571</em></span>
    1572 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533676"></a>
     1572</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533671"></a>
    15731573
    15741574disable netbios (G)
    1575 </h3></div></div></div><a class="indexterm" name="id2533677"></a><a name="DISABLENETBIOS"></a><div class="variablelist"><dl><dt></dt><dd><p>Enabling this parameter will disable netbios support
     1575</h3></div></div></div><a class="indexterm" name="id2533672"></a><a name="DISABLENETBIOS"></a><div class="variablelist"><dl><dt></dt><dd><p>Enabling this parameter will disable netbios support
    15761576    in Samba. Netbios is the only available form of browsing in
    15771577    all windows versions except for 2000 and XP. </p><div class="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
    … …  
    15791579        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>disable netbios</code></em> = <code class="literal">no</code>
    15801580</em></span>
    1581 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533725"></a>
     1581</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533721"></a>
    15821582
    15831583disable spoolss (G)
    1584 </h3></div></div></div><a class="indexterm" name="id2533726"></a><a name="DISABLESPOOLSS"></a><div class="variablelist"><dl><dt></dt><dd><p>Enabling this parameter will disable Samba's support
     1584</h3></div></div></div><a class="indexterm" name="id2533722"></a><a name="DISABLESPOOLSS"></a><div class="variablelist"><dl><dt></dt><dd><p>Enabling this parameter will disable Samba's support
    15851585    for the SPOOLSS set of MS-RPC's and will yield identical behavior
    15861586    as Samba 2.0.x.  Windows NT/2000 clients will downgrade to using
    … …  
    15941594</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>disable spoolss</code></em> = <code class="literal">no</code>
    15951595</em></span>
    1596 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533781"></a>
     1596</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533776"></a>
    15971597
    15981598display charset (G)
    1599 </h3></div></div></div><a class="indexterm" name="id2533782"></a><a name="DISPLAYCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1599</h3></div></div></div><a class="indexterm" name="id2533777"></a><a name="DISPLAYCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>
    16001600        Specifies the charset that samba will use to print messages to stdout and stderr.
    16011601        The default value is "LOCALE", which means automatically set, depending on the
    … …  
    16061606</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>display charset</code></em> = <code class="literal">UTF8</code>
    16071607</em></span>
    1608 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533857"></a>
     1608</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533852"></a>
    16091609
    16101610dmapi support (S)
    1611 </h3></div></div></div><a class="indexterm" name="id2533858"></a><a name="DMAPISUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should use DMAPI to
     1611</h3></div></div></div><a class="indexterm" name="id2533853"></a><a name="DMAPISUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should use DMAPI to
    16121612        determine whether a file is offline or not. This would typically
    16131613        be used in conjunction with a hierarchical storage system that
    … …  
    16241624        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dmapi support</code></em> = <code class="literal">no</code>
    16251625</em></span>
    1626 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533920"></a>
     1626</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533915"></a>
    16271627
    16281628dns proxy (G)
    1629 </h3></div></div></div><a class="indexterm" name="id2533921"></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
     1629</h3></div></div></div><a class="indexterm" name="id2533916"></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
    16301630        finding that a NetBIOS name has not been registered, should treat the
    16311631        NetBIOS name word-for-word as a DNS name and do a lookup with the DNS server
    … …  
    16361636        action.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dns proxy</code></em> = <code class="literal">yes</code>
    16371637</em></span>
    1638 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533988"></a>
     1638</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533984"></a>
    16391639
    16401640domain logons (G)
    1641 </h3></div></div></div><a class="indexterm" name="id2533990"></a><a name="DOMAINLOGONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1641</h3></div></div></div><a class="indexterm" name="id2533985"></a><a name="DOMAINLOGONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    16421642        If set to <code class="constant">yes</code>, the Samba server will
    16431643        provide the netlogon service for Windows 9X network logons for the
    … …  
    16491649        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>domain logons</code></em> = <code class="literal">no</code>
    16501650</em></span>
    1651 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534050"></a>
     1651</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534045"></a>
    16521652
    16531653domain master (G)
    1654 </h3></div></div></div><a class="indexterm" name="id2534051"></a><a name="DOMAINMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1654</h3></div></div></div><a class="indexterm" name="id2534046"></a><a name="DOMAINMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    16551655        Tell <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> to enable
    16561656        WAN-wide browse list collation. Setting this option causes <code class="literal">nmbd</code> to claim a
    … …  
    16781678        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>domain master</code></em> = <code class="literal">auto</code>
    16791679</em></span>
    1680 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534280"></a>
     1680</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534276"></a>
    16811681
    16821682dont descend (S)
    1683 </h3></div></div></div><a class="indexterm" name="id2534281"></a><a name="DONTDESCEND"></a><div class="variablelist"><dl><dt></dt><dd><p>There are certain directories on some systems
     1683</h3></div></div></div><a class="indexterm" name="id2534277"></a><a name="DONTDESCEND"></a><div class="variablelist"><dl><dt></dt><dd><p>There are certain directories on some systems
    16841684        (e.g., the <code class="filename">/proc</code> tree under Linux) that are either not
    16851685        of interest to clients or are infinitely deep (recursive). This
    … …  
    16921692</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>dont descend</code></em> = <code class="literal">/proc,/dev</code>
    16931693</em></span>
    1694 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534365"></a>
     1694</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534361"></a>
    16951695
    16961696dos charset (G)
    1697 </h3></div></div></div><a class="indexterm" name="id2534366"></a><a name="DOSCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>DOS SMB clients assume the server has
     1697</h3></div></div></div><a class="indexterm" name="id2534362"></a><a name="DOSCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>DOS SMB clients assume the server has
    16981698        the same charset as they do. This option specifies which
    16991699        charset Samba should talk to DOS clients.
    17001700        </p><p>The default depends on which charsets you have installed.
    17011701        Samba tries to use charset 850 but falls back to ASCII in
    1702         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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534409"></a>
     1702        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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534405"></a>
    17031703
    17041704dos filemode (S)
    1705 </h3></div></div></div><a class="indexterm" name="id2534410"></a><a name="DOSFILEMODE"></a><div class="variablelist"><dl><dt></dt><dd><p> The default behavior in Samba is to provide
     1705</h3></div></div></div><a class="indexterm" name="id2534406"></a><a name="DOSFILEMODE"></a><div class="variablelist"><dl><dt></dt><dd><p> The default behavior in Samba is to provide
    17061706        UNIX-like behavior where only the owner of a file/directory is
    17071707        able to change the permissions on it.  However, this behavior
    … …  
    17141714        file/directory may also be changed.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dos filemode</code></em> = <code class="literal">no</code>
    17151715</em></span>
    1716 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534460"></a>
     1716</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534455"></a>
    17171717
    17181718dos filetime resolution (S)
    1719 </h3></div></div></div><a class="indexterm" name="id2534461"></a><a name="DOSFILETIMERESOLUTION"></a><div class="variablelist"><dl><dt></dt><dd><p>Under the DOS and Windows FAT filesystem, the finest
     1719</h3></div></div></div><a class="indexterm" name="id2534456"></a><a name="DOSFILETIMERESOLUTION"></a><div class="variablelist"><dl><dt></dt><dd><p>Under the DOS and Windows FAT filesystem, the finest
    17201720        granularity on time resolution is two seconds. Setting this parameter
    17211721        for a share causes Samba to round the reported time down to the
    … …  
    17321732        happy.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dos filetime resolution</code></em> = <code class="literal">no</code>
    17331733</em></span>
    1734 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534528"></a>
     1734</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534523"></a>
    17351735
    17361736dos filetimes (S)
    1737 </h3></div></div></div><a class="indexterm" name="id2534529"></a><a name="DOSFILETIMES"></a><div class="variablelist"><dl><dt></dt><dd><p>Under DOS and Windows, if a user can write to a
     1737</h3></div></div></div><a class="indexterm" name="id2534524"></a><a name="DOSFILETIMES"></a><div class="variablelist"><dl><dt></dt><dd><p>Under DOS and Windows, if a user can write to a
    17381738        file they can change the timestamp on it. Under POSIX semantics,
    17391739        only the owner of the file or root may change the timestamp. By
    … …  
    17491749        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dos filetimes</code></em> = <code class="literal">yes</code>
    17501750</em></span>
    1751 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534599"></a>
     1751</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534594"></a>
    17521752
    17531753ea support (S)
    1754 </h3></div></div></div><a class="indexterm" name="id2534600"></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
     1754</h3></div></div></div><a class="indexterm" name="id2534595"></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
    17551755    attributes on a share. In order to enable this parameter the underlying filesystem exported by
    17561756    the share must support extended attributes (such as provided on XFS and EXT3 on Linux, with the
    … …  
    17591759                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>
    17601760</em></span>
    1761 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534656"></a>
     1761</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534651"></a>
    17621762
    17631763enable asu support (G)
    1764 </h3></div></div></div><a class="indexterm" name="id2534657"></a><a name="ENABLEASUSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>Hosts running the "Advanced Server for Unix (ASU)" product
     1764</h3></div></div></div><a class="indexterm" name="id2534652"></a><a name="ENABLEASUSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>Hosts running the "Advanced Server for Unix (ASU)" product
    17651765    require some special accomodations such as creating a builting [ADMIN$]
    17661766    share that only supports IPC connections.  The has been the default
    … …  
    17701770    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>
    17711771</em></span>
    1772 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534705"></a>
     1772</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534701"></a>
    17731773
    17741774enable privileges (G)
    1775 </h3></div></div></div><a class="indexterm" name="id2534706"></a><a name="ENABLEPRIVILEGES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1775</h3></div></div></div><a class="indexterm" name="id2534702"></a><a name="ENABLEPRIVILEGES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    17761776        This parameter controls whether or not smbd will honor privileges assigned to specific SIDs via either
    17771777         <code class="literal">net rpc rights</code> or one of the Windows user and group manager tools.  This parameter is
    … …  
    17861786        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>enable privileges</code></em> = <code class="literal">yes</code>
    17871787</em></span>
    1788 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534771"></a>
     1788</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534766"></a>
    17891789
    17901790encrypt passwords (G)
    1791 </h3></div></div></div><a class="indexterm" name="id2534772"></a><a name="ENCRYPTPASSWORDS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean controls whether encrypted passwords
     1791</h3></div></div></div><a class="indexterm" name="id2534767"></a><a name="ENCRYPTPASSWORDS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean controls whether encrypted passwords
    17921792    will be negotiated with the client. Note that Windows NT 4.0 SP3 and
    17931793    above and also Windows 98 will by default expect encrypted passwords
    … …  
    18121812        server.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>encrypt passwords</code></em> = <code class="literal">yes</code>
    18131813</em></span>
    1814 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534883"></a>
     1814</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534879"></a>
    18151815
    18161816enhanced browsing (G)
    1817 </h3></div></div></div><a class="indexterm" name="id2534884"></a><a name="ENHANCEDBROWSING"></a><div class="variablelist"><dl><dt></dt><dd><p>This option enables a couple of enhancements to
     1817</h3></div></div></div><a class="indexterm" name="id2534880"></a><a name="ENHANCEDBROWSING"></a><div class="variablelist"><dl><dt></dt><dd><p>This option enables a couple of enhancements to
    18181818        cross-subnet browse propagation that have been added in Samba
    18191819        but which are not standard in Microsoft implementations. 
    … …  
    18281828        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>
    18291829</em></span>
    1830 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534954"></a>
     1830</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534950"></a>
    18311831
    18321832enumports command (G)
    1833 </h3></div></div></div><a class="indexterm" name="id2534955"></a><a name="ENUMPORTSCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>The concept of a "port" is fairly foreign
     1833</h3></div></div></div><a class="indexterm" name="id2534951"></a><a name="ENUMPORTSCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>The concept of a "port" is fairly foreign
    18341834    to UNIX hosts.  Under Windows NT/2000 print servers, a port
    18351835    is associated with a port monitor and generally takes the form of
    … …  
    18481848</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>enumports command</code></em> = <code class="literal">/usr/bin/listports</code>
    18491849</em></span>
    1850 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535044"></a>
     1850</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535039"></a>
    18511851
    18521852eventlog list (G)
    1853 </h3></div></div></div><a class="indexterm" name="id2535045"></a><a name="EVENTLOGLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of log names that Samba will
     1853</h3></div></div></div><a class="indexterm" name="id2535040"></a><a name="EVENTLOGLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of log names that Samba will
    18541854    report to the Microsoft EventViewer utility.  The listed
    18551855    eventlogs will be associated with tdb file on disk in the
    … …  
    18641864</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>eventlog list</code></em> = <code class="literal">Security Application Syslog Apache</code>
    18651865</em></span>
    1866 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535123"></a>
     1866</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535118"></a>
    18671867
    18681868fake directory create times (S)
    1869 </h3></div></div></div><a class="indexterm" name="id2535124"></a><a name="FAKEDIRECTORYCREATETIMES"></a><div class="variablelist"><dl><dt></dt><dd><p>NTFS and Windows VFAT file systems keep a create
     1869</h3></div></div></div><a class="indexterm" name="id2535120"></a><a name="FAKEDIRECTORYCREATETIMES"></a><div class="variablelist"><dl><dt></dt><dd><p>NTFS and Windows VFAT file systems keep a create
    18701870        time for all files and directories. This is not the same as the
    18711871        ctime - status change time - that Unix keeps, so Samba by default
    … …  
    18891889        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>
    18901890</em></span>
    1891 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535203"></a>
     1891</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535198"></a>
    18921892
    18931893fake oplocks (S)
    1894 </h3></div></div></div><a class="indexterm" name="id2535204"></a><a name="FAKEOPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>Oplocks are the way that SMB clients get permission
     1894</h3></div></div></div><a class="indexterm" name="id2535199"></a><a name="FAKEOPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>Oplocks are the way that SMB clients get permission
    18951895        from a server to locally cache file operations. If a server grants
    18961896        an oplock (opportunistic lock) then the client is free to assume
    … …  
    19081908        this option carefully!</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>fake oplocks</code></em> = <code class="literal">no</code>
    19091909</em></span>
    1910 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535295"></a>
     1910</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535290"></a>
    19111911
    19121912follow symlinks (S)
    1913 </h3></div></div></div><a class="indexterm" name="id2535296"></a><a name="FOLLOWSYMLINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1913</h3></div></div></div><a class="indexterm" name="id2535291"></a><a name="FOLLOWSYMLINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    19141914        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
    19151915        parameter to <code class="constant">no</code> prevents any file or directory that is a symbolic link from being
    … …  
    19211921        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>follow symlinks</code></em> = <code class="literal">yes</code>
    19221922</em></span>
    1923 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535370"></a>
     1923</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535365"></a>
    19241924
    19251925force create mode (S)
    1926 </h3></div></div></div><a class="indexterm" name="id2535371"></a><a name="FORCECREATEMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a set of UNIX mode bit
    1927     permissions that will <span class="emphasis"><em>always</em></span> be set on a
    1928     file created by Samba. This is done by bitwise 'OR'ing these bits onto
    1929     the mode bits of a file that is being created or having its
    1930     permissions changed. The default for this parameter is (in octal)
    1931     000. The modes in this parameter are bitwise 'OR'ed onto the file
    1932     mode after the mask set in the <em class="parameter"><code>create mask</code></em>
    1933     parameter is applied.</p><p>The example below would force all created files to have read and execute
    1934     permissions set for 'group' and 'other' as well as the
     1926</h3></div></div></div><a class="indexterm" name="id2535366"></a><a name="FORCECREATEMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a set of UNIX mode bit
     1927    permissions that will <span class="emphasis"><em>always</em></span> be set on a
     1928    file created by Samba. This is done by bitwise 'OR'ing these bits onto
     1929    the mode bits of a file that is being created. The default for this parameter is (in octal)
     1930    000. The modes in this parameter are bitwise 'OR'ed onto the file
     1931    mode after the mask set in the <em class="parameter"><code>create mask</code></em>
     1932    parameter is applied.</p><p>The example below would force all newly created files to have read and execute
     1933    permissions set for 'group' and 'other' as well as the
    19351934    read/write/execute bits set for the 'user'.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>force create mode</code></em> = <code class="literal">000</code>
    19361935</em></span>
    19371936</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force create mode</code></em> = <code class="literal">0755</code>
    19381937</em></span>
    1939 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535451"></a>
     1938</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535446"></a>
    19401939
    19411940force directory mode (S)
    1942 </h3></div></div></div><a class="indexterm" name="id2535452"></a><a name="FORCEDIRECTORYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a set of UNIX mode bit
     1941</h3></div></div></div><a class="indexterm" name="id2535447"></a><a name="FORCEDIRECTORYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a set of UNIX mode bit
    19431942    permissions that will <span class="emphasis"><em>always</em></span> be set on a directory
    19441943    created by Samba. This is done by bitwise 'OR'ing these bits onto the
    … …  
    19531952</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force directory mode</code></em> = <code class="literal">0755</code>
    19541953</em></span>
    1955 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535532"></a>
     1954</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535527"></a>
    19561955
    19571956force directory security mode (S)
    1958 </h3></div></div></div><a class="indexterm" name="id2535534"></a><a name="FORCEDIRECTORYSECURITYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1957</h3></div></div></div><a class="indexterm" name="id2535528"></a><a name="FORCEDIRECTORYSECURITYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    19591958        This parameter controls what UNIX permission bits can be modified when a Windows NT client is manipulating
    19601959        the UNIX permission on a directory using the native NT security dialog box.
    … …  
    19771976</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force directory security mode</code></em> = <code class="literal">700</code>
    19781977</em></span>
    1979 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535636"></a>
     1978</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535631"></a>
    19801979
    19811980<a name="GROUP"></a>group
    1982 </h3></div></div></div><a class="indexterm" name="id2535638"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535668"></a>
     1981</h3></div></div></div><a class="indexterm" name="id2535632"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535663"></a>
    19831982
    19841983force group (S)
    1985 </h3></div></div></div><a class="indexterm" name="id2535670"></a><a name="FORCEGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies a UNIX group name that will be
     1984</h3></div></div></div><a class="indexterm" name="id2535664"></a><a name="FORCEGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies a UNIX group name that will be
    19861985    assigned as the default primary group for all users connecting
    19871986    to this service. This is useful for sharing files by ensuring
    … …  
    20072006</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force group</code></em> = <code class="literal">agroup</code>
    20082007</em></span>
    2009 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535784"></a>
     2008</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535778"></a>
    20102009
    20112010force printername (S)
    2012 </h3></div></div></div><a class="indexterm" name="id2535785"></a><a name="FORCEPRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>When printing from Windows NT (or later),
     2011</h3></div></div></div><a class="indexterm" name="id2535779"></a><a name="FORCEPRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>When printing from Windows NT (or later),
    20132012    each printer in <code class="filename">smb.conf</code> has two
    20142013    associated names which can be used by the client.  The first
    … …  
    20332032    folder.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>force printername</code></em> = <code class="literal">no</code>
    20342033</em></span>
    2035 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535875"></a>
     2034</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535870"></a>
    20362035
    20372036force security mode (S)
    2038 </h3></div></div></div><a class="indexterm" name="id2535876"></a><a name="FORCESECURITYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2037</h3></div></div></div><a class="indexterm" name="id2535871"></a><a name="FORCESECURITYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    20392038        This parameter controls what UNIX permission bits can be modified when a Windows NT client is manipulating
    20402039    the UNIX permission on a file using the native NT security dialog box.
    … …  
    20562055</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force security mode</code></em> = <code class="literal">700</code>
    20572056</em></span>
    2058 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535977"></a>
     2057</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535970"></a>
    20592058
    20602059force unknown acl user (S)
    2061 </h3></div></div></div><a class="indexterm" name="id2535978"></a><a name="FORCEUNKNOWNACLUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2060</h3></div></div></div><a class="indexterm" name="id2535972"></a><a name="FORCEUNKNOWNACLUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    20622061    If this parameter is set, a Windows NT ACL that contains an unknown SID (security descriptor, or
    20632062    representation of a user or group id) as the owner or group owner of the file will be silently
    … …  
    20732072    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>force unknown acl user</code></em> = <code class="literal">no</code>
    20742073</em></span>
    2075 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536039"></a>
     2074</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536033"></a>
    20762075
    20772076force user (S)
    2078 </h3></div></div></div><a class="indexterm" name="id2536040"></a><a name="FORCEUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies a UNIX user name that will be
     2077</h3></div></div></div><a class="indexterm" name="id2536034"></a><a name="FORCEUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies a UNIX user name that will be
    20792078    assigned as the default user for all users connecting to this service.
    20802079    This is useful for sharing files. You should also use it carefully
    … …  
    20902089</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force user</code></em> = <code class="literal">auser</code>
    20912090</em></span>
    2092 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536120"></a>
     2091</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536109"></a>
    20932092
    20942093fstype (S)
    2095 </h3></div></div></div><a class="indexterm" name="id2536122"></a><a name="FSTYPE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2094</h3></div></div></div><a class="indexterm" name="id2536110"></a><a name="FSTYPE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    20962095        This parameter allows the administrator to configure the string that specifies the type of filesystem a share
    20972096        is using that is reported by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>
    … …  
    21032102</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>fstype</code></em> = <code class="literal">Samba</code>
    21042103</em></span>
    2105 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536202"></a>
     2104</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536190"></a>
    21062105
    21072106get quota command (G)
    2108 </h3></div></div></div><a class="indexterm" name="id2536203"></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
     2107</h3></div></div></div><a class="indexterm" name="id2536191"></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
    21092108        whenever there is no operating system API available from the OS that
    21102109        samba can use.</p><p>This option is only available you have compiled Samba with the
    … …  
    21192118</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>
    21202119</em></span>
    2121 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536388"></a>
     2120</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536378"></a>
    21222121
    21232122getwd cache (G)
    2124 </h3></div></div></div><a class="indexterm" name="id2536389"></a><a name="GETWDCACHE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a tuning option. When this is enabled a
     2123</h3></div></div></div><a class="indexterm" name="id2536379"></a><a name="GETWDCACHE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a tuning option. When this is enabled a
    21252124    caching algorithm will be used to reduce the time taken for getwd()
    21262125    calls. This can have a significant impact on performance, especially
    21272126    when the <a class="link" href="smb.conf.5.html#WIDESMBCONFOPTIONS">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>
    21282127</em></span>
    2129 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536448"></a>
     2128</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536438"></a>
    21302129
    21312130guest account (G)
    2132 </h3></div></div></div><a class="indexterm" name="id2536450"></a><a name="GUESTACCOUNT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a username which will be used for access
     2131</h3></div></div></div><a class="indexterm" name="id2536439"></a><a name="GUESTACCOUNT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a username which will be used for access
    21332132    to services which are specified as <a class="link" href="smb.conf.5.html#GUESTOK">guest ok</a> (see below). Whatever privileges this
    21342133    user has will be available to any client connecting to the guest service.
    … …  
    21482147</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>guest account</code></em> = <code class="literal">ftp</code>
    21492148</em></span>
    2150 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536556"></a>
     2149</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536546"></a>
    21512150
    21522151<a name="PUBLIC"></a>public
    2153 </h3></div></div></div><a class="indexterm" name="id2536558"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536588"></a>
     2152</h3></div></div></div><a class="indexterm" name="id2536547"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536577"></a>
    21542153
    21552154guest ok (S)
    2156 </h3></div></div></div><a class="indexterm" name="id2536589"></a><a name="GUESTOK"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code> for
     2155</h3></div></div></div><a class="indexterm" name="id2536578"></a><a name="GUESTOK"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code> for
    21572156    a service, then no password is required to connect to the service.
    21582157    Privileges will be those of the <a class="link" href="smb.conf.5.html#GUESTACCOUNT">guest account</a>.</p><p>This paramater nullifies the benifits of setting
    … …  
    21612160        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>guest ok</code></em> = <code class="literal">no</code>
    21622161</em></span>
    2163 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536676"></a>
     2162</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536665"></a>
    21642163
    21652164<a name="ONLYGUEST"></a>only guest
    2166 </h3></div></div></div><a class="indexterm" name="id2536677"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536708"></a>
     2165</h3></div></div></div><a class="indexterm" name="id2536666"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536697"></a>
    21672166
    21682167guest only (S)
    2169 </h3></div></div></div><a class="indexterm" name="id2536709"></a><a name="GUESTONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code> for
     2168</h3></div></div></div><a class="indexterm" name="id2536698"></a><a name="GUESTONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code> for
    21702169    a service, then only guest connections to the service are permitted.
    21712170    This parameter will have no effect if <a class="link" href="smb.conf.5.html#GUESTOK">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">security</a> for more information about this option.
    21722171        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>guest only</code></em> = <code class="literal">no</code>
    21732172</em></span>
    2174 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536780"></a>
     2173</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536770"></a>
    21752174
    21762175hide dot files (S)
    2177 </h3></div></div></div><a class="indexterm" name="id2536781"></a><a name="HIDEDOTFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls whether
     2176</h3></div></div></div><a class="indexterm" name="id2536771"></a><a name="HIDEDOTFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls whether
    21782177        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>
    21792178</em></span>
    2180 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536823"></a>
     2179</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536812"></a>
    21812180
    21822181hide files (S)
    2183 </h3></div></div></div><a class="indexterm" name="id2536824"></a><a name="HIDEFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of files or directories that are not
     2182</h3></div></div></div><a class="indexterm" name="id2536813"></a><a name="HIDEFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of files or directories that are not
    21842183        visible but are accessible.  The DOS 'hidden' attribute is applied
    21852184        to any files or directories that match.</p><p>Each entry in the list must be separated by a '/',
    … …  
    22032202# no file are hidden</code>
    22042203</em></span>
    2205 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536911"></a>
     2204</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536901"></a>
    22062205
    22072206hide special files (S)
    2208 </h3></div></div></div><a class="indexterm" name="id2536912"></a><a name="HIDESPECIALFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2207</h3></div></div></div><a class="indexterm" name="id2536902"></a><a name="HIDESPECIALFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    22092208        This parameter prevents clients from seeing special files such as sockets, devices and
    22102209        fifo's in directory listings.
    22112210        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>hide special files</code></em> = <code class="literal">no</code>
    22122211</em></span>
    2213 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536954"></a>
     2212</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536943"></a>
    22142213
    22152214hide unreadable (S)
    2216 </h3></div></div></div><a class="indexterm" name="id2536955"></a><a name="HIDEUNREADABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter prevents clients from seeing the
     2215</h3></div></div></div><a class="indexterm" name="id2536944"></a><a name="HIDEUNREADABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter prevents clients from seeing the
    22172216                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>
    22182217</em></span>
    2219 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536997"></a>
     2218</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536986"></a>
    22202219
    22212220hide unwriteable files (S)
    2222 </h3></div></div></div><a class="indexterm" name="id2536998"></a><a name="HIDEUNWRITEABLEFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2221</h3></div></div></div><a class="indexterm" name="id2536987"></a><a name="HIDEUNWRITEABLEFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    22232222    This parameter prevents clients from seeing the existance of files that cannot be written to.
    22242223    Defaults to off. Note that unwriteable directories are shown as usual.
    22252224    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>hide unwriteable files</code></em> = <code class="literal">no</code>
    22262225</em></span>
    2227 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537041"></a>
     2226</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537030"></a>
    22282227
    22292228homedir map (G)
    2230 </h3></div></div></div><a class="indexterm" name="id2537042"></a><a name="HOMEDIRMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2229</h3></div></div></div><a class="indexterm" name="id2537031"></a><a name="HOMEDIRMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    22312230        If <a class="link" href="smb.conf.5.html#NISHOMEDIR">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>
    22322231        then this parameter specifies the NIS (or YP) map from which the server for the user's  home directory should be extracted. 
    … …  
    22432242</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>homedir map</code></em> = <code class="literal">amd.homedir</code>
    22442243</em></span>
    2245 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537153"></a>
     2244</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537143"></a>
    22462245
    22472246host msdfs (G)
    2248 </h3></div></div></div><a class="indexterm" name="id2537154"></a><a name="HOSTMSDFS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2247</h3></div></div></div><a class="indexterm" name="id2537144"></a><a name="HOSTMSDFS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    22492248        If set to <code class="constant">yes</code>, Samba will act as a Dfs server, and allow Dfs-aware clients to browse
    22502249        Dfs trees hosted on the server.
    … …  
    22542253        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>host msdfs</code></em> = <code class="literal">yes</code>
    22552254</em></span>
    2256 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537218"></a>
     2255</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537207"></a>
    22572256
    22582257hostname lookups (G)
    2259 </h3></div></div></div><a class="indexterm" name="id2537219"></a><a name="HOSTNAMELOOKUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies whether samba should use (expensive)
     2258</h3></div></div></div><a class="indexterm" name="id2537208"></a><a name="HOSTNAMELOOKUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies whether samba should use (expensive)
    22602259    hostname lookups or use the ip addresses instead. An example place
    22612260    where hostname lookups are currently used is when checking
    … …  
    22652264</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>hostname lookups</code></em> = <code class="literal">yes</code>
    22662265</em></span>
    2267 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537291"></a>
     2266</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537280"></a>
    22682267
    22692268<a name="ALLOWHOSTS"></a>allow hosts
    2270 </h3></div></div></div><a class="indexterm" name="id2537292"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537323"></a>
     2269</h3></div></div></div><a class="indexterm" name="id2537281"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537312"></a>
    22712270
    22722271hosts allow (S)
    2273 </h3></div></div></div><a class="indexterm" name="id2537324"></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">allow hosts</a>.</p><p>This parameter is a comma, space, or tab delimited
     2272</h3></div></div></div><a class="indexterm" name="id2537313"></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">allow hosts</a>.</p><p>This parameter is a comma, space, or tab delimited
    22742273    set of hosts which are permitted to access a service.</p><p>If specified in the [global] section then it will
    22752274    apply to all services, regardless of whether the individual
    … …  
    22912290</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>
    22922291</em></span>
    2293 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537524"></a>
     2292</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537514"></a>
    22942293
    22952294<a name="DENYHOSTS"></a>deny hosts
    2296 </h3></div></div></div><a class="indexterm" name="id2537526"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537556"></a>
     2295</h3></div></div></div><a class="indexterm" name="id2537515"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537545"></a>
    22972296
    22982297hosts deny (S)
    2299 </h3></div></div></div><a class="indexterm" name="id2537557"></a><a name="HOSTSDENY"></a><div class="variablelist"><dl><dt></dt><dd><p>The opposite of <em class="parameter"><code>hosts allow</code></em>
     2298</h3></div></div></div><a class="indexterm" name="id2537546"></a><a name="HOSTSDENY"></a><div class="variablelist"><dl><dt></dt><dd><p>The opposite of <em class="parameter"><code>hosts allow</code></em>
    23002299    - hosts listed here are <span class="emphasis"><em>NOT</em></span> permitted access to
    23012300    services unless the specific services have their own lists to override
    … …  
    23112310</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>
    23122311</em></span>
    2313 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537658"></a>
     2312</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537647"></a>
    23142313
    23152314idmap alloc backend (G)
    2316 </h3></div></div></div><a class="indexterm" name="id2537659"></a><a name="IDMAPALLOCBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2315</h3></div></div></div><a class="indexterm" name="id2537648"></a><a name="IDMAPALLOCBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    23172316        The idmap alloc backend provides a plugin interface for Winbind to use
    23182317        when allocating Unix uids/gids for Windows SIDs.  This option is
    … …  
    23262325        </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>
    23272326</em></span>
    2328 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537755"></a>
     2327</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537745"></a>
    23292328
    23302329idmap alloc config (G)
    2331 </h3></div></div></div><a class="indexterm" name="id2537756"></a><a name="IDMAPALLOCCONFIG"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2330</h3></div></div></div><a class="indexterm" name="id2537746"></a><a name="IDMAPALLOCCONFIG"></a><div class="variablelist"><dl><dt></dt><dd><p>
    23322331        The idmap alloc config prefix provides a means of managing settings
    23332332        for the backend defined by the <a class="link" href="smb.conf.5.html#IDMAPALLOCBACKEND">idmap alloc backend</a>
    23342333        parameter.  Refer to the man page for each idmap plugin regarding
    23352334        specific configuration details.
    2336         </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537800"></a>
     2335        </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537789"></a>
    23372336
    23382337idmap backend (G)
    2339 </h3></div></div></div><a class="indexterm" name="id2537801"></a><a name="IDMAPBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2338</h3></div></div></div><a class="indexterm" name="id2537790"></a><a name="IDMAPBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    23402339        The idmap backend provides a plugin interface for Winbind to use
    23412340        varying backends to store SID/uid/gid mapping tables.  This
    … …  
    23502349        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>idmap backend</code></em> = <code class="literal">tdb</code>
    23512350</em></span>
    2352 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537895"></a>
     2351</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537884"></a>
    23532352
    23542353idmap cache time (G)
    2355 </h3></div></div></div><a class="indexterm" name="id2537896"></a><a name="IDMAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of seconds that Winbind's
     2354</h3></div></div></div><a class="indexterm" name="id2537885"></a><a name="IDMAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of seconds that Winbind's
    23562355        idmap interface will cache positive SID/uid/gid query results.
    23572356        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>idmap cache time</code></em> = <code class="literal">900</code>
    23582357</em></span>
    2359 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537938"></a>
     2358</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537927"></a>
    23602359
    23612360idmap config (G)
    2362 </h3></div></div></div><a class="indexterm" name="id2537939"></a><a name="IDMAPCONFIG"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2361</h3></div></div></div><a class="indexterm" name="id2537928"></a><a name="IDMAPCONFIG"></a><div class="variablelist"><dl><dt></dt><dd><p>
    23632362        The idmap config prefix provides a means of managing each domain
    23642363        defined by the <a class="link" href="smb.conf.5.html#IDMAPDOMAINS">idmap domains</a> option using Samba's
    … …  
    23932392        idmap config TRUSTEDDOMAINS:default = yes
    23942393        idmap config TRUSTEDDOMAINS:range   = 1000 - 9999
    2395         </pre><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538074"></a>
     2394        </pre><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538063"></a>
    23962395
    23972396idmap domains (G)
    2398 </h3></div></div></div><a class="indexterm" name="id2538075"></a><a name="IDMAPDOMAINS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2397</h3></div></div></div><a class="indexterm" name="id2538064"></a><a name="IDMAPDOMAINS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    23992398        The idmap domains option defines a list of Windows domains which will each
    24002399        have a separately configured backend for managing Winbind's SID/uid/gid
    … …  
    24092408        </p><p><span class="emphasis"><em>No default</em></span></p><p>Example: <span class="emphasis"><em><em class="parameter"><code>idmap domains</code></em> = <code class="literal">default AD CORP</code>
    24102409</em></span>
    2411 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538159"></a>
     2410</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538148"></a>
    24122411
    24132412<a name="WINBINDGID"></a>winbind gid
    2414 </h3></div></div></div><a class="indexterm" name="id2538160"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538191"></a>
     2413</h3></div></div></div><a class="indexterm" name="id2538149"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538179"></a>
    24152414
    24162415idmap gid (G)
    2417 </h3></div></div></div><a class="indexterm" name="id2538192"></a><a name="IDMAPGID"></a><div class="variablelist"><dl><dt></dt><dd><p>The idmap gid parameter specifies the range of group ids
     2416</h3></div></div></div><a class="indexterm" name="id2538180"></a><a name="IDMAPGID"></a><div class="variablelist"><dl><dt></dt><dd><p>The idmap gid parameter specifies the range of group ids
    24182417        that are allocated for the purpose of mapping UNX groups to NT group
    24192418        SIDs. This range of group ids should have no
    … …  
    24242423</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>idmap gid</code></em> = <code class="literal">10000-20000</code>
    24252424</em></span>
    2426 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538288"></a>
     2425</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538278"></a>
    24272426
    24282427idmap negative cache time (G)
    2429 </h3></div></div></div><a class="indexterm" name="id2538290"></a><a name="IDMAPNEGATIVECACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of seconds that Winbind's
     2428</h3></div></div></div><a class="indexterm" name="id2538279"></a><a name="IDMAPNEGATIVECACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of seconds that Winbind's
    24302429        idmap interface will cache negative SID/uid/gid query results.
    24312430        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>idmap negative cache time</code></em> = <code class="literal">120</code>
    24322431</em></span>
    2433 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538332"></a>
     2432</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538321"></a>
    24342433
    24352434<a name="WINBINDUID"></a>winbind uid
    2436 </h3></div></div></div><a class="indexterm" name="id2538333"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538364"></a>
     2435</h3></div></div></div><a class="indexterm" name="id2538322"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538353"></a>
    24372436
    24382437idmap uid (G)
    2439 </h3></div></div></div><a class="indexterm" name="id2538365"></a><a name="IDMAPUID"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2438</h3></div></div></div><a class="indexterm" name="id2538354"></a><a name="IDMAPUID"></a><div class="variablelist"><dl><dt></dt><dd><p>
    24402439        The idmap uid parameter specifies the range of user ids that are
    24412440        allocated for use in mapping UNIX users to NT user SIDs. This
    … …  
    24462445</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>idmap uid</code></em> = <code class="literal">10000-20000</code>
    24472446</em></span>
    2448 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538461"></a>
     2447</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538450"></a>
    24492448
    24502449include (G)
    2451 </h3></div></div></div><a class="indexterm" name="id2538462"></a><a name="INCLUDE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2450</h3></div></div></div><a class="indexterm" name="id2538451"></a><a name="INCLUDE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    24522451        This allows you to include one config file inside another.  The file is included literally, as though typed
    24532452        in place.
    … …  
    24672466</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>
    24682467</em></span>
    2469 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538562"></a>
     2468</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538551"></a>
    24702469
    24712470inherit acls (S)
    2472 </h3></div></div></div><a class="indexterm" name="id2538563"></a><a name="INHERITACLS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter can be used to ensure that if default acls
     2471</h3></div></div></div><a class="indexterm" name="id2538552"></a><a name="INHERITACLS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter can be used to ensure that if default acls
    24732472    exist on parent directories, they are always honored when creating a
    24742473    new file or subdirectory in these parent directories. The default
    … …  
    24782477</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>inherit acls</code></em> = <code class="literal">no</code>
    24792478</em></span>
    2480 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538609"></a>
     2479</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538598"></a>
    24812480
    24822481inherit owner (S)
    2483 </h3></div></div></div><a class="indexterm" name="id2538610"></a><a name="INHERITOWNER"></a><div class="variablelist"><dl><dt></dt><dd><p>The ownership of new files and directories
     2482</h3></div></div></div><a class="indexterm" name="id2538599"></a><a name="INHERITOWNER"></a><div class="variablelist"><dl><dt></dt><dd><p>The ownership of new files and directories
    24842483        is normally governed by effective uid of the connected user.
    24852484        This option allows the Samba administrator to specify that
    … …  
    24902489        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>
    24912490</em></span>
    2492 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538662"></a>
     2491</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538651"></a>
    24932492
    24942493inherit permissions (S)
    2495 </h3></div></div></div><a class="indexterm" name="id2538663"></a><a name="INHERITPERMISSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2494</h3></div></div></div><a class="indexterm" name="id2538652"></a><a name="INHERITPERMISSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    24962495        The permissions on new files and directories are normally governed by <a class="link" href="smb.conf.5.html#CREATEMASK">create mask</a>,
    24972496        <a class="link" href="smb.conf.5.html#DIRECTORYMASK">directory mask</a>, <a class="link" href="smb.conf.5.html#FORCECREATEMODE">force create mode</a> and <a class="link" href="smb.conf.5.html#FORCEDIRECTORYMODE">force directory mode</a> but the boolean inherit permissions parameter overrides this.
    … …  
    25052504    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>
    25062505</em></span>
    2507 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538809"></a>
     2506</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538799"></a>
    25082507
    25092508interfaces (G)
    2510 </h3></div></div></div><a class="indexterm" name="id2538810"></a><a name="INTERFACES"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to override the default
     2509</h3></div></div></div><a class="indexterm" name="id2538800"></a><a name="INTERFACES"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to override the default
    25112510        network interfaces list that Samba will use for browsing, name
    25122511        registration and other NetBIOS over TCP/IP (NBT) traffic. By default Samba will query
    … …  
    25322531</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>
    25332532</em></span>
    2534 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538926"></a>
     2533</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538915"></a>
    25352534
    25362535invalid users (S)
    2537 </h3></div></div></div><a class="indexterm" name="id2538927"></a><a name="INVALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of users that should not be allowed
     2536</h3></div></div></div><a class="indexterm" name="id2538916"></a><a name="INVALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of users that should not be allowed
    25382537    to login to this service. This is really a <span class="emphasis"><em>paranoid</em></span>
    25392538    check to absolutely ensure an improper setting does not breach
    … …  
    25552554</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>invalid users</code></em> = <code class="literal">root fred admin @wheel</code>
    25562555</em></span>
    2557 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539040"></a>
     2556</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539029"></a>
    25582557
    25592558iprint server (G)
    2560 </h3></div></div></div><a class="indexterm" name="id2539041"></a><a name="IPRINTSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2559</h3></div></div></div><a class="indexterm" name="id2539030"></a><a name="IPRINTSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    25612560    This parameter is only applicable if <a class="link" href="smb.conf.5.html#PRINTING">printing</a> is set to <code class="constant">iprint</code>.
    25622561    </p><p>
    … …  
    25672566</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>iprint server</code></em> = <code class="literal">MYCUPSSERVER</code>
    25682567</em></span>
    2569 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539126"></a>
     2568</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539115"></a>
    25702569
    25712570keepalive (G)
    2572 </h3></div></div></div><a class="indexterm" name="id2539127"></a><a name="KEEPALIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (an integer) represents
     2571</h3></div></div></div><a class="indexterm" name="id2539116"></a><a name="KEEPALIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (an integer) represents
    25732572    the number of seconds between <em class="parameter"><code>keepalive</code></em>
    25742573    packets. If this parameter is zero, no keepalive packets will be
    … …  
    25802579</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>keepalive</code></em> = <code class="literal">600</code>
    25812580</em></span>
    2582 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539213"></a>
     2581</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539202"></a>
    25832582
    25842583kernel change notify (S)
    2585 </h3></div></div></div><a class="indexterm" name="id2539214"></a><a name="KERNELCHANGENOTIFY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should ask the
     2584</h3></div></div></div><a class="indexterm" name="id2539203"></a><a name="KERNELCHANGENOTIFY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should ask the
    25862585        kernel for change notifications in directories so that
    25872586        SMB clients can refresh whenever the data on the server changes.
    … …  
    25902589        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>kernel change notify</code></em> = <code class="literal">yes</code>
    25912590</em></span>
    2592 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539262"></a>
     2591</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539252"></a>
    25932592
    25942593kernel oplocks (G)
    2595 </h3></div></div></div><a class="indexterm" name="id2539263"></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">oplocks</a>
     2594</h3></div></div></div><a class="indexterm" name="id2539253"></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">oplocks</a>
    25962595        (currently only IRIX and the Linux 2.4 kernel), this parameter
    25972596        allows the use of them to be turned on or off.</p><p>Kernel oplocks support allows Samba <em class="parameter"><code>oplocks
    … …  
    26032602        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>
    26042603</em></span>
    2605 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539350"></a>
     2604</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539339"></a>
    26062605
    26072606lanman auth (G)
    2608 </h3></div></div></div><a class="indexterm" name="id2539351"></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
     2607</h3></div></div></div><a class="indexterm" name="id2539340"></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
    26092608    authenticate users or permit password changes
    26102609    using the LANMAN password hash. If disabled, only clients which support NT
    … …  
    26232622    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>
    26242623</em></span>
    2625 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539443"></a>
     2624</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539432"></a>
    26262625
    26272626large readwrite (G)
    2628 </h3></div></div></div><a class="indexterm" name="id2539444"></a><a name="LARGEREADWRITE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not
     2627</h3></div></div></div><a class="indexterm" name="id2539433"></a><a name="LARGEREADWRITE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not
    26292628    <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> supports the new 64k
    26302629    streaming read and write varient SMB requests introduced with
    … …  
    26352634        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>
    26362635</em></span>
    2637 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539499"></a>
     2636</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539488"></a>
    26382637
    26392638ldap admin dn (G)
    2640 </h3></div></div></div><a class="indexterm" name="id2539500"></a><a name="LDAPADMINDN"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2639</h3></div></div></div><a class="indexterm" name="id2539489"></a><a name="LDAPADMINDN"></a><div class="variablelist"><dl><dt></dt><dd><p>
    26412640        The <a class="link" href="smb.conf.5.html#LDAPADMINDN">ldap admin dn</a> defines the Distinguished  Name (DN) name used by Samba to contact
    26422641        the ldap server when retreiving  user account information. The <a class="link" href="smb.conf.5.html#LDAPADMINDN">ldap admin dn</a> is used
    … …  
    26462645        </p><p>
    26472646        The <a class="link" href="smb.conf.5.html#LDAPADMINDN">ldap admin dn</a> requires a fully specified DN. The <a class="link" href="smb.conf.5.html#LDAPSUFFIX">ldap  suffix</a> is not appended to the <a class="link" href="smb.conf.5.html#LDAPADMINDN">ldap admin dn</a>.
    2648         </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539608"></a>
     2647        </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539597"></a>
    26492648
    26502649ldap connection timeout (G)
    2651 </h3></div></div></div><a class="indexterm" name="id2539609"></a><a name="LDAPCONNECTIONTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2650</h3></div></div></div><a class="indexterm" name="id2539598"></a><a name="LDAPCONNECTIONTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    26522651        This parameter tells the LDAP library calls which timeout in seconds
    26532652        they should honor during initial connection establishments to LDAP servers.
    … …  
    26612660        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap connection timeout</code></em> = <code class="literal">2</code>
    26622661</em></span>
    2663 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539673"></a>
     2662</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539662"></a>
    26642663
    26652664ldap debug level (G)
    2666 </h3></div></div></div><a class="indexterm" name="id2539674"></a><a name="LDAPDEBUGLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2665</h3></div></div></div><a class="indexterm" name="id2539663"></a><a name="LDAPDEBUGLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    26672666                This parameter controls the debug level of the LDAP library
    26682667                calls. In the case of OpenLDAP, it is the same
    … …  
    26812680</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap debug level</code></em> = <code class="literal">1</code>
    26822681</em></span>
    2683 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539760"></a>
     2682</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539750"></a>
    26842683
    26852684ldap debug threshold (G)
    2686 </h3></div></div></div><a class="indexterm" name="id2539762"></a><a name="LDAPDEBUGTHRESHOLD"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2685</h3></div></div></div><a class="indexterm" name="id2539751"></a><a name="LDAPDEBUGTHRESHOLD"></a><div class="variablelist"><dl><dt></dt><dd><p>
    26872686                This parameter controls the Samba debug level at which
    26882687                the ldap library debug output is
    … …  
    26932692</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap debug threshold</code></em> = <code class="literal">5</code>
    26942693</em></span>
    2695 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539828"></a>
     2694</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539817"></a>
    26962695
    26972696ldap delete dn (G)
    2698 </h3></div></div></div><a class="indexterm" name="id2539829"></a><a name="LDAPDELETEDN"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter specifies whether a delete
     2697</h3></div></div></div><a class="indexterm" name="id2539818"></a><a name="LDAPDELETEDN"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter specifies whether a delete
    26992698        operation in the ldapsam deletes the complete entry or only the attributes
    27002699        specific to Samba.
    27012700        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap delete dn</code></em> = <code class="literal">no</code>
    27022701</em></span>
    2703 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539871"></a>
     2702</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539860"></a>
    27042703
    27052704ldap group suffix (G)
    2706 </h3></div></div></div><a class="indexterm" name="id2539872"></a><a name="LDAPGROUPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the suffix that is
     2705</h3></div></div></div><a class="indexterm" name="id2539861"></a><a name="LDAPGROUPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the suffix that is
    27072706        used for groups when these are added to the LDAP directory.
    27082707        If this parameter is unset, the value of <a class="link" href="smb.conf.5.html#LDAPSUFFIX">ldap suffix</a> will be used instead.  The suffix string is pre-pended to the
    … …  
    27112710</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap group suffix</code></em> = <code class="literal">ou=Groups</code>
    27122711</em></span>
    2713 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539954"></a>
     2712</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539944"></a>
    27142713
    27152714ldap idmap suffix (G)
    2716 </h3></div></div></div><a class="indexterm" name="id2539956"></a><a name="LDAPIDMAPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2715</h3></div></div></div><a class="indexterm" name="id2539945"></a><a name="LDAPIDMAPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
    27172716        This parameters specifies the suffix that is used when storing idmap mappings. If this parameter
    27182717        is unset, the value of <a class="link" href="smb.conf.5.html#LDAPSUFFIX">ldap suffix</a> will be used instead.  The suffix
    … …  
    27222721</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap idmap suffix</code></em> = <code class="literal">ou=Idmap</code>
    27232722</em></span>
    2724 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540037"></a>
     2723</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540026"></a>
    27252724
    27262725ldap machine suffix (G)
    2727 </h3></div></div></div><a class="indexterm" name="id2540038"></a><a name="LDAPMACHINESUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2726</h3></div></div></div><a class="indexterm" name="id2540027"></a><a name="LDAPMACHINESUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
    27282727        It specifies where machines should be added to the ldap tree.  If this parameter is unset, the value of
    27292728        <a class="link" href="smb.conf.5.html#LDAPSUFFIX">ldap suffix</a> will be used instead.  The suffix string is pre-pended to the
    … …  
    27332732</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap machine suffix</code></em> = <code class="literal">ou=Computers</code>
    27342733</em></span>
    2735 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540119"></a>
     2734</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540108"></a>
    27362735
    27372736ldap passwd sync (G)
    2738 </h3></div></div></div><a class="indexterm" name="id2540120"></a><a name="LDAPPASSWDSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2737</h3></div></div></div><a class="indexterm" name="id2540109"></a><a name="LDAPPASSWDSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    27392738        This option is used to define whether or not Samba should sync the LDAP password with the NT
    27402739        and LM hashes for normal accounts (NOT for workstation, server or domain trusts) on a password
    … …  
    27472746                        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>
    27482747</em></span>
    2749 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540219"></a>
     2748</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540208"></a>
    27502749
    27512750ldap replication sleep (G)
    2752 </h3></div></div></div><a class="indexterm" name="id2540220"></a><a name="LDAPREPLICATIONSLEEP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2751</h3></div></div></div><a class="indexterm" name="id2540210"></a><a name="LDAPREPLICATIONSLEEP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    27532752        When Samba is asked to write to a read-only LDAP replica, we are redirected to talk to the read-write master server.
    27542753        This server then replicates our changes back to the 'local' server, however the replication might take some seconds,
    … …  
    27632762        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap replication sleep</code></em> = <code class="literal">1000</code>
    27642763</em></span>
    2765 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540283"></a>
     2764</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540272"></a>
    27662765
    27672766ldapsam:editposix (G)
    2768 </h3></div></div></div><a class="indexterm" name="id2540284"></a><a name="LDAPSAM:EDITPOSIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2767</h3></div></div></div><a class="indexterm" name="id2540273"></a><a name="LDAPSAM:EDITPOSIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
    27692768        Editposix is an option that leverages ldapsam:trusted to make it simpler to manage a domain controller
    27702769        eliminating the need to set up custom scripts to add and manage the posix users and groups. This option
    … …  
    28442843        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldapsam:editposix</code></em> = <code class="literal">no</code>
    28452844</em></span>
    2846 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540420"></a>
     2845</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540409"></a>
    28472846
    28482847ldapsam:trusted (G)
    2849 </h3></div></div></div><a class="indexterm" name="id2540422"></a><a name="LDAPSAM:TRUSTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2848</h3></div></div></div><a class="indexterm" name="id2540410"></a><a name="LDAPSAM:TRUSTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
    28502849        By default, Samba as a Domain Controller with an LDAP backend needs to use the Unix-style NSS subsystem to
    28512850        access user and group information. Due to the way Unix stores user information in /etc/passwd and /etc/group
    … …  
    28652864        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldapsam:trusted</code></em> = <code class="literal">no</code>
    28662865</em></span>
    2867 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540509"></a>
     2866</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540498"></a>
    28682867
    28692868ldap ssl (G)
    2870 </h3></div></div></div><a class="indexterm" name="id2540510"></a><a name="LDAPSSL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used to define whether or not Samba should
     2869</h3></div></div></div><a class="indexterm" name="id2540499"></a><a name="LDAPSSL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used to define whether or not Samba should
    28712870        use SSL when connecting to the ldap server
    28722871        This is <span class="emphasis"><em>NOT</em></span> related to
    … …  
    28822881                </li></ul></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap ssl</code></em> = <code class="literal">start_tls</code>
    28832882</em></span>
    2884 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540648"></a>
     2883</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540637"></a>
    28852884
    28862885ldap suffix (G)
    2887 </h3></div></div></div><a class="indexterm" name="id2540649"></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>
     2886</h3></div></div></div><a class="indexterm" name="id2540638"></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>
    28882887        The ldap suffix will be appended to the values specified for the <a class="link" href="smb.conf.5.html#LDAPUSERSUFFIX">ldap user suffix</a>,
    28892888         <a class="link" href="smb.conf.5.html#LDAPGROUPSUFFIX">ldap group suffix</a>, <a class="link" href="smb.conf.5.html#LDAPMACHINESUFFIX">ldap machine suffix</a>, and the
    … …  
    28942893</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap suffix</code></em> = <code class="literal">dc=samba,dc=org</code>
    28952894</em></span>
    2896 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540770"></a>
     2895</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540760"></a>
    28972896
    28982897ldap timeout (G)
    2899 </h3></div></div></div><a class="indexterm" name="id2540771"></a><a name="LDAPTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2898</h3></div></div></div><a class="indexterm" name="id2540761"></a><a name="LDAPTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    29002899        When Samba connects to an ldap server that server may be down or unreachable. To prevent Samba from hanging whilst
    29012900        waiting for the connection this parameter specifies in seconds how long Samba should wait before failing the
    … …  
    29032902        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap timeout</code></em> = <code class="literal">15</code>
    29042903</em></span>
    2905 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540817"></a>
     2904</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540806"></a>
    29062905
    29072906ldap user suffix (G)
    2908 </h3></div></div></div><a class="indexterm" name="id2540818"></a><a name="LDAPUSERSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2907</h3></div></div></div><a class="indexterm" name="id2540807"></a><a name="LDAPUSERSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
    29092908        This parameter specifies where users are added to the tree. If this parameter is unset,
    29102909        the value of <a class="link" href="smb.conf.5.html#LDAPSUFFIX">ldap suffix</a> will be used instead.  The suffix
    … …  
    29142913</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap user suffix</code></em> = <code class="literal">ou=people</code>
    29152914</em></span>
    2916 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540898"></a>
     2915</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540888"></a>
    29172916
    29182917level2 oplocks (S)
    2919 </h3></div></div></div><a class="indexterm" name="id2540900"></a><a name="LEVEL2OPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether Samba supports
     2918</h3></div></div></div><a class="indexterm" name="id2540889"></a><a name="LEVEL2OPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether Samba supports
    29202919        level2 (read-only) oplocks on a share.</p><p>Level2, or read-only oplocks allow Windows NT clients
    29212920        that have an oplock on a file to downgrade from a read-write oplock
    … …  
    29372936        this parameter to have any effect.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>level2 oplocks</code></em> = <code class="literal">yes</code>
    29382937</em></span>
    2939 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541006"></a>
     2938</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540995"></a>
    29402939
    29412940lm announce (G)
    2942 </h3></div></div></div><a class="indexterm" name="id2541007"></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
     2941</h3></div></div></div><a class="indexterm" name="id2540996"></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
    29432942        broadcasts that are needed by OS/2 clients in order for them to see
    29442943        the Samba server in their browse list. This parameter can have three
    … …  
    29562955</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lm announce</code></em> = <code class="literal">yes</code>
    29572956</em></span>
    2958 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541128"></a>
     2957</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541117"></a>
    29592958
    29602959lm interval (G)
    2961 </h3></div></div></div><a class="indexterm" name="id2541129"></a><a name="LMINTERVAL"></a><div class="variablelist"><dl><dt></dt><dd><p>If Samba is set to produce Lanman announce
     2960</h3></div></div></div><a class="indexterm" name="id2541118"></a><a name="LMINTERVAL"></a><div class="variablelist"><dl><dt></dt><dd><p>If Samba is set to produce Lanman announce
    29622961        broadcasts needed by OS/2 clients (see the
    29632962                <a class="link" href="smb.conf.5.html#LMANNOUNCE">lm announce</a> parameter) then this
    … …  
    29692968</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lm interval</code></em> = <code class="literal">120</code>
    29702969</em></span>
    2971 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541212"></a>
     2970</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541201"></a>
    29722971
    29732972load printers (G)
    2974 </h3></div></div></div><a class="indexterm" name="id2541213"></a><a name="LOADPRINTERS"></a><div class="variablelist"><dl><dt></dt><dd><p>A boolean variable that controls whether all
     2973</h3></div></div></div><a class="indexterm" name="id2541202"></a><a name="LOADPRINTERS"></a><div class="variablelist"><dl><dt></dt><dd><p>A boolean variable that controls whether all
    29752974    printers in the printcap will be loaded for browsing by default.
    29762975    See the <a class="link" href="smb.conf.5.html#PRINTERS">printers</a> section for
    29772976    more details.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>load printers</code></em> = <code class="literal">yes</code>
    29782977</em></span>
    2979 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541268"></a>
     2978</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541258"></a>
    29802979
    29812980local master (G)
    2982 </h3></div></div></div><a class="indexterm" name="id2541269"></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
     2981</h3></div></div></div><a class="indexterm" name="id2541259"></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
    29832982        on a subnet. If set to <code class="constant">no</code> then <code class="literal">
    29842983        nmbd</code> will not attempt to become a local master browser
    … …  
    29902989master browser.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>local master</code></em> = <code class="literal">yes</code>
    29912990</em></span>
    2992 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541369"></a>
     2991</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541358"></a>
    29932992
    29942993<a name="LOCKDIR"></a>lock dir
    2995 </h3></div></div></div><a class="indexterm" name="id2541370"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541401"></a>
     2994</h3></div></div></div><a class="indexterm" name="id2541359"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541390"></a>
    29962995
    29972996lock directory (G)
    2998 </h3></div></div></div><a class="indexterm" name="id2541402"></a><a name="LOCKDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the directory where lock
     2997</h3></div></div></div><a class="indexterm" name="id2541391"></a><a name="LOCKDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the directory where lock
    29992998        files will be placed.  The lock files are used to implement the
    30002999        <a class="link" href="smb.conf.5.html#MAXCONNECTIONS">max connections</a> option.
    … …  
    30063005</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lock directory</code></em> = <code class="literal">/var/run/samba/locks</code>
    30073006</em></span>
    3008 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541479"></a>
     3007</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541468"></a>
    30093008
    30103009locking (S)
    3011 </h3></div></div></div><a class="indexterm" name="id2541480"></a><a name="LOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether or not locking will be
     3010</h3></div></div></div><a class="indexterm" name="id2541470"></a><a name="LOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether or not locking will be
    30123011        performed by the server in response to lock requests from the
    30133012        client.</p><p>If <code class="literal">locking = no</code>, all lock and unlock
    … …  
    30193018        is not really recommended even in this case.</p><p>Be careful about disabling locking either globally or in a
    30203019        specific service, as lack of locking may result in data corruption.
    3021         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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541554"></a>
     3020        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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541544"></a>
    30223021
    30233022lock spin count (G)
    3024 </h3></div></div></div><a class="indexterm" name="id2541555"></a><a name="LOCKSPINCOUNT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter has been made inoperative in Samba 3.0.24.
     3023</h3></div></div></div><a class="indexterm" name="id2541545"></a><a name="LOCKSPINCOUNT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter has been made inoperative in Samba 3.0.24.
    30253024        The functionality it contolled is now controlled by the parameter
    30263025        <a class="link" href="smb.conf.5.html#LOCKSPINTIME">lock spin time</a>.
    30273026        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>lock spin count</code></em> = <code class="literal">0</code>
    30283027</em></span>
    3029 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541611"></a>
     3028</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541600"></a>
    30303029
    30313030lock spin time (G)
    3032 </h3></div></div></div><a class="indexterm" name="id2541612"></a><a name="LOCKSPINTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The time in microseconds that smbd should
     3031</h3></div></div></div><a class="indexterm" name="id2541601"></a><a name="LOCKSPINTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The time in microseconds that smbd should
    30333032        keep waiting to see if a failed lock request can
    30343033        be granted. This parameter has changed in default
    … …  
    30383037        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>
    30393038</em></span>
    3040 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541670"></a>
     3039</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541659"></a>
    30413040
    30423041log file (G)
    3043 </h3></div></div></div><a class="indexterm" name="id2541671"></a><a name="LOGFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3042</h3></div></div></div><a class="indexterm" name="id2541660"></a><a name="LOGFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    30443043    This option allows you to override the name of the Samba log file (also known as the debug file).
    30453044    </p><p>
    … …  
    30473046    </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>
    30483047</em></span>
    3049 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541722"></a>
     3048</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541711"></a>
    30503049
    30513050<a name="DEBUGLEVEL"></a>debuglevel
    3052 </h3></div></div></div><a class="indexterm" name="id2541723"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541753"></a>
     3051</h3></div></div></div><a class="indexterm" name="id2541712"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541742"></a>
    30533052
    30543053log level (G)
    3055 </h3></div></div></div><a class="indexterm" name="id2541754"></a><a name="LOGLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3054</h3></div></div></div><a class="indexterm" name="id2541743"></a><a name="LOGLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    30563055    The value of the parameter (a astring) allows the debug level (logging level) to be specified in the
    30573056    <code class="filename">smb.conf</code> file.
    … …  
    30643063</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>
    30653064</em></span>
    3066 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541986"></a>
     3065</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541975"></a>
    30673066
    30683067logon drive (G)
    3069 </h3></div></div></div><a class="indexterm" name="id2541987"></a><a name="LOGONDRIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3068</h3></div></div></div><a class="indexterm" name="id2541976"></a><a name="LOGONDRIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    30703069        This parameter specifies the local path to which the home directory will be
    30713070        connected (see <a class="link" href="smb.conf.5.html#LOGONHOME">logon home</a>) and is only used by NT
    … …  
    30773076</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>logon drive</code></em> = <code class="literal">h:</code>
    30783077</em></span>
    3079 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542060"></a>
     3078</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542049"></a>
    30803079
    30813080logon home (G)
    3082 </h3></div></div></div><a class="indexterm" name="id2542061"></a><a name="LOGONHOME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3081</h3></div></div></div><a class="indexterm" name="id2542050"></a><a name="LOGONHOME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    30833082        This parameter specifies the home directory location when a Win95/98 or NT Workstation logs into a Samba PDC. 
    30843083        It allows you to do
    … …  
    31113110</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>logon home</code></em> = <code class="literal">\\remote_smb_server\%U</code>
    31123111</em></span>
    3113 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542224"></a>
     3112</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542214"></a>
    31143113
    31153114logon path (G)
    3116 </h3></div></div></div><a class="indexterm" name="id2542226"></a><a name="LOGONPATH"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3115</h3></div></div></div><a class="indexterm" name="id2542215"></a><a name="LOGONPATH"></a><div class="variablelist"><dl><dt></dt><dd><p>
    31173116        This parameter specifies the directory where roaming profiles (Desktop, NTuser.dat, etc) are
    31183117        stored.  Contrary to previous versions of these manual pages, it has nothing to do with Win 9X roaming
    … …  
    31583157        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>logon path</code></em> = <code class="literal">\\%N\%U\profile</code>
    31593158</em></span>
    3160 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542393"></a>
     3159</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542382"></a>
    31613160
    31623161logon script (G)
    3163 </h3></div></div></div><a class="indexterm" name="id2542394"></a><a name="LOGONSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3162</h3></div></div></div><a class="indexterm" name="id2542383"></a><a name="LOGONSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    31643163        This parameter specifies the batch file (<code class="filename">.bat</code>) or NT command file
    31653164        (<code class="filename">.cmd</code>) to be downloaded and run on a machine when a user successfully logs in.  The file
    … …  
    31923191</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>logon script</code></em> = <code class="literal">scripts\%U.bat</code>
    31933192</em></span>
    3194 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542563"></a>
     3193</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542552"></a>
    31953194
    31963195lppause command (S)
    3197 </h3></div></div></div><a class="indexterm" name="id2542564"></a><a name="LPPAUSECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     3196</h3></div></div></div><a class="indexterm" name="id2542553"></a><a name="LPPAUSECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    31983197    executed on the server host in order to stop printing or spooling
    31993198    a specific print job.</p><p>This command should be a program or script which takes
    … …  
    32193218</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>
    32203219</em></span>
    3221 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542710"></a>
     3220</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542699"></a>
    32223221
    32233222lpq cache time (G)
    3224 </h3></div></div></div><a class="indexterm" name="id2542711"></a><a name="LPQCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls how long lpq info will be cached
     3223</h3></div></div></div><a class="indexterm" name="id2542700"></a><a name="LPQCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls how long lpq info will be cached
    32253224        for to prevent the <code class="literal">lpq</code> command being called too
    32263225        often. A separate cache is kept for each variation of the <code class="literal">
    … …  
    32353234</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lpq cache time</code></em> = <code class="literal">10</code>
    32363235</em></span>
    3237 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542830"></a>
     3236</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542819"></a>
    32383237
    32393238lpq command (S)
    3240 </h3></div></div></div><a class="indexterm" name="id2542831"></a><a name="LPQCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     3239</h3></div></div></div><a class="indexterm" name="id2542820"></a><a name="LPQCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    32413240    executed on the server host in order to obtain <code class="literal">lpq
    32423241    </code>-style printer status information.</p><p>This command should be a program or script which
    … …  
    32603259</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lpq command</code></em> = <code class="literal">/usr/bin/lpq -P%p</code>
    32613260</em></span>
    3262 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542956"></a>
     3261</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542945"></a>
    32633262
    32643263lpresume command (S)
    3265 </h3></div></div></div><a class="indexterm" name="id2542957"></a><a name="LPRESUMECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     3264</h3></div></div></div><a class="indexterm" name="id2542946"></a><a name="LPRESUMECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    32663265    executed on the server host in order to restart or continue
    32673266    printing or spooling a specific print job.</p><p>This command should be a program or script which takes
    … …  
    32763275    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>
    32773276</em></span>
    3278 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543108"></a>
     3277</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543098"></a>
    32793278
    32803279lprm command (S)
    3281 </h3></div></div></div><a class="indexterm" name="id2543109"></a><a name="LPRMCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     3280</h3></div></div></div><a class="indexterm" name="id2543099"></a><a name="LPRMCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    32823281    executed on the server host in order to delete a print job.</p><p>This command should be a program or script which takes
    32833282    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
    … …  
    32963295        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>lprm command</code></em> = <code class="literal"> determined by printing parameter</code>
    32973296</em></span>
    3298 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543196"></a>
     3297</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543185"></a>
    32993298
    33003299machine password timeout (G)
    3301 </h3></div></div></div><a class="indexterm" name="id2543197"></a><a name="MACHINEPASSWORDTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3300</h3></div></div></div><a class="indexterm" name="id2543186"></a><a name="MACHINEPASSWORDTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    33023301        If a Samba server is a member of a Windows NT Domain (see the <a class="link" href="smb.conf.5.html#SECURITY">security = domain</a> parameter) then periodically a running smbd process will try and change
    33033302        the MACHINE ACCOUNT PASSWORD stored in the TDB called <code class="filename">private/secrets.tdb
    … …  
    33093308        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>machine password timeout</code></em> = <code class="literal">604800</code>
    33103309</em></span>
    3311 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543283"></a>
     3310</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543272"></a>
    33123311
    33133312magic output (S)
    3314 </h3></div></div></div><a class="indexterm" name="id2543284"></a><a name="MAGICOUTPUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3313</h3></div></div></div><a class="indexterm" name="id2543273"></a><a name="MAGICOUTPUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    33153314        This parameter specifies the name of a file which will contain output created by a magic script (see the
    33163315        <a class="link" href="smb.conf.5.html#MAGICSCRIPT">magic script</a> parameter below).
    … …  
    33213320</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>magic output</code></em> = <code class="literal">myfile.txt</code>
    33223321</em></span>
    3323 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543367"></a>
     3322</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543356"></a>
    33243323
    33253324magic script (S)
    3326 </h3></div></div></div><a class="indexterm" name="id2543368"></a><a name="MAGICSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the name of a file which,
     3325</h3></div></div></div><a class="indexterm" name="id2543357"></a><a name="MAGICSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the name of a file which,
    33273326        if opened, will be executed by the server when the file is closed.
    33283327        This allows a UNIX script to be sent to the Samba host and
    … …  
    33403339</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>magic script</code></em> = <code class="literal">user.csh</code>
    33413340</em></span>
    3342 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543472"></a>
     3341</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543462"></a>
    33433342
    33443343mangled names (S)
    3345 </h3></div></div></div><a class="indexterm" name="id2543474"></a><a name="MANGLEDNAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether non-DOS names under UNIX
     3344</h3></div></div></div><a class="indexterm" name="id2543463"></a><a name="MANGLEDNAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether non-DOS names under UNIX
    33463345        should be mapped to DOS-compatible names ("mangled") and made visible,
    33473346        or whether non-DOS names should simply be ignored.</p><p>See the section on <a class="link" href="smb.conf.5.html#NAMEMANGLING">name mangling</a> for
    … …  
    33683367        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>
    33693368</em></span>
    3370 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543609"></a>
     3369</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543598"></a>
    33713370
    33723371mangle prefix (G)
    3373 </h3></div></div></div><a class="indexterm" name="id2543610"></a><a name="MANGLEPREFIX"></a><div class="variablelist"><dl><dt></dt><dd><p> controls the number of prefix
     3372</h3></div></div></div><a class="indexterm" name="id2543599"></a><a name="MANGLEPREFIX"></a><div class="variablelist"><dl><dt></dt><dd><p> controls the number of prefix
    33743373        characters from the original name used when generating
    33753374        the mangled names. A larger value will give a weaker
    … …  
    33813380</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>mangle prefix</code></em> = <code class="literal">4</code>
    33823381</em></span>
    3383 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543676"></a>
     3382</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543665"></a>
    33843383
    33853384mangling char (S)
    3386 </h3></div></div></div><a class="indexterm" name="id2543677"></a><a name="MANGLINGCHAR"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what character is used as
     3385</h3></div></div></div><a class="indexterm" name="id2543666"></a><a name="MANGLINGCHAR"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what character is used as
    33873386        the <span class="emphasis"><em>magic</em></span> character in <a class="link" href="smb.conf.5.html#NAMEMANGLING">name mangling</a>. The
    33883387        default is a '~' but this may interfere with some software. Use this option to set
    … …  
    33913390</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>mangling char</code></em> = <code class="literal">^</code>
    33923391</em></span>
    3393 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543753"></a>
     3392</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543742"></a>
    33943393
    33953394mangling method (G)
    3396 </h3></div></div></div><a class="indexterm" name="id2543754"></a><a name="MANGLINGMETHOD"></a><div class="variablelist"><dl><dt></dt><dd><p> controls the algorithm used for the generating
     3395</h3></div></div></div><a class="indexterm" name="id2543743"></a><a name="MANGLINGMETHOD"></a><div class="variablelist"><dl><dt></dt><dd><p> controls the algorithm used for the generating
    33973396        the mangled names. Can take two different values, "hash" and
    33983397        "hash2". "hash" is the algorithm that was used
    … …  
    34053404</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>mangling method</code></em> = <code class="literal">hash</code>
    34063405</em></span>
    3407 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543820"></a>
     3406</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543809"></a>
    34083407
    34093408map acl inherit (S)
    3410 </h3></div></div></div><a class="indexterm" name="id2543821"></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'
     3409</h3></div></div></div><a class="indexterm" name="id2543810"></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'
    34113410    access control entry flags stored in Windows ACLs into an extended attribute
    34123411    called user.SAMBA_PAI. This parameter only takes effect if Samba is being run
    … …  
    34163415    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>map acl inherit</code></em> = <code class="literal">no</code>
    34173416</em></span>
    3418 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543877"></a>
     3417</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543866"></a>
    34193418
    34203419map archive (S)
    3421 </h3></div></div></div><a class="indexterm" name="id2543878"></a><a name="MAPARCHIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3420</h3></div></div></div><a class="indexterm" name="id2543867"></a><a name="MAPARCHIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    34223421        This controls whether the DOS archive attribute
    34233422        should be mapped to the UNIX owner execute bit.  The DOS archive bit
    … …  
    34323431        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>map archive</code></em> = <code class="literal">yes</code>
    34333432</em></span>
    3434 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543952"></a>
     3433</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543941"></a>
    34353434
    34363435map hidden (S)
    3437 </h3></div></div></div><a class="indexterm" name="id2543953"></a><a name="MAPHIDDEN"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3436</h3></div></div></div><a class="indexterm" name="id2543942"></a><a name="MAPHIDDEN"></a><div class="variablelist"><dl><dt></dt><dd><p>
    34383437        This controls whether DOS style hidden files should be mapped to the UNIX world execute bit.
    34393438        </p><p>
    … …  
    34413440        bit is not masked out (i.e. it must include 001). See the parameter <a class="link" href="smb.conf.5.html#CREATEMASK">create mask</a>
    34423441        for details.
    3443         </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544010"></a>
     3442        </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543999"></a>
    34443443
    34453444map read only (S)
    3446 </h3></div></div></div><a class="indexterm" name="id2544011"></a><a name="MAPREADONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3445</h3></div></div></div><a class="indexterm" name="id2544000"></a><a name="MAPREADONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    34473446        This controls how the DOS read only attribute should be mapped from a UNIX filesystem.
    34483447        </p><p>
    … …  
    34693468                </p></li></ul></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>map read only</code></em> = <code class="literal">yes</code>
    34703469</em></span>
    3471 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544167"></a>
     3470</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544164"></a>
    34723471
    34733472map system (S)
    3474 </h3></div></div></div><a class="indexterm" name="id2544168"></a><a name="MAPSYSTEM"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3473</h3></div></div></div><a class="indexterm" name="id2544165"></a><a name="MAPSYSTEM"></a><div class="variablelist"><dl><dt></dt><dd><p>
    34753474        This controls whether DOS style system files should be mapped to the UNIX group execute bit.
    34763475        </p><p>
    … …  
    34803479        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>map system</code></em> = <code class="literal">no</code>
    34813480</em></span>
    3482 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544236"></a>
     3481</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544233"></a>
    34833482
    34843483map to guest (G)
    3485 </h3></div></div></div><a class="indexterm" name="id2544237"></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">SECURITY =
     3484</h3></div></div></div><a class="indexterm" name="id2544234"></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">SECURITY =
    34863485    security</a> modes other than <em class="parameter"><code>security = share</code></em>
    34873486    and <em class="parameter"><code>security = server</code></em>
    … …  
    35253524</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>map to guest</code></em> = <code class="literal">Bad User</code>
    35263525</em></span>
    3527 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544476"></a>
     3526</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544473"></a>
    35283527
    35293528max connections (S)
    3530 </h3></div></div></div><a class="indexterm" name="id2544477"></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.
     3529</h3></div></div></div><a class="indexterm" name="id2544474"></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.
    35313530    If <em class="parameter"><code>max connections</code></em> is greater than 0 then connections
    35323531    will be refused if this number of connections to the service are already open. A value
    … …  
    35363535</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max connections</code></em> = <code class="literal">10</code>
    35373536</em></span>
    3538 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544562"></a>
     3537</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544559"></a>
    35393538
    35403539max disk size (G)
    3541 </h3></div></div></div><a class="indexterm" name="id2544563"></a><a name="MAXDISKSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to put an upper limit
     3540</h3></div></div></div><a class="indexterm" name="id2544560"></a><a name="MAXDISKSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to put an upper limit
    35423541    on the apparent size of disks. If you set this option to 100
    35433542    then all shares will appear to be not larger than 100 MB in
    … …  
    35533552</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max disk size</code></em> = <code class="literal">1000</code>
    35543553</em></span>
    3555 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544653"></a>
     3554</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544650"></a>
    35563555
    35573556max log size (G)
    3558 </h3></div></div></div><a class="indexterm" name="id2544654"></a><a name="MAXLOGSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3557</h3></div></div></div><a class="indexterm" name="id2544651"></a><a name="MAXLOGSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    35593558    This option (an integer in kilobytes) specifies the max size the log file should grow to.
    35603559    Samba periodically checks the size and if it is exceeded it will rename the file, adding
    … …  
    35653564</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max log size</code></em> = <code class="literal">1000</code>
    35663565</em></span>
    3567 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544725"></a>
     3566</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544722"></a>
    35683567
    35693568max mux (G)
    3570 </h3></div></div></div><a class="indexterm" name="id2544726"></a><a name="MAXMUX"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum number of
     3569</h3></div></div></div><a class="indexterm" name="id2544723"></a><a name="MAXMUX"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum number of
    35713570    outstanding simultaneous SMB operations that Samba tells the client
    35723571        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>
    35733572</em></span>
    3574 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544768"></a>
     3573</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544765"></a>
    35753574
    35763575max open files (G)
    3577 </h3></div></div></div><a class="indexterm" name="id2544769"></a><a name="MAXOPENFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of
     3576</h3></div></div></div><a class="indexterm" name="id2544766"></a><a name="MAXOPENFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of
    35783577    open files that one <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> file
    35793578    serving process may have open for a client at any one time. The
    … …  
    35833582    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">10000</code>
    35843583</em></span>
    3585 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544828"></a>
     3584</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544825"></a>
    35863585
    35873586max print jobs (S)
    3588 </h3></div></div></div><a class="indexterm" name="id2544829"></a><a name="MAXPRINTJOBS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of
     3587</h3></div></div></div><a class="indexterm" name="id2544826"></a><a name="MAXPRINTJOBS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of
    35893588    jobs allowable in a Samba printer queue at any given moment.
    35903589    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.
    … …  
    35933592</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max print jobs</code></em> = <code class="literal">5000</code>
    35943593</em></span>
    3595 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544898"></a>
     3594</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544895"></a>
    35963595
    35973596<a name="PROTOCOL"></a>protocol
    3598 </h3></div></div></div><a class="indexterm" name="id2544899"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544931"></a>
     3597</h3></div></div></div><a class="indexterm" name="id2544896"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544927"></a>
    35993598
    36003599max protocol (G)
    3601 </h3></div></div></div><a class="indexterm" name="id2544932"></a><a name="MAXPROTOCOL"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a string) is the highest
     3600</h3></div></div></div><a class="indexterm" name="id2544928"></a><a name="MAXPROTOCOL"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a string) is the highest
    36023601    protocol level that will be supported by the server.</p><p>Possible values are :</p><div class="itemizedlist"><ul type="disc"><li><p><code class="constant">CORE</code>: Earliest version. No
    36033602            concept of user names.</p></li><li><p><code class="constant">COREPLUS</code>: Slight improvements on
    … …  
    36113610</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max protocol</code></em> = <code class="literal">LANMAN1</code>
    36123611</em></span>
    3613 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545055"></a>
     3612</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545052"></a>
    36143613
    36153614max reported print jobs (S)
    3616 </h3></div></div></div><a class="indexterm" name="id2545056"></a><a name="MAXREPORTEDPRINTJOBS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3615</h3></div></div></div><a class="indexterm" name="id2545053"></a><a name="MAXREPORTEDPRINTJOBS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    36173616    This parameter limits the maximum number of jobs displayed in a port monitor for
    36183617    Samba printer queue at any given moment. If this number is exceeded, the excess
    … …  
    36233622</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max reported print jobs</code></em> = <code class="literal">1000</code>
    36243623</em></span>
    3625 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545119"></a>
     3624</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545116"></a>
    36263625
    36273626max smbd processes (G)
    3628 </h3></div></div></div><a class="indexterm" name="id2545120"></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
     3627</h3></div></div></div><a class="indexterm" name="id2545117"></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
    36293628    as a stopgap to prevent degrading service to clients in the event that the server has insufficient
    36303629    resources to handle more than this number of connections.  Remember that under normal operating
    … …  
    36343633</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max smbd processes</code></em> = <code class="literal">1000</code>
    36353634</em></span>
    3636 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545201"></a>
     3635</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545197"></a>
    36373636
    36383637max stat cache size (G)
    3639 </h3></div></div></div><a class="indexterm" name="id2545202"></a><a name="MAXSTATCACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the size in memory of any
     3638</h3></div></div></div><a class="indexterm" name="id2545198"></a><a name="MAXSTATCACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the size in memory of any
    36403639          <em class="parameter"><code>stat cache</code></em> being used
    36413640          to speed up case insensitive name mappings. It represents
    … …  
    36483647</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max stat cache size</code></em> = <code class="literal">100</code>
    36493648</em></span>
    3650 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545270"></a>
     3649</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545267"></a>
    36513650
    36523651max ttl (G)
    3653 </h3></div></div></div><a class="indexterm" name="id2545272"></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'
     3652</h3></div></div></div><a class="indexterm" name="id2545268"></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'
    36543653    of NetBIOS names should be (in seconds) when <code class="literal">nmbd</code> is
    36553654    requesting a name using either a broadcast packet or from a WINS server. You should
    36563655        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>
    36573656</em></span>
    3658 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545329"></a>
     3657</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545326"></a>
    36593658
    36603659max wins ttl (G)
    3661 </h3></div></div></div><a class="indexterm" name="id2545330"></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
     3660</h3></div></div></div><a class="indexterm" name="id2545327"></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
    36623661        (<a class="link" href="smb.conf.5.html#WINSSUPPORT">wins support = yes</a>) what the maximum
    36633662    'time to live' of NetBIOS names that <code class="literal">nmbd</code>
    … …  
    36653664        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>
    36663665</em></span>
    3667 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545400"></a>
     3666</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545397"></a>
    36683667
    36693668max xmit (G)
    3670 </h3></div></div></div><a class="indexterm" name="id2545401"></a><a name="MAXXMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum packet size
     3669</h3></div></div></div><a class="indexterm" name="id2545398"></a><a name="MAXXMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum packet size
    36713670    that will be negotiated by Samba. The default is 16644, which
    36723671    matches the behavior of Windows 2000.  A value below 2048 is likely to cause problems.
    … …  
    36763675</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max xmit</code></em> = <code class="literal">8192</code>
    36773676</em></span>
    3678 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545463"></a>
     3677</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545460"></a>
    36793678
    36803679message command (G)
    3681 </h3></div></div></div><a class="indexterm" name="id2545464"></a><a name="MESSAGECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies what command to run when the
     3680</h3></div></div></div><a class="indexterm" name="id2545461"></a><a name="MESSAGECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies what command to run when the
    36823681        server receives a WinPopup style message.</p><p>This would normally be a command that would
    36833682        deliver the message somehow. How this is to be done is
    … …  
    37183717</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>
    37193718</em></span>
    3720 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545673"></a>
     3719</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545670"></a>
    37213720
    37223721min print space (S)
    3723 </h3></div></div></div><a class="indexterm" name="id2545674"></a><a name="MINPRINTSPACE"></a><div class="variablelist"><dl><dt></dt><dd><p>This sets the minimum amount of free disk
     3722</h3></div></div></div><a class="indexterm" name="id2545671"></a><a name="MINPRINTSPACE"></a><div class="variablelist"><dl><dt></dt><dd><p>This sets the minimum amount of free disk
    37243723    space that must be available before a user will be able to spool
    37253724    a print job. It is specified in kilobytes. The default is 0, which
    … …  
    37283727</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>min print space</code></em> = <code class="literal">2000</code>
    37293728</em></span>
    3730 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545735"></a>
     3729</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545732"></a>
    37313730
    37323731min protocol (G)
    3733 </h3></div></div></div><a class="indexterm" name="id2545736"></a><a name="MINPROTOCOL"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a string) is the
     3732</h3></div></div></div><a class="indexterm" name="id2545733"></a><a name="MINPROTOCOL"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a string) is the
    37343733    lowest SMB protocol dialect than Samba will support.  Please refer
    37353734    to the <a class="link" href="smb.conf.5.html#MAXPROTOCOL">max protocol</a>
    … …  
    37433742</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>min protocol</code></em> = <code class="literal">NT1</code>
    37443743</em></span>
    3745 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545833"></a>
     3744</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545830"></a>
    37463745
    37473746min receivefile size (G)
    3748 </h3></div></div></div><a class="indexterm" name="id2545834"></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
     3747</h3></div></div></div><a class="indexterm" name="id2545831"></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
    37493748SMBwriteX call on a non-signed SMB/CIFS connection greater than this value will not be processed in the normal way but will
    37503749be passed to any underlying kernel recvfile or splice system call (if there is no such
    … …  
    37553754nonzero. 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>
    37563755</em></span>
    3757 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545902"></a>
     3756</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545900"></a>
    37583757
    37593758min wins ttl (G)
    3760 </h3></div></div></div><a class="indexterm" name="id2545903"></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>
     3759</h3></div></div></div><a class="indexterm" name="id2545901"></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>
    37613760    when acting as a WINS server (<a class="link" href="smb.conf.5.html#WINSSUPPORT">wins support = yes</a>) what the minimum 'time to live'
    37623761    of NetBIOS names that <code class="literal">nmbd</code> will grant will be (in
    … …  
    37643763    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>
    37653764</em></span>
    3766 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545972"></a>
     3765</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545970"></a>
    37673766
    37683767msdfs proxy (S)
    3769 </h3></div></div></div><a class="indexterm" name="id2545974"></a><a name="MSDFSPROXY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter indicates that the share is a
     3768</h3></div></div></div><a class="indexterm" name="id2545971"></a><a name="MSDFSPROXY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter indicates that the share is a
    37703769        stand-in for another CIFS share whose location is specified by
    37713770        the value of the parameter. When clients attempt to connect to
    … …  
    37753774        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>
    37763775</em></span>
    3777 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546051"></a>
     3776</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546048"></a>
    37783777
    37793778msdfs root (S)
    3780 </h3></div></div></div><a class="indexterm" name="id2546052"></a><a name="MSDFSROOT"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to <code class="constant">yes</code>, Samba treats the
     3779</h3></div></div></div><a class="indexterm" name="id2546049"></a><a name="MSDFSROOT"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to <code class="constant">yes</code>, Samba treats the
    37813780        share as a Dfs root and allows clients to browse the
    37823781        distributed file system tree rooted at the share directory.
    … …  
    37863785        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>
    37873786</em></span>
    3788 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546106"></a>
     3787</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546103"></a>
    37893788
    37903789name cache timeout (G)
    3791 </h3></div></div></div><a class="indexterm" name="id2546107"></a><a name="NAMECACHETIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the number of seconds it takes before
     3790</h3></div></div></div><a class="indexterm" name="id2546104"></a><a name="NAMECACHETIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the number of seconds it takes before
    37923791    entries in samba's hostname resolve cache time out. If
    37933792    the timeout is set to 0. the caching is disabled.
    … …  
    37963795</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>name cache timeout</code></em> = <code class="literal">0</code>
    37973796</em></span>
    3798 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546167"></a>
     3797</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546164"></a>
    37993798
    38003799name resolve order (G)
    3801 </h3></div></div></div><a class="indexterm" name="id2546168"></a><a name="NAMERESOLVEORDER"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used by the programs in the Samba
     3800</h3></div></div></div><a class="indexterm" name="id2546166"></a><a name="NAMERESOLVEORDER"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used by the programs in the Samba
    38023801    suite to determine what naming services to use and in what order
    38033802    to resolve host names to IP addresses. Its main purpose to is to
    … …  
    38303829</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>name resolve order</code></em> = <code class="literal">lmhosts bcast host</code>
    38313830</em></span>
    3832 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546368"></a>
     3831</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546366"></a>
    38333832
    38343833netbios aliases (G)
    3835 </h3></div></div></div><a class="indexterm" name="id2546370"></a><a name="NETBIOSALIASES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of NetBIOS names that nmbd will
     3834</h3></div></div></div><a class="indexterm" name="id2546367"></a><a name="NETBIOSALIASES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of NetBIOS names that nmbd will
    38363835        advertise as additional names by which the Samba server is known. This allows one machine
    38373836        to appear in browse lists under multiple names. If a machine is acting as a browse server
    … …  
    38433842</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>netbios aliases</code></em> = <code class="literal">TEST TEST1 TEST2</code>
    38443843</em></span>
    3845 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546434"></a>
     3844</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546431"></a>
    38463845
    38473846netbios name (G)
    3848 </h3></div></div></div><a class="indexterm" name="id2546435"></a><a name="NETBIOSNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3847</h3></div></div></div><a class="indexterm" name="id2546432"></a><a name="NETBIOSNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    38493848                This sets the NetBIOS name by which a Samba server is known. By default it is the same as the first component
    38503849                of the host's DNS name. If a machine is a browse server or logon server this name (or the first component of
    … …  
    38593858</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>netbios name</code></em> = <code class="literal">MYNAME</code>
    38603859</em></span>
    3861 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546516"></a>
     3860</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546513"></a>
    38623861
    38633862netbios scope (G)
    3864 </h3></div></div></div><a class="indexterm" name="id2546517"></a><a name="NETBIOSSCOPE"></a><div class="variablelist"><dl><dt></dt><dd><p>This sets the NetBIOS scope that Samba will
     3863</h3></div></div></div><a class="indexterm" name="id2546514"></a><a name="NETBIOSSCOPE"></a><div class="variablelist"><dl><dt></dt><dd><p>This sets the NetBIOS scope that Samba will
    38653864        operate under. This should not be set unless every machine
    38663865        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>
    38673866</em></span>
    3868 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546559"></a>
     3867</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546556"></a>
    38693868
    38703869nis homedir (G)
    3871 </h3></div></div></div><a class="indexterm" name="id2546560"></a><a name="NISHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>Get the home share server from a NIS map. For
     3870</h3></div></div></div><a class="indexterm" name="id2546557"></a><a name="NISHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>Get the home share server from a NIS map. For
    38723871        UNIX systems that use an automounter, the user's home directory
    38733872        will often be mounted on a workstation on demand from a remote
    … …  
    38883887        be a logon server.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>nis homedir</code></em> = <code class="literal">no</code>
    38893888</em></span>
    3890 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546639"></a>
     3889</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546636"></a>
    38913890
    38923891nt acl support (S)
    3893 </h3></div></div></div><a class="indexterm" name="id2546640"></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
     3892</h3></div></div></div><a class="indexterm" name="id2546637"></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
    38943893    UNIX permissions into Windows NT access control lists.  The UNIX
    38953894    permissions considered are the the traditional UNIX owner and
    … …  
    38983897    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>
    38993898</em></span>
    3900 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546694"></a>
     3899</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546691"></a>
    39013900
    39023901ntlm auth (G)
    3903 </h3></div></div></div><a class="indexterm" name="id2546695"></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
     3902</h3></div></div></div><a class="indexterm" name="id2546692"></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
    39043903    authenticate users using the NTLM encrypted password response.
    39053904    If disabled, either the lanman password hash or an NTLMv2 response
    … …  
    39093908        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>
    39103909</em></span>
    3911 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546758"></a>
     3910</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546755"></a>
    39123911
    39133912nt pipe support (G)
    3914 </h3></div></div></div><a class="indexterm" name="id2546759"></a><a name="NTPIPESUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether
     3913</h3></div></div></div><a class="indexterm" name="id2546756"></a><a name="NTPIPESUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether
    39153914    <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will allow Windows NT
    39163915    clients to connect to the NT SMB specific <code class="constant">IPC$</code>
    … …  
    39183917        alone.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>nt pipe support</code></em> = <code class="literal">yes</code>
    39193918</em></span>
    3920 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546814"></a>
     3919</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546811"></a>
    39213920
    39223921nt status support (G)
    3923 </h3></div></div></div><a class="indexterm" name="id2546815"></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
     3922</h3></div></div></div><a class="indexterm" name="id2546812"></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
    39243923    support with Windows NT/2k/XP clients. This is a developer debugging option and should be left alone.
    39253924    If this option is set to <code class="constant">no</code> then Samba offers
    … …  
    39273926    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>
    39283927</em></span>
    3929 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546875"></a>
     3928</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546872"></a>
    39303929
    39313930null passwords (G)
    3932 </h3></div></div></div><a class="indexterm" name="id2546876"></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>
    3933 </em></span>
    3934 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546928"></a>
     3931</h3></div></div></div><a class="indexterm" name="id2546873"></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>
     3932</em></span>
     3933</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546925"></a>
    39353934
    39363935obey pam restrictions (G)
    3937 </h3></div></div></div><a class="indexterm" name="id2546929"></a><a name="OBEYPAMRESTRICTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba 3.0 is configured to enable PAM support
     3936</h3></div></div></div><a class="indexterm" name="id2546926"></a><a name="OBEYPAMRESTRICTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba 3.0 is configured to enable PAM support
    39383937    (i.e. --with-pam), this parameter will control whether or not Samba
    39393938    should obey PAM's account and session management directives.  The
    … …  
    39453944</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>obey pam restrictions</code></em> = <code class="literal">no</code>
    39463945</em></span>
    3947 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546992"></a>
     3946</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546989"></a>
    39483947
    39493948only user (S)
    3950 </h3></div></div></div><a class="indexterm" name="id2546993"></a><a name="ONLYUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean option that controls whether
     3949</h3></div></div></div><a class="indexterm" name="id2546990"></a><a name="ONLYUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean option that controls whether
    39513950    connections with usernames not in the <em class="parameter"><code>user</code></em>
    39523951    list will be allowed. By default this option is disabled so that a
    … …  
    39613960    name of the user.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>only user</code></em> = <code class="literal">no</code>
    39623961</em></span>
    3963 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547081"></a>
     3962</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547078"></a>
    39643963
    39653964oplock break wait time (G)
    3966 </h3></div></div></div><a class="indexterm" name="id2547082"></a><a name="OPLOCKBREAKWAITTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3965</h3></div></div></div><a class="indexterm" name="id2547079"></a><a name="OPLOCKBREAKWAITTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    39673966        This is a tuning parameter added due to bugs in both Windows 9x and WinNT. If Samba responds to a client too
    39683967        quickly when that client issues an SMB that can cause an oplock break request, then the network client can
    … …  
    39733972        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>oplock break wait time</code></em> = <code class="literal">0</code>
    39743973</em></span>
    3975 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547136"></a>
     3974</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547133"></a>
    39763975
    39773976oplock contention limit (S)
    3978 </h3></div></div></div><a class="indexterm" name="id2547137"></a><a name="OPLOCKCONTENTIONLIMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3977</h3></div></div></div><a class="indexterm" name="id2547134"></a><a name="OPLOCKCONTENTIONLIMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    39793978        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
    39803979        granting of oplocks under multiple client contention for the same file.
    … …  
    39883987        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>oplock contention limit</code></em> = <code class="literal">2</code>
    39893988</em></span>
    3990 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547219"></a>
     3989</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547215"></a>
    39913990
    39923991oplocks (S)
    3993 </h3></div></div></div><a class="indexterm" name="id2547220"></a><a name="OPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3992</h3></div></div></div><a class="indexterm" name="id2547216"></a><a name="OPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    39943993        This boolean option tells <code class="literal">smbd</code> whether to
    39953994        issue oplocks (opportunistic locks) to file open requests on this
    … …  
    40104009        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>oplocks</code></em> = <code class="literal">yes</code>
    40114010</em></span>
    4012 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547318"></a>
     4011</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547315"></a>
    40134012
    40144013os2 driver map (G)
    4015 </h3></div></div></div><a class="indexterm" name="id2547319"></a><a name="OS2DRIVERMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>The parameter is used to define the absolute
     4014</h3></div></div></div><a class="indexterm" name="id2547316"></a><a name="OS2DRIVERMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>The parameter is used to define the absolute
    40164015    path to a file containing a mapping of Windows NT printer driver
    40174016    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
    … …  
    40234022    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>os2 driver map</code></em> = <code class="literal"></code>
    40244023</em></span>
    4025 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547384"></a>
     4024</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547381"></a>
    40264025
    40274026os level (G)
    4028 </h3></div></div></div><a class="indexterm" name="id2547385"></a><a name="OSLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4027</h3></div></div></div><a class="indexterm" name="id2547382"></a><a name="OSLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    40294028        This integer value controls what level Samba advertises itself as for browse elections. The value of this
    40304029        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">workgroup</a> in the local broadcast area.
    … …  
    40424041</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>os level</code></em> = <code class="literal">65</code>
    40434042</em></span>
    4044 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547493"></a>
     4043</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547490"></a>
    40454044
    40464045pam password change (G)
    4047 </h3></div></div></div><a class="indexterm" name="id2547494"></a><a name="PAMPASSWORDCHANGE"></a><div class="variablelist"><dl><dt></dt><dd><p>With the addition of better PAM support in Samba 2.2,
     4046</h3></div></div></div><a class="indexterm" name="id2547491"></a><a name="PAMPASSWORDCHANGE"></a><div class="variablelist"><dl><dt></dt><dd><p>With the addition of better PAM support in Samba 2.2,
    40484047    this parameter, it is possible to use PAM's password change control
    40494048    flag for Samba.  If enabled, then PAM will be used for password
    … …  
    40534052    <a class="link" href="smb.conf.5.html#PASSWDCHAT">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>
    40544053</em></span>
    4055 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547564"></a>
     4054</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547561"></a>
    40564055
    40574056panic action (G)
    4058 </h3></div></div></div><a class="indexterm" name="id2547565"></a><a name="PANICACTION"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a Samba developer option that allows a
     4057</h3></div></div></div><a class="indexterm" name="id2547562"></a><a name="PANICACTION"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a Samba developer option that allows a
    40594058        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
    40604059        draw attention to the fact that a problem occurred.
    … …  
    40634062</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>panic action</code></em> = <code class="literal">"/bin/sleep 90000"</code>
    40644063</em></span>
    4065 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547640"></a>
     4064</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547637"></a>
    40664065
    40674066paranoid server security (G)
    4068 </h3></div></div></div><a class="indexterm" name="id2547641"></a><a name="PARANOIDSERVERSECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>Some version of NT 4.x allow non-guest
     4067</h3></div></div></div><a class="indexterm" name="id2547638"></a><a name="PARANOIDSERVERSECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>Some version of NT 4.x allow non-guest
    40694068    users with a bad passowrd. When this option is enabled, samba will not
    40704069    use a broken NT 4.x server as password server, but instead complain
    … …  
    40744073    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>
    40754074</em></span>
    4076 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547691"></a>
     4075</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547688"></a>
    40774076
    40784077passdb backend (G)
    4079 </h3></div></div></div><a class="indexterm" name="id2547692"></a><a name="PASSDBBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows the administrator to chose which backend
     4078</h3></div></div></div><a class="indexterm" name="id2547689"></a><a name="PASSDBBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows the administrator to chose which backend
    40804079    will be used for storing user and possibly group information.  This allows
    40814080    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'
    … …  
    41104109</pre><p>Default: <span class="emphasis"><em><em class="parameter"><code>passdb backend</code></em> = <code class="literal">smbpasswd</code>
    41114110</em></span>
    4112 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547847"></a>
     4111</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547844"></a>
    41134112
    41144113passdb expand explicit (G)
    4115 </h3></div></div></div><a class="indexterm" name="id2547848"></a><a name="PASSDBEXPANDEXPLICIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4114</h3></div></div></div><a class="indexterm" name="id2547845"></a><a name="PASSDBEXPANDEXPLICIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    41164115        This parameter controls whether Samba substitutes %-macros in the passdb fields if they are explicitly set. We
    41174116        used to expand macros here, but this turned out to be a bug because the Windows client can expand a variable
    … …  
    41194118    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>passdb expand explicit</code></em> = <code class="literal">no</code>
    41204119</em></span>
    4121 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547894"></a>
     4120</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547891"></a>
    41224121
    41234122passwd chat debug (G)
    4124 </h3></div></div></div><a class="indexterm" name="id2547895"></a><a name="PASSWDCHATDEBUG"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean specifies if the passwd chat script
     4123</h3></div></div></div><a class="indexterm" name="id2547892"></a><a name="PASSWDCHATDEBUG"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean specifies if the passwd chat script
    41254124    parameter is run in <span class="emphasis"><em>debug</em></span> mode. In this mode the
    41264125    strings passed to and received from the passwd chat are printed
    … …  
    41354134        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>
    41364135</em></span>
    4137 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547997"></a>
     4136</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547994"></a>
    41384137
    41394138passwd chat timeout (G)
    4140 </h3></div></div></div><a class="indexterm" name="id2547998"></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
     4139</h3></div></div></div><a class="indexterm" name="id2547995"></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
    41414140    answer from a passwd chat script being run. Once the initial answer is received
    41424141    the subsequent answers must be received in one tenth of this time. The default it
    41434142    two seconds.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>passwd chat timeout</code></em> = <code class="literal">2</code>
    41444143</em></span>
    4145 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548042"></a>
     4144</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548039"></a>
    41464145
    41474146passwd chat (G)
    4148 </h3></div></div></div><a class="indexterm" name="id2548043"></a><a name="PASSWDCHAT"></a><div class="variablelist"><dl><dt></dt><dd><p>This string controls the <span class="emphasis"><em>"chat"</em></span>
     4147</h3></div></div></div><a class="indexterm" name="id2548040"></a><a name="PASSWDCHAT"></a><div class="variablelist"><dl><dt></dt><dd><p>This string controls the <span class="emphasis"><em>"chat"</em></span>
    41494148    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
    41504149    program to change the user's password. The string describes a
    … …  
    41774176</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>
    41784177</em></span>
    4179 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548246"></a>
     4178</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548243"></a>
    41804179
    41814180passwd program (G)
    4182 </h3></div></div></div><a class="indexterm" name="id2548247"></a><a name="PASSWDPROGRAM"></a><div class="variablelist"><dl><dt></dt><dd><p>The name of a program that can be used to set
     4181</h3></div></div></div><a class="indexterm" name="id2548244"></a><a name="PASSWDPROGRAM"></a><div class="variablelist"><dl><dt></dt><dd><p>The name of a program that can be used to set
    41834182    UNIX user passwords.  Any occurrences of <em class="parameter"><code>%u</code></em>
    41844183    will be replaced with the user name. The user name is checked for
    … …  
    42014200</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>passwd program</code></em> = <code class="literal">/bin/passwd %u</code>
    42024201</em></span>
    4203 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548381"></a>
     4202</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548378"></a>
    42044203
    42054204password level (G)
    4206 </h3></div></div></div><a class="indexterm" name="id2548382"></a><a name="PASSWORDLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>Some client/server combinations have difficulty
     4205</h3></div></div></div><a class="indexterm" name="id2548379"></a><a name="PASSWORDLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>Some client/server combinations have difficulty
    42074206    with mixed-case passwords.  One offending client is Windows for
    42084207    Workgroups, which for some reason forces passwords to upper
    … …  
    42264225</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>password level</code></em> = <code class="literal">4</code>
    42274226</em></span>
    4228 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548518"></a>
     4227</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548515"></a>
    42294228
    42304229password server (G)
    4231 </h3></div></div></div><a class="indexterm" name="id2548519"></a><a name="PASSWORDSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>By specifying the name of another SMB server
     4230</h3></div></div></div><a class="indexterm" name="id2548516"></a><a name="PASSWORDSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>By specifying the name of another SMB server
    42324231    or Active Directory domain controller with this option,
    42334232    and using <code class="literal">security = [ads|domain|server]</code>
    … …  
    42894288</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>
    42904289</em></span>
    4291 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548817"></a>
     4290</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548814"></a>
    42924291
    42934292<a name="DIRECTORY"></a>directory
    4294 </h3></div></div></div><a class="indexterm" name="id2548818"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548848"></a>
     4293</h3></div></div></div><a class="indexterm" name="id2548815"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548845"></a>
    42954294
    42964295path (S)
    4297 </h3></div></div></div><a class="indexterm" name="id2548849"></a><a name="PATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a directory to which
     4296</h3></div></div></div><a class="indexterm" name="id2548846"></a><a name="PATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a directory to which
    42984297        the user of the service is to be given access. In the case of
    42994298        printable services, this is where print data will spool prior to
    … …  
    43124311</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>path</code></em> = <code class="literal">/home/fred</code>
    43134312</em></span>
    4314 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548952"></a>
     4313</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548949"></a>
    43154314
    43164315pid directory (G)
    4317 </h3></div></div></div><a class="indexterm" name="id2548953"></a><a name="PIDDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4316</h3></div></div></div><a class="indexterm" name="id2548950"></a><a name="PIDDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    43184317        This option specifies the directory where pid files will be placed. 
    43194318        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>pid directory</code></em> = <code class="literal">${prefix}/var/locks</code>
    … …  
    43214320</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>pid directory</code></em> = <code class="literal">pid directory = /var/run/</code>
    43224321</em></span>
    4323 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549012"></a>
     4322</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549009"></a>
    43244323
    43254324posix locking (S)
    4326 </h3></div></div></div><a class="indexterm" name="id2549013"></a><a name="POSIXLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4325</h3></div></div></div><a class="indexterm" name="id2549010"></a><a name="POSIXLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
    43274326        The <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>
    43284327        daemon maintains an database of file locks obtained by SMB clients. The default behavior is
    … …  
    43324331        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>posix locking</code></em> = <code class="literal">yes</code>
    43334332</em></span>
    4334 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549067"></a>
     4333</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549064"></a>
    43354334
    43364335postexec (S)
    4337 </h3></div></div></div><a class="indexterm" name="id2549068"></a><a name="POSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run
     4336</h3></div></div></div><a class="indexterm" name="id2549065"></a><a name="POSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run
    43384337        whenever the service is disconnected. It takes the usual
    43394338        substitutions. The command may be run as the root on some
    … …  
    43434342</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>
    43444343</em></span>
    4345 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549140"></a>
     4344</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549137"></a>
    43464345
    43474346preexec close (S)
    4348 </h3></div></div></div><a class="indexterm" name="id2549141"></a><a name="PREEXECCLOSE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4347</h3></div></div></div><a class="indexterm" name="id2549138"></a><a name="PREEXECCLOSE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    43494348        This boolean option controls whether a non-zero return code from <a class="link" href="smb.conf.5.html#PREEXEC">preexec</a>
    43504349        should close the service being connected to.
    43514350        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preexec close</code></em> = <code class="literal">no</code>
    43524351</em></span>
    4353 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549194"></a>
     4352</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549191"></a>
    43544353
    43554354<a name="EXEC"></a>exec
    4356 </h3></div></div></div><a class="indexterm" name="id2549196"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549226"></a>
     4355</h3></div></div></div><a class="indexterm" name="id2549192"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549222"></a>
    43574356
    43584357preexec (S)
    4359 </h3></div></div></div><a class="indexterm" name="id2549227"></a><a name="PREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run whenever
     4358</h3></div></div></div><a class="indexterm" name="id2549224"></a><a name="PREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run whenever
    43604359        the service is connected to. It takes the usual substitutions.</p><p>An interesting example is to send the users a welcome
    43614360        message every time they log in. Maybe a message of the day? Here
    … …  
    43694368</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>
    43704369</em></span>
    4371 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549334"></a>
     4370</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549331"></a>
    43724371
    43734372<a name="PREFEREDMASTER"></a>prefered master
    4374 </h3></div></div></div><a class="indexterm" name="id2549335"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549367"></a>
     4373</h3></div></div></div><a class="indexterm" name="id2549332"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549364"></a>
    43754374
    43764375preferred master (G)
    4377 </h3></div></div></div><a class="indexterm" name="id2549368"></a><a name="PREFERREDMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4376</h3></div></div></div><a class="indexterm" name="id2549365"></a><a name="PREFERREDMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    43784377        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.
    43794378        </p><p>
    … …  
    43894388        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preferred master</code></em> = <code class="literal">auto</code>
    43904389</em></span>
    4391 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549460"></a>
     4390</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549457"></a>
    43924391
    43934392preload modules (G)
    4394 </h3></div></div></div><a class="indexterm" name="id2549461"></a><a name="PRELOADMODULES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of paths to modules that should
     4393</h3></div></div></div><a class="indexterm" name="id2549458"></a><a name="PRELOADMODULES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of paths to modules that should
    43954394        be loaded into smbd before a client connects. This improves
    43964395        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>
    … …  
    43984397</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>
    43994398</em></span>
    4400 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549520"></a>
     4399</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549517"></a>
    44014400
    44024401<a name="AUTOSERVICES"></a>auto services
    4403 </h3></div></div></div><a class="indexterm" name="id2549521"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549553"></a>
     4402</h3></div></div></div><a class="indexterm" name="id2549518"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549550"></a>
    44044403
    44054404preload (G)
    4406 </h3></div></div></div><a class="indexterm" name="id2549554"></a><a name="PRELOAD"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of services that you want to be
     4405</h3></div></div></div><a class="indexterm" name="id2549551"></a><a name="PRELOAD"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of services that you want to be
    44074406        automatically added to the browse lists. This is most useful
    44084407        for homes and printers services that would otherwise not be
    … …  
    44154414</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>preload</code></em> = <code class="literal">fred lp colorlp</code>
    44164415</em></span>
    4417 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549631"></a>
     4416</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549628"></a>
    44184417
    44194418preserve case (S)
    4420 </h3></div></div></div><a class="indexterm" name="id2549632"></a><a name="PRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4419</h3></div></div></div><a class="indexterm" name="id2549629"></a><a name="PRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    44214420        This controls if new filenames are created with the case that the client passes, or if
    44224421        they are forced to be the <a class="link" href="smb.conf.5.html#DEFAULTCASE">default case</a>.
    … …  
    44254424        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preserve case</code></em> = <code class="literal">yes</code>
    44264425</em></span>
    4427 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549698"></a>
     4426</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549694"></a>
    44284427
    44294428<a name="PRINTOK"></a>print ok
    4430 </h3></div></div></div><a class="indexterm" name="id2549699"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549728"></a>
     4429</h3></div></div></div><a class="indexterm" name="id2549696"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549725"></a>
    44314430
    44324431printable (S)
    4433 </h3></div></div></div><a class="indexterm" name="id2549729"></a><a name="PRINTABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code>, then
     4432</h3></div></div></div><a class="indexterm" name="id2549726"></a><a name="PRINTABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code>, then
    44344433    clients may open, write to and submit spool files on the directory
    44354434    specified for the service. </p><p>Note that a printable service will ALWAYS allow writing
    … …  
    44384437    the resource.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>printable</code></em> = <code class="literal">no</code>
    44394438</em></span>
    4440 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549791"></a>
     4439</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549788"></a>
    44414440
    44424441printcap cache time (G)
    4443 </h3></div></div></div><a class="indexterm" name="id2549792"></a><a name="PRINTCAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the number of seconds before the printing
     4442</h3></div></div></div><a class="indexterm" name="id2549789"></a><a name="PRINTCAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the number of seconds before the printing
    44444443    subsystem is again asked for the known printers.  If the value
    44454444    is greater than 60 the initial waiting time is set to 60 seconds
    … …  
    44514450</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printcap cache time</code></em> = <code class="literal">600</code>
    44524451</em></span>
    4453 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549859"></a>
     4452</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549856"></a>
    44544453
    44554454<a name="PRINTCAP"></a>printcap
    4456 </h3></div></div></div><a class="indexterm" name="id2549860"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549892"></a>
     4455</h3></div></div></div><a class="indexterm" name="id2549857"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549889"></a>
    44574456
    44584457printcap name (G)
    4459 </h3></div></div></div><a class="indexterm" name="id2549893"></a><a name="PRINTCAPNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4458</h3></div></div></div><a class="indexterm" name="id2549890"></a><a name="PRINTCAPNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    44604459        This parameter may be used to override the compiled-in default printcap name used by the server (usually
    44614460        <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.
    … …  
    44924491</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printcap name</code></em> = <code class="literal">/etc/myprintcap</code>
    44934492</em></span>
    4494 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550077"></a>
     4493</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550074"></a>
    44954494
    44964495print command (S)
    4497 </h3></div></div></div><a class="indexterm" name="id2550078"></a><a name="PRINTCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>After a print job has finished spooling to
     4496</h3></div></div></div><a class="indexterm" name="id2550075"></a><a name="PRINTCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>After a print job has finished spooling to
    44984497    a service, this command will be used via a <code class="literal">system()</code>
    44994498    call to process the spool file. Typically the command specified will
    … …  
    45374536        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>
    45384537</em></span>
    4539 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550347"></a>
     4538</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550344"></a>
    45404539
    45414540printer admin (S)
    4542 </h3></div></div></div><a class="indexterm" name="id2550348"></a><a name="PRINTERADMIN"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4541</h3></div></div></div><a class="indexterm" name="id2550345"></a><a name="PRINTERADMIN"></a><div class="variablelist"><dl><dt></dt><dd><p>
    45434542        This lists users who can do anything to printers
    45444543        via the remote administration interfaces offered
    … …  
    45564555</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printer admin</code></em> = <code class="literal">admin, @staff</code>
    45574556</em></span>
    4558 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550416"></a>
     4557</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550413"></a>
    45594558
    45604559<a name="PRINTER"></a>printer
    4561 </h3></div></div></div><a class="indexterm" name="id2550417"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550447"></a>
     4560</h3></div></div></div><a class="indexterm" name="id2550414"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550444"></a>
    45624561
    45634562printer name (S)
    4564 </h3></div></div></div><a class="indexterm" name="id2550448"></a><a name="PRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4563</h3></div></div></div><a class="indexterm" name="id2550445"></a><a name="PRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    45654564        This parameter specifies the name of the printer to which print jobs spooled through a printable service
    45664565        will be sent.
    … …  
    45754574</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printer name</code></em> = <code class="literal">laserwriter</code>
    45764575</em></span>
    4577 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550534"></a>
     4576</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550532"></a>
    45784577
    45794578printing (S)
    4580 </h3></div></div></div><a class="indexterm" name="id2550535"></a><a name="PRINTING"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters controls how printer status  information is
     4579</h3></div></div></div><a class="indexterm" name="id2550533"></a><a name="PRINTING"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters controls how printer status  information is
    45814580    interpreted on your system. It also affects the  default values for
    45824581    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
    … …  
    45924591    the value for the <em class="parameter"><code>printing</code></em> option since it will
    45934592    reset the printing commands to default values.</p><p>See also the discussion in the <a class="link" href="#PRINTERSSECT" title="The [printers] section">
    4594     [printers]</a> section.</p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550670"></a>
     4593    [printers]</a> section.</p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550667"></a>
    45954594
    45964595printjob username (S)
    4597 </h3></div></div></div><a class="indexterm" name="id2550671"></a><a name="PRINTJOBUSERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies which user information will be
     4596</h3></div></div></div><a class="indexterm" name="id2550668"></a><a name="PRINTJOBUSERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies which user information will be
    45984597    passed to the printing system. Usually, the username is sent,
    45994598    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>
    … …  
    46014600</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printjob username</code></em> = <code class="literal">%D\%U</code>
    46024601</em></span>
    4603 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550732"></a>
     4602</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550728"></a>
    46044603
    46054604private dir (G)
    4606 </h3></div></div></div><a class="indexterm" name="id2550733"></a><a name="PRIVATEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters defines the directory
     4605</h3></div></div></div><a class="indexterm" name="id2550730"></a><a name="PRIVATEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters defines the directory
    46074606    smbd will use for storing such files as <code class="filename">smbpasswd</code>
    46084607    and <code class="filename">secrets.tdb</code>.
    46094608</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>private dir</code></em> = <code class="literal">${prefix}/private</code>
    46104609</em></span>
    4611 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550786"></a>
     4610</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550782"></a>
    46124611
    46134612profile acls (S)
    4614 </h3></div></div></div><a class="indexterm" name="id2550787"></a><a name="PROFILEACLS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4613</h3></div></div></div><a class="indexterm" name="id2550784"></a><a name="PROFILEACLS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    46154614        This boolean parameter was added to fix the problems that people have been
    46164615        having with storing user profiles on Samba shares from Windows 2000 or
    … …  
    46404639        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>profile acls</code></em> = <code class="literal">no</code>
    46414640</em></span>
    4642 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550858"></a>
     4641</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550855"></a>
    46434642
    46444643queuepause command (S)
    4645 </h3></div></div></div><a class="indexterm" name="id2550859"></a><a name="QUEUEPAUSECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     4644</h3></div></div></div><a class="indexterm" name="id2550856"></a><a name="QUEUEPAUSECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    46464645    executed on the server host in order to pause the printer queue.</p><p>This command should be a program or script which takes
    46474646    a printer name as its only parameter and stops the printer queue,
    … …  
    46544653        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>
    46554654</em></span>
    4656 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550935"></a>
     4655</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550932"></a>
    46574656
    46584657queueresume command (S)
    4659 </h3></div></div></div><a class="indexterm" name="id2550936"></a><a name="QUEUERESUMECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     4658</h3></div></div></div><a class="indexterm" name="id2550933"></a><a name="QUEUERESUMECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    46604659    executed on the server host in order to resume the printer queue. It
    46614660    is the command to undo the behavior that is caused by the
    … …  
    46724671</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>queueresume command</code></em> = <code class="literal">enable %p</code>
    46734672</em></span>
    4674 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551037"></a>
     4673</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551034"></a>
    46754674
    46764675read list (S)
    4677 </h3></div></div></div><a class="indexterm" name="id2551038"></a><a name="READLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4676</h3></div></div></div><a class="indexterm" name="id2551035"></a><a name="READLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
    46784677        This is a list of users that are given read-only access to a service. If the connecting user is in this list
    46794678        then they will not be given write access, no matter what the <a class="link" href="smb.conf.5.html#READONLY">read only</a> option is set
    … …  
    46854684</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>read list</code></em> = <code class="literal">mary, @students</code>
    46864685</em></span>
    4687 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551136"></a>
     4686</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551133"></a>
    46884687
    46894688read only (S)
    4690 </h3></div></div></div><a class="indexterm" name="id2551137"></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">writeable</a>.</p><p>If this parameter is <code class="constant">yes</code>, then users
     4689</h3></div></div></div><a class="indexterm" name="id2551134"></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">writeable</a>.</p><p>If this parameter is <code class="constant">yes</code>, then users
    46914690    of a service may not create or modify files in the service's
    46924691    directory.</p><p>Note that a printable service (<code class="literal">printable = yes</code>)
    … …  
    46944693    (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>
    46954694</em></span>
    4696 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551213"></a>
     4695</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551210"></a>
    46974696
    46984697read raw (G)
    4699 </h3></div></div></div><a class="indexterm" name="id2551214"></a><a name="READRAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
     4698</h3></div></div></div><a class="indexterm" name="id2551211"></a><a name="READRAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
    47004699    will support the raw read SMB requests when transferring data
    47014700    to clients.</p><p>If enabled, raw reads allow reads of 65535 bytes in
    … …  
    47064705        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>
    47074706</em></span>
    4708 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551273"></a>
     4707</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551270"></a>
    47094708
    47104709realm (G)
    4711 </h3></div></div></div><a class="indexterm" name="id2551274"></a><a name="REALM"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the kerberos realm to use. The realm is
     4710</h3></div></div></div><a class="indexterm" name="id2551271"></a><a name="REALM"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the kerberos realm to use. The realm is
    47124711        used as the ADS equivalent of the NT4 <code class="literal">domain</code>. It
    47134712        is usually set to the DNS name of the kerberos server.
    … …  
    47164715</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>realm</code></em> = <code class="literal">mysambabox.mycompany.com</code>
    47174716</em></span>
    4718 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551338"></a>
     4717</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551335"></a>
    47194718
    47204719registry shares (G)
    4721 </h3></div></div></div><a class="indexterm" name="id2551340"></a><a name="REGISTRYSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4720</h3></div></div></div><a class="indexterm" name="id2551336"></a><a name="REGISTRYSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    47224721        This turns on or off support for share definitions read from
    47234722        registry. Shares defined in <span class="emphasis"><em>smb.conf</em></span> take
    … …  
    47344733</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>registry shares</code></em> = <code class="literal">yes</code>
    47354734</em></span>
    4736 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551424"></a>
     4735</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551421"></a>
    47374736
    47384737remote announce (G)
    4739 </h3></div></div></div><a class="indexterm" name="id2551425"></a><a name="REMOTEANNOUNCE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4738</h3></div></div></div><a class="indexterm" name="id2551422"></a><a name="REMOTEANNOUNCE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    47404739        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
    47414740        to arbitrary IP addresses with an arbitrary workgroup name.
    … …  
    47614760        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>remote announce</code></em> = <code class="literal"></code>
    47624761</em></span>
    4763 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551529"></a>
     4762</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551526"></a>
    47644763
    47654764remote browse sync (G)
    4766 </h3></div></div></div><a class="indexterm" name="id2551530"></a><a name="REMOTEBROWSESYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4765</h3></div></div></div><a class="indexterm" name="id2551527"></a><a name="REMOTEBROWSESYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    47674766        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
    47684767        synchronization of browse lists with the master browser of a Samba
    … …  
    47964795        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>remote browse sync</code></em> = <code class="literal"></code>
    47974796</em></span>
    4798 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551642"></a>
     4797</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551639"></a>
    47994798
    48004799rename user script (G)
    4801 </h3></div></div></div><a class="indexterm" name="id2551643"></a><a name="RENAMEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4800</h3></div></div></div><a class="indexterm" name="id2551640"></a><a name="RENAMEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    48024801        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.
    48034802        </p><p>
    … …  
    48174816        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>rename user script</code></em> = <code class="literal">no</code>
    48184817</em></span>
    4819 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551732"></a>
     4818</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551729"></a>
    48204819
    48214820reset on zero vc (G)
    4822 </h3></div></div></div><a class="indexterm" name="id2551733"></a><a name="RESETONZEROVC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4821</h3></div></div></div><a class="indexterm" name="id2551730"></a><a name="RESETONZEROVC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    48234822        This boolean option controls whether an incoming session setup
    48244823        should kill other connections coming from the same IP. This matches
    … …  
    48394838        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>reset on zero vc</code></em> = <code class="literal">no</code>
    48404839</em></span>
    4841 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551785"></a>
     4840</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551781"></a>
    48424841
    48434842restrict anonymous (G)
    4844 </h3></div></div></div><a class="indexterm" name="id2551786"></a><a name="RESTRICTANONYMOUS"></a><div class="variablelist"><dl><dt></dt><dd><p>The setting of this parameter determines whether user and
     4843</h3></div></div></div><a class="indexterm" name="id2551782"></a><a name="RESTRICTANONYMOUS"></a><div class="variablelist"><dl><dt></dt><dd><p>The setting of this parameter determines whether user and
    48454844    group list information is returned for an anonymous connection.
    48464845    and mirrors the effects of the
    … …  
    48654864        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>restrict anonymous</code></em> = <code class="literal">0</code>
    48664865</em></span>
    4867 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551876"></a>
     4866</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551873"></a>
    48684867
    48694868<a name="ROOT"></a>root
    4870 </h3></div></div></div><a class="indexterm" name="id2551877"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551909"></a>
     4869</h3></div></div></div><a class="indexterm" name="id2551874"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551906"></a>
    48714870
    48724871<a name="ROOTDIR"></a>root dir
    4873 </h3></div></div></div><a class="indexterm" name="id2551910"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551941"></a>
     4872</h3></div></div></div><a class="indexterm" name="id2551907"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551938"></a>
    48744873
    48754874root directory (G)
    4876 </h3></div></div></div><a class="indexterm" name="id2551942"></a><a name="ROOTDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>The server will <code class="literal">chroot()</code> (i.e.
     4875</h3></div></div></div><a class="indexterm" name="id2551939"></a><a name="ROOTDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>The server will <code class="literal">chroot()</code> (i.e.
    48774876    Change its root directory) to this directory on startup. This is
    48784877    not strictly necessary for secure operation. Even without it the
    … …  
    48974896</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>root directory</code></em> = <code class="literal">/homes/smb</code>
    48984897</em></span>
    4899 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552065"></a>
     4898</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552062"></a>
    49004899
    49014900root postexec (S)
    4902 </h3></div></div></div><a class="indexterm" name="id2552066"></a><a name="ROOTPOSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4901</h3></div></div></div><a class="indexterm" name="id2552063"></a><a name="ROOTPOSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    49034902        This is the same as the <em class="parameter"><code>postexec</code></em>
    49044903        parameter except that the command is run as root. This is useful for
    … …  
    49064905        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>root postexec</code></em> = <code class="literal"></code>
    49074906</em></span>
    4908 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552114"></a>
     4907</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552110"></a>
    49094908
    49104909root preexec close (S)
    4911 </h3></div></div></div><a class="indexterm" name="id2552115"></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
     4910</h3></div></div></div><a class="indexterm" name="id2552112"></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
    49124911        </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>
    49134912</em></span>
    4914 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552162"></a>
     4913</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552159"></a>
    49154914
    49164915root preexec (S)
    4917 </h3></div></div></div><a class="indexterm" name="id2552164"></a><a name="ROOTPREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4916</h3></div></div></div><a class="indexterm" name="id2552160"></a><a name="ROOTPREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    49184917        This is the same as the <em class="parameter"><code>preexec</code></em>
    49194918        parameter except that the command is run as root. This is useful for
    … …  
    49214920        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>root preexec</code></em> = <code class="literal"></code>
    49224921</em></span>
    4923 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552210"></a>
     4922</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552207"></a>
    49244923
    49254924security mask (S)
    4926 </h3></div></div></div><a class="indexterm" name="id2552211"></a><a name="SECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4925</h3></div></div></div><a class="indexterm" name="id2552208"></a><a name="SECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
    49274926        This parameter controls what UNIX permission bits will be set when a Windows NT client is manipulating the
    49284927        UNIX permission on a file using the native NT security dialog box.
    … …  
    49434942</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>security mask</code></em> = <code class="literal">0770</code>
    49444943</em></span>
    4945 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552317"></a>
     4944</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552314"></a>
    49464945
    49474946security (G)
    4948 </h3></div></div></div><a class="indexterm" name="id2552318"></a><a name="SECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option affects how clients respond to
     4947</h3></div></div></div><a class="indexterm" name="id2552315"></a><a name="SECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option affects how clients respond to
    49494948    Samba and is one of the most important settings in the <code class="filename">
    49504949    smb.conf</code> file.</p><p>The option sets the "security mode bit" in replies to
    … …  
    50705069</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>security</code></em> = <code class="literal">DOMAIN</code>
    50715070</em></span>
    5072 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553196"></a>
     5071</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553192"></a>
    50735072
    50745073server schannel (G)
    5075 </h3></div></div></div><a class="indexterm" name="id2553197"></a><a name="SERVERSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5074</h3></div></div></div><a class="indexterm" name="id2553194"></a><a name="SERVERSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    50765075        This controls whether the server offers or even demands the use of the netlogon schannel.
    50775076        <a class="link" href="smb.conf.5.html#SERVERSCHANNEL">server schannel = no</a> does not offer the schannel, <a class="link" href="smb.conf.5.html#SERVERSCHANNEL">server schannel = auto</a> offers the schannel but does not enforce it, and <a class="link" href="smb.conf.5.html#SERVERSCHANNEL">server schannel = yes</a> denies access if the client is not able to speak netlogon schannel.
    … …  
    50845083</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>server schannel</code></em> = <code class="literal">yes</code>
    50855084</em></span>
    5086 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553312"></a>
     5085</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553308"></a>
    50875086
    50885087server signing (G)
    5089 </h3></div></div></div><a class="indexterm" name="id2553313"></a><a name="SERVERSIGNING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether the server offers or requires
     5088</h3></div></div></div><a class="indexterm" name="id2553309"></a><a name="SERVERSIGNING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether the server offers or requires
    50905089    the client it talks to to use SMB signing. Possible values
    50915090    are <span class="emphasis"><em>auto</em></span>, <span class="emphasis"><em>mandatory</em></span>
    … …  
    50955094        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>
    50965095</em></span>
    5097 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553373"></a>
     5096</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553370"></a>
    50985097
    50995098server string (G)
    5100 </h3></div></div></div><a class="indexterm" name="id2553374"></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
     5099</h3></div></div></div><a class="indexterm" name="id2553371"></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
    51015100        manager and next to the IPC connection in <code class="literal">net view</code>. It
    51025101        can be any string that you wish to show to your users.</p><p>It also sets what will appear in browse lists next
    … …  
    51075106</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>server string</code></em> = <code class="literal">University of GNUs Samba Server</code>
    51085107</em></span>
    5109 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553464"></a>
     5108</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553461"></a>
    51105109
    51115110set directory (S)
    5112 </h3></div></div></div><a class="indexterm" name="id2553465"></a><a name="SETDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5111</h3></div></div></div><a class="indexterm" name="id2553462"></a><a name="SETDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    51135112        If <code class="literal">set directory = no</code>, then        users of the
    51145113        service may not use the setdir command to change directory.
    … …  
    51195118        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>set directory</code></em> = <code class="literal">no</code>
    51205119</em></span>
    5121 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553524"></a>
     5120</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553521"></a>
    51225121
    51235122set primary group script (G)
    5124 </h3></div></div></div><a class="indexterm" name="id2553526"></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
     5123</h3></div></div></div><a class="indexterm" name="id2553522"></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
    51255124        primary group in addition to the auxiliary groups.  This script
    51265125        sets the primary group in the unix userdatase when an
    … …  
    51345133</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>
    51355134</em></span>
    5136 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553606"></a>
     5135</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553603"></a>
    51375136
    51385137set quota command (G)
    5139 </h3></div></div></div><a class="indexterm" name="id2553608"></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
     5138</h3></div></div></div><a class="indexterm" name="id2553604"></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
    51405139        whenever there is no operating system API available from the OS that
    51415140        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
    … …  
    51475146</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>
    51485147</em></span>
    5149 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553769"></a>
     5148</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553766"></a>
    51505149
    51515150share modes (S)
    5152 </h3></div></div></div><a class="indexterm" name="id2553770"></a><a name="SHAREMODES"></a><div class="variablelist"><dl><dt></dt><dd><p>This enables or disables the honoring of
     5151</h3></div></div></div><a class="indexterm" name="id2553767"></a><a name="SHAREMODES"></a><div class="variablelist"><dl><dt></dt><dd><p>This enables or disables the honoring of
    51535152        the <em class="parameter"><code>share modes</code></em> during a file open. These
    51545153        modes are used by clients to gain exclusive read or write access
    … …  
    51635162        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>
    51645163</em></span>
    5165 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553863"></a>
     5164</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553860"></a>
    51665165
    51675166short preserve case (S)
    5168 </h3></div></div></div><a class="indexterm" name="id2553864"></a><a name="SHORTPRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5167</h3></div></div></div><a class="indexterm" name="id2553861"></a><a name="SHORTPRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    51695168        This boolean parameter controls if new files which conform to 8.3 syntax, that is all in upper case and of
    51705169        suitable length, are created upper case, or if they are forced to be the <a class="link" href="smb.conf.5.html#DEFAULTCASE">default case</a>.
    … …  
    51735172        </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>
    51745173</em></span>
    5175 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553943"></a>
     5174</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553939"></a>
    51765175
    51775176show add printer wizard (G)
    5178 </h3></div></div></div><a class="indexterm" name="id2553944"></a><a name="SHOWADDPRINTERWIZARD"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printing support
     5177</h3></div></div></div><a class="indexterm" name="id2553940"></a><a name="SHOWADDPRINTERWIZARD"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printing support
    51795178    for Windows NT/2000 client in Samba 2.2, a "Printers..." folder will
    51805179    appear on Samba hosts in the share listing.  Normally this folder will
    … …  
    51945193                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>
    51955194</em></span>
    5196 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554027"></a>
     5195</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554023"></a>
    51975196
    51985197shutdown script (G)
    5199 </h3></div></div></div><a class="indexterm" name="id2554028"></a><a name="SHUTDOWNSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This a full path name to a script called by
     5198</h3></div></div></div><a class="indexterm" name="id2554024"></a><a name="SHUTDOWNSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This a full path name to a script called by
    52005199         <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> that should
    52015200        start a shutdown procedure.</p><p>If the connected user posseses the <code class="constant">SeRemoteShutdownPrivilege</code>,
    … …  
    52225221</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>
    52235222</em></span>
    5224 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554180"></a>
     5223</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554177"></a>
    52255224
    52265225smb encrypt (S)
    5227 </h3></div></div></div><a class="indexterm" name="id2554181"></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
     5226</h3></div></div></div><a class="indexterm" name="id2554178"></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
    52285227    extension to the SMB/CIFS protocol negotiated as part of the UNIX extensions.
    52295228    SMB encryption uses the GSSAPI (SSPI on Windows) ability to encrypt
    … …  
    52545253    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>
    52555254</em></span>
    5256 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554286"></a>
     5255</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554283"></a>
    52575256
    52585257smb passwd file (G)
    5259 </h3></div></div></div><a class="indexterm" name="id2554287"></a><a name="SMBPASSWDFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option sets the path to the encrypted smbpasswd file. By
     5258</h3></div></div></div><a class="indexterm" name="id2554284"></a><a name="SMBPASSWDFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option sets the path to the encrypted smbpasswd file. By
    52605259    default the path to the smbpasswd file  is compiled into Samba.</p><p>
    52615260    An example of use is:
    … …  
    52655264    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>smb passwd file</code></em> = <code class="literal">${prefix}/private/smbpasswd</code>
    52665265</em></span>
    5267 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554340"></a>
     5266</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554337"></a>
    52685267
    52695268smb ports (G)
    5270 </h3></div></div></div><a class="indexterm" name="id2554341"></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>
    5271 </em></span>
    5272 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554382"></a>
     5269</h3></div></div></div><a class="indexterm" name="id2554338"></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>
     5270</em></span>
     5271</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554378"></a>
    52735272
    52745273socket address (G)
    5275 </h3></div></div></div><a class="indexterm" name="id2554383"></a><a name="SOCKETADDRESS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to control what
     5274</h3></div></div></div><a class="indexterm" name="id2554380"></a><a name="SOCKETADDRESS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to control what
    52765275        address Samba will listen for connections on. This is used to
    52775276        support multiple virtual interfaces on the one server, each
    … …  
    52815280</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>socket address</code></em> = <code class="literal">192.168.2.20</code>
    52825281</em></span>
    5283 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554447"></a>
     5282</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554444"></a>
    52845283
    52855284socket options (G)
    5286 </h3></div></div></div><a class="indexterm" name="id2554448"></a><a name="SOCKETOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to set socket options
     5285</h3></div></div></div><a class="indexterm" name="id2554445"></a><a name="SOCKETOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to set socket options
    52875286    to be used when talking with the client.</p><p>Socket options are controls on the networking layer
    52885287    of the operating systems which allow the connection to be
    … …  
    53125311</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>socket options</code></em> = <code class="literal">IPTOS_LOWDELAY</code>
    53135312</em></span>
    5314 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554657"></a>
     5313</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554654"></a>
    53155314
    53165315stat cache (G)
    5317 </h3></div></div></div><a class="indexterm" name="id2554658"></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
     5316</h3></div></div></div><a class="indexterm" name="id2554655"></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
    53185317        speed up case insensitive name mappings. You should never need
    53195318        to change this parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>stat cache</code></em> = <code class="literal">yes</code>
    53205319</em></span>
    5321 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554708"></a>
     5320</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554705"></a>
    53225321
    53235322store dos attributes (S)
    5324 </h3></div></div></div><a class="indexterm" name="id2554709"></a><a name="STOREDOSATTRIBUTES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5323</h3></div></div></div><a class="indexterm" name="id2554706"></a><a name="STOREDOSATTRIBUTES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    53255324        If this parameter is set Samba attempts to first read DOS attributes (SYSTEM, HIDDEN, ARCHIVE or
    53265325        READ-ONLY) from a filesystem extended attribute, before mapping DOS attributes to UNIX permission bits (such
    … …  
    53345333        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>store dos attributes</code></em> = <code class="literal">no</code>
    53355334</em></span>
    5336 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554830"></a>
     5335</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554827"></a>
    53375336
    53385337strict allocate (S)
    5339 </h3></div></div></div><a class="indexterm" name="id2554831"></a><a name="STRICTALLOCATE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean that controls the handling of
     5338</h3></div></div></div><a class="indexterm" name="id2554828"></a><a name="STRICTALLOCATE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean that controls the handling of
    53405339    disk space allocation in the server. When this is set to <code class="constant">yes</code>
    53415340    the server will change from UNIX behaviour of not committing real
    … …  
    53495348    of users.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>strict allocate</code></em> = <code class="literal">no</code>
    53505349</em></span>
    5351 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554900"></a>
     5350</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554897"></a>
    53525351
    53535352strict locking (S)
    5354 </h3></div></div></div><a class="indexterm" name="id2554901"></a><a name="STRICTLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5353</h3></div></div></div><a class="indexterm" name="id2554898"></a><a name="STRICTLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
    53555354        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>,
    53565355        the server will check every read and write access for file locks, and deny access if locks exist. This can be slow on
    … …  
    53685367        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>strict locking</code></em> = <code class="literal">Auto</code>
    53695368</em></span>
    5370 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554979"></a>
     5369</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554976"></a>
    53715370
    53725371strict sync (S)
    5373 </h3></div></div></div><a class="indexterm" name="id2554980"></a><a name="STRICTSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>Many Windows applications (including the Windows 98 explorer
     5372</h3></div></div></div><a class="indexterm" name="id2554977"></a><a name="STRICTSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>Many Windows applications (including the Windows 98 explorer
    53745373    shell) seem to confuse flushing buffer contents to disk with doing
    53755374    a sync to disk. Under UNIX, a sync call forces the process to be
    … …  
    53855384    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>
    53865385</em></span>
    5387 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555043"></a>
     5386</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555041"></a>
    53885387
    53895388svcctl list (G)
    5390 </h3></div></div></div><a class="indexterm" name="id2555044"></a><a name="SVCCTLLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of init scripts that smbd
     5389</h3></div></div></div><a class="indexterm" name="id2555042"></a><a name="SVCCTLLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of init scripts that smbd
    53915390    will use for starting and stopping Unix services via the Win32
    53925391    ServiceControl API.  This allows Windows administrators to
    … …  
    54015400</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>svcctl list</code></em> = <code class="literal">cups postfix portmap httpd</code>
    54025401</em></span>
    5403 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555128"></a>
     5402</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555126"></a>
    54045403
    54055404sync always (S)
    5406 </h3></div></div></div><a class="indexterm" name="id2555130"></a><a name="SYNCALWAYS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls
     5405</h3></div></div></div><a class="indexterm" name="id2555127"></a><a name="SYNCALWAYS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls
    54075406    whether writes will always be written to stable storage before
    54085407    the write call returns. If this is <code class="constant">no</code> then the server will be
    … …  
    54155414    any affect.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>sync always</code></em> = <code class="literal">no</code>
    54165415</em></span>
    5417 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555200"></a>
     5416</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555197"></a>
    54185417
    54195418syslog only (G)
    5420 </h3></div></div></div><a class="indexterm" name="id2555201"></a><a name="SYSLOGONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5419</h3></div></div></div><a class="indexterm" name="id2555198"></a><a name="SYSLOGONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    54215420    If this parameter is set then Samba debug messages are logged into the system
    54225421    syslog only, and not to the debug log files. There still will be some
    … …  
    54245423    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>syslog only</code></em> = <code class="literal">no</code>
    54255424</em></span>
    5426 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555247"></a>
     5425</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555244"></a>
    54275426
    54285427syslog (G)
    5429 </h3></div></div></div><a class="indexterm" name="id2555248"></a><a name="SYSLOG"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5428</h3></div></div></div><a class="indexterm" name="id2555245"></a><a name="SYSLOG"></a><div class="variablelist"><dl><dt></dt><dd><p>
    54305429    This parameter maps how Samba debug messages are logged onto the system syslog logging levels.
    54315430    Samba debug level zero maps onto syslog <code class="constant">LOG_ERR</code>, debug level one maps onto
    … …  
    54385437    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>syslog</code></em> = <code class="literal">1</code>
    54395438</em></span>
    5440 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555318"></a>
     5439</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555315"></a>
    54415440
    54425441template homedir (G)
    5443 </h3></div></div></div><a class="indexterm" name="id2555319"></a><a name="TEMPLATEHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
     5442</h3></div></div></div><a class="indexterm" name="id2555316"></a><a name="TEMPLATEHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
    54445443        user, the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon  uses this
    54455444        parameter to fill in the home directory for that user. If the
    … …  
    54495448        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>
    54505449</em></span>
    5451 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555383"></a>
     5450</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555380"></a>
    54525451
    54535452template shell (G)
    5454 </h3></div></div></div><a class="indexterm" name="id2555384"></a><a name="TEMPLATESHELL"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
     5453</h3></div></div></div><a class="indexterm" name="id2555381"></a><a name="TEMPLATESHELL"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
    54555454        user, the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon uses this
    5456         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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555422"></a>
     5455        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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555419"></a>
    54575456
    54585457time offset (G)
    5459 </h3></div></div></div><a class="indexterm" name="id2555424"></a><a name="TIMEOFFSET"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a setting in minutes to add
     5458</h3></div></div></div><a class="indexterm" name="id2555420"></a><a name="TIMEOFFSET"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a setting in minutes to add
    54605459        to the normal GMT to local time conversion. This is useful if
    54615460        you are serving a lot of PCs that have incorrect daylight
    … …  
    54645463</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>time offset</code></em> = <code class="literal">60</code>
    54655464</em></span>
    5466 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555482"></a>
     5465</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555479"></a>
    54675466
    54685467time server (G)
    5469 </h3></div></div></div><a class="indexterm" name="id2555483"></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
     5468</h3></div></div></div><a class="indexterm" name="id2555480"></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
    54705469clients.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>time server</code></em> = <code class="literal">no</code>
    54715470</em></span>
    5472 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555532"></a>
     5471</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555529"></a>
    54735472
    54745473unix charset (G)
    5475 </h3></div></div></div><a class="indexterm" name="id2555533"></a><a name="UNIXCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the charset the unix machine
     5474</h3></div></div></div><a class="indexterm" name="id2555530"></a><a name="UNIXCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the charset the unix machine
    54765475                Samba runs on uses. Samba needs to know this in order to be able to
    54775476                convert text to the charsets other SMB clients use.
    … …  
    54825481</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>unix charset</code></em> = <code class="literal">ASCII</code>
    54835482</em></span>
    5484 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555598"></a>
     5483</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555595"></a>
    54855484
    54865485unix extensions (G)
    5487 </h3></div></div></div><a class="indexterm" name="id2555599"></a><a name="UNIXEXTENSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
     5486</h3></div></div></div><a class="indexterm" name="id2555596"></a><a name="UNIXEXTENSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
    54885487    implments the CIFS UNIX extensions, as defined by HP.
    54895488    These extensions enable Samba to better serve UNIX CIFS clients
    … …  
    54925491    no current use to Windows clients.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>unix extensions</code></em> = <code class="literal">yes</code>
    54935492</em></span>
    5494 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555646"></a>
     5493</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555643"></a>
    54955494
    54965495unix password sync (G)
    5497 </h3></div></div></div><a class="indexterm" name="id2555647"></a><a name="UNIXPASSWORDSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
     5496</h3></div></div></div><a class="indexterm" name="id2555644"></a><a name="UNIXPASSWORDSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
    54985497    attempts to synchronize the UNIX password with the SMB password
    54995498    when the encrypted SMB password in the smbpasswd file is changed.
    … …  
    55045503        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>
    55055504</em></span>
    5506 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555707"></a>
     5505</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555704"></a>
    55075506
    55085507update encrypted (G)
    5509 </h3></div></div></div><a class="indexterm" name="id2555708"></a><a name="UPDATEENCRYPTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5508</h3></div></div></div><a class="indexterm" name="id2555705"></a><a name="UPDATEENCRYPTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
    55105509        This boolean parameter allows a user logging on with a plaintext password to have their encrypted (hashed)
    55115510        password in the smbpasswd file to be updated automatically as they log on. This option allows a site to
    … …  
    55255524        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>update encrypted</code></em> = <code class="literal">no</code>
    55265525</em></span>
    5527 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555825"></a>
     5526</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555822"></a>
    55285527
    55295528use client driver (S)
    5530 </h3></div></div></div><a class="indexterm" name="id2555826"></a><a name="USECLIENTDRIVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter applies only to Windows NT/2000
     5529</h3></div></div></div><a class="indexterm" name="id2555823"></a><a name="USECLIENTDRIVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter applies only to Windows NT/2000
    55315530    clients.  It has no effect on Windows 95/98/ME clients.  When
    55325531    serving a printer to Windows NT/2000 clients without first installing
    … …  
    55535552        server.</em></span></p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use client driver</code></em> = <code class="literal">no</code>
    55545553</em></span>
    5555 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555918"></a>
     5554</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555914"></a>
    55565555
    55575556use kerberos keytab (G)
    5558 </h3></div></div></div><a class="indexterm" name="id2555919"></a><a name="USEKERBEROSKEYTAB"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5557</h3></div></div></div><a class="indexterm" name="id2555916"></a><a name="USEKERBEROSKEYTAB"></a><div class="variablelist"><dl><dt></dt><dd><p>
    55595558        Specifies whether Samba should attempt to maintain service principals in the systems
    55605559        keytab file for <code class="constant">host/FQDN</code> and <code class="constant">cifs/FQDN</code>.
    … …  
    55685567        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use kerberos keytab</code></em> = <code class="literal">False</code>
    55695568</em></span>
    5570 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555986"></a>
     5569</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555983"></a>
    55715570
    55725571use mmap (G)
    5573 </h3></div></div></div><a class="indexterm" name="id2555987"></a><a name="USEMMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>This global parameter determines if the tdb internals of Samba can
     5572</h3></div></div></div><a class="indexterm" name="id2555984"></a><a name="USEMMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>This global parameter determines if the tdb internals of Samba can
    55745573    depend on mmap working correctly on the running system. Samba requires a coherent
    55755574    mmap/read-write system memory cache. Currently only HPUX does not have such a
    … …  
    55805579    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use mmap</code></em> = <code class="literal">yes</code>
    55815580</em></span>
    5582 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556039"></a>
     5581</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556035"></a>
    55835582
    55845583username level (G)
    5585 </h3></div></div></div><a class="indexterm" name="id2556040"></a><a name="USERNAMELEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option helps Samba to try and 'guess' at
     5584</h3></div></div></div><a class="indexterm" name="id2556036"></a><a name="USERNAMELEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option helps Samba to try and 'guess' at
    55865585    the real UNIX username, as many DOS clients send an all-uppercase
    55875586    username. By default Samba tries all lowercase, followed by the
    … …  
    55985597</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>username level</code></em> = <code class="literal">5</code>
    55995598</em></span>
    5600 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556120"></a>
     5599</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556117"></a>
    56015600
    56025601username map script (G)
    5603 </h3></div></div></div><a class="indexterm" name="id2556121"></a><a name="USERNAMEMAPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This script is a mutually exclusive alternative to the
     5602</h3></div></div></div><a class="indexterm" name="id2556118"></a><a name="USERNAMEMAPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This script is a mutually exclusive alternative to the
    56045603        <a class="link" href="smb.conf.5.html#USERNAMEMAP">username map</a> parameter.  This parameter
    56055604        specifies and external program or script that must accept a single
    … …  
    56125611</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>
    56135612</em></span>
    5614 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556196"></a>
     5613</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556193"></a>
    56155614
    56165615username map (G)
    5617 </h3></div></div></div><a class="indexterm" name="id2556197"></a><a name="USERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5616</h3></div></div></div><a class="indexterm" name="id2556194"></a><a name="USERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    56185617        This option allows you to specify a file containing a mapping of usernames from the clients to the server.
    56195618        This can be used for several purposes. The most common is to map usernames that users use on DOS or Windows
    … …  
    56995698# no username map</code>
    57005699</em></span>
    5701 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556476"></a>
     5700</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556473"></a>
    57025701
    57035702<a name="USER"></a>user
    5704 </h3></div></div></div><a class="indexterm" name="id2556477"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556508"></a>
     5703</h3></div></div></div><a class="indexterm" name="id2556474"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556505"></a>
    57055704
    57065705<a name="USERS"></a>users
    5707 </h3></div></div></div><a class="indexterm" name="id2556509"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556539"></a>
     5706</h3></div></div></div><a class="indexterm" name="id2556506"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556537"></a>
    57085707
    57095708username (S)
    5710 </h3></div></div></div><a class="indexterm" name="id2556540"></a><a name="USERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>Multiple users may be specified in a comma-delimited
     5709</h3></div></div></div><a class="indexterm" name="id2556538"></a><a name="USERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>Multiple users may be specified in a comma-delimited
    57115710    list, in which case the supplied password will be tested against
    57125711    each username in turn (left to right).</p><p>The <em class="parameter"><code>username</code></em> line is needed only when
    … …  
    57465745</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>username</code></em> = <code class="literal">fred, mary, jack, jane, @users, @pcgroup</code>
    57475746</em></span>
    5748 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556709"></a>
     5747</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556707"></a>
    57495748
    57505749usershare allow guests (G)
    5751 </h3></div></div></div><a class="indexterm" name="id2556710"></a><a name="USERSHAREALLOWGUESTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether user defined shares are allowed
     5750</h3></div></div></div><a class="indexterm" name="id2556708"></a><a name="USERSHAREALLOWGUESTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether user defined shares are allowed
    57525751        to be accessed by non-authenticated users or not. It is the equivalent
    57535752        of allowing people who can create a share the option of setting
    … …  
    57565755        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>
    57575756</em></span>
    5758 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556762"></a>
     5757</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556760"></a>
    57595758
    57605759usershare max shares (G)
    5761 </h3></div></div></div><a class="indexterm" name="id2556763"></a><a name="USERSHAREMAXSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of user defined shares
     5760</h3></div></div></div><a class="indexterm" name="id2556761"></a><a name="USERSHAREMAXSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of user defined shares
    57625761        that are allowed to be created by users belonging to the group owning the
    57635762        usershare directory. If set to zero (the default) user defined shares are ignored.
    57645763        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare max shares</code></em> = <code class="literal">0</code>
    57655764</em></span>
    5766 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556808"></a>
     5765</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556805"></a>
    57675766
    57685767usershare owner only (G)
    5769 </h3></div></div></div><a class="indexterm" name="id2556809"></a><a name="USERSHAREOWNERONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether the pathname exported by
     5768</h3></div></div></div><a class="indexterm" name="id2556806"></a><a name="USERSHAREOWNERONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether the pathname exported by
    57705769        a user defined shares must be owned by the user creating the
    57715770        user defined share or not. If set to True (the default) then
    … …  
    57775776        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare owner only</code></em> = <code class="literal">True</code>
    57785777</em></span>
    5779 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556857"></a>
     5778</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556855"></a>
    57805779
    57815780usershare path (G)
    5782 </h3></div></div></div><a class="indexterm" name="id2556858"></a><a name="USERSHAREPATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the absolute path of the directory on the
     5781</h3></div></div></div><a class="indexterm" name="id2556856"></a><a name="USERSHAREPATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the absolute path of the directory on the
    57835782        filesystem used to store the user defined share definition files.
    57845783        This directory must be owned by root, and have no access for
    … …  
    58015800        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare path</code></em> = <code class="literal">NULL</code>
    58025801</em></span>
    5803 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556928"></a>
     5802</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556926"></a>
    58045803
    58055804usershare prefix allow list (G)
    5806 </h3></div></div></div><a class="indexterm" name="id2556929"></a><a name="USERSHAREPREFIXALLOWLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
     5805</h3></div></div></div><a class="indexterm" name="id2556927"></a><a name="USERSHAREPREFIXALLOWLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
    58075806        the root of which are allowed to be exported by user defined share definitions.
    58085807        If the pathname exported doesn't start with one of the strings in this
    … …  
    58195818</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>usershare prefix allow list</code></em> = <code class="literal">/home /data /space</code>
    58205819</em></span>
    5821 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557001"></a>
     5820</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556998"></a>
    58225821
    58235822usershare prefix deny list (G)
    5824 </h3></div></div></div><a class="indexterm" name="id2557002"></a><a name="USERSHAREPREFIXDENYLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
     5823</h3></div></div></div><a class="indexterm" name="id2556999"></a><a name="USERSHAREPREFIXDENYLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
    58255824        the root of which are NOT allowed to be exported by user defined share definitions.
    58265825        If the pathname exported starts with one of the strings in this
    … …  
    58385837</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>usershare prefix deny list</code></em> = <code class="literal">/etc /dev /private</code>
    58395838</em></span>
    5840 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557076"></a>
     5839</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557073"></a>
    58415840
    58425841usershare template share (G)
    5843 </h3></div></div></div><a class="indexterm" name="id2557077"></a><a name="USERSHARETEMPLATESHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>User defined shares only have limited possible parameters
     5842</h3></div></div></div><a class="indexterm" name="id2557074"></a><a name="USERSHARETEMPLATESHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>User defined shares only have limited possible parameters
    58445843        such as path, guest ok etc. This parameter allows usershares to
    58455844        "cloned" from an existing share. If "usershare template share"
    … …  
    58565855</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>usershare template share</code></em> = <code class="literal">template_share</code>
    58575856</em></span>
    5858 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557148"></a>
     5857</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557146"></a>
    58595858
    58605859use sendfile (S)
    5861 </h3></div></div></div><a class="indexterm" name="id2557149"></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>
     5860</h3></div></div></div><a class="indexterm" name="id2557147"></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>
    58625861    system call is supported by the underlying operating system, then some SMB read calls
    58635862    (mainly ReadAndX and ReadRaw) will use the more efficient sendfile system call for files that
    … …  
    58685867    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use sendfile</code></em> = <code class="literal">false</code>
    58695868</em></span>
    5870 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557206"></a>
     5869</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557203"></a>
    58715870
    58725871use spnego (G)
    5873 </h3></div></div></div><a class="indexterm" name="id2557207"></a><a name="USESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p>This variable controls controls whether samba will try
     5872</h3></div></div></div><a class="indexterm" name="id2557204"></a><a name="USESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p>This variable controls controls whether samba will try
    58745873    to use Simple and Protected NEGOciation (as specified by rfc2478) with
    58755874    WindowsXP and Windows2000 clients to agree upon an authentication mechanism.
    … …  
    58795878        disabled.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use spnego</code></em> = <code class="literal">yes</code>
    58805879</em></span>
    5881 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557255"></a>
     5880</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557252"></a>
    58825881
    58835882utmp directory (G)
    5884 </h3></div></div></div><a class="indexterm" name="id2557256"></a><a name="UTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only available if Samba has
     5883</h3></div></div></div><a class="indexterm" name="id2557254"></a><a name="UTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only available if Samba has
    58855884        been configured and compiled with the option <code class="literal">
    58865885        --with-utmp</code>. It specifies a directory pathname that is
    … …  
    58945893</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>utmp directory</code></em> = <code class="literal">/var/run/utmp</code>
    58955894</em></span>
    5896 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557333"></a>
     5895</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557330"></a>
    58975896
    58985897utmp (G)
    5899 </h3></div></div></div><a class="indexterm" name="id2557334"></a><a name="UTMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5898</h3></div></div></div><a class="indexterm" name="id2557332"></a><a name="UTMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    59005899        This boolean parameter is only available if Samba has been configured and compiled 
    59015900        with the option <code class="literal">--with-utmp</code>. If set to
    … …  
    59095908        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>utmp</code></em> = <code class="literal">no</code>
    59105909</em></span>
    5911 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557396"></a>
     5910</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557393"></a>
    59125911
    59135912valid users (S)
    5914 </h3></div></div></div><a class="indexterm" name="id2557397"></a><a name="VALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5913</h3></div></div></div><a class="indexterm" name="id2557394"></a><a name="VALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    59155914    This is a list of users that should be allowed to login to this service. Names starting with
    59165915    '@', '+' and  '&amp;' are interpreted using the same rules as described in the
    … …  
    59285927</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>valid users</code></em> = <code class="literal">greg, @pcusers</code>
    59295928</em></span>
    5930 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557487"></a>
     5929</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557484"></a>
    59315930
    59325931-valid (S)
    5933 </h3></div></div></div><a class="indexterm" name="id2557488"></a><a name="-VALID"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter indicates whether a share is
     5932</h3></div></div></div><a class="indexterm" name="id2557486"></a><a name="-VALID"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter indicates whether a share is
    59345933        valid and thus can be used. When this parameter is set to false,
    59355934        the share will be in no way visible nor accessible.
    … …  
    59405939        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>-valid</code></em> = <code class="literal">yes</code>
    59415940</em></span>
    5942 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557536"></a>
     5941</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557534"></a>
    59435942
    59445943veto files (S)
    5945 </h3></div></div></div><a class="indexterm" name="id2557538"></a><a name="VETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5944</h3></div></div></div><a class="indexterm" name="id2557535"></a><a name="VETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    59465945        This is a list of files and directories that are neither visible nor accessible.  Each entry in
    59475946        the list must be separated by a '/', which allows spaces to be included in the entry. '*' and '?'
    … …  
    59745973        </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>
    59755974</em></span>
    5976 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557655"></a>
     5975</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557652"></a>
    59775976
    59785977veto oplock files (S)
    5979 </h3></div></div></div><a class="indexterm" name="id2557656"></a><a name="VETOOPLOCKFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5978</h3></div></div></div><a class="indexterm" name="id2557654"></a><a name="VETOOPLOCKFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    59805979        This parameter is only valid when the <a class="link" href="smb.conf.5.html#OPLOCKS">oplocks</a>
    59815980        parameter is turned on for a share. It allows the Samba administrator
    … …  
    59985997# No files are vetoed for oplock grants</code>
    59995998</em></span>
    6000 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557748"></a>
     5999</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557746"></a>
    60016000
    60026001<a name="VFSOBJECT"></a>vfs object
    6003 </h3></div></div></div><a class="indexterm" name="id2557749"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557780"></a>
     6002</h3></div></div></div><a class="indexterm" name="id2557747"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557778"></a>
    60046003
    60056004vfs objects (S)
    6006 </h3></div></div></div><a class="indexterm" name="id2557781"></a><a name="VFSOBJECTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the backend names which
     6005</h3></div></div></div><a class="indexterm" name="id2557779"></a><a name="VFSOBJECTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the backend names which
    60076006        are used for Samba VFS I/O operations.  By default, normal
    60086007        disk I/O operations are used but these can be overloaded
    … …  
    60116010</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>vfs objects</code></em> = <code class="literal">extd_audit recycle</code>
    60126011</em></span>
    6013 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557840"></a>
     6012</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557838"></a>
    60146013
    60156014volume (S)
    6016 </h3></div></div></div><a class="indexterm" name="id2557841"></a><a name="VOLUME"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the volume label
     6015</h3></div></div></div><a class="indexterm" name="id2557839"></a><a name="VOLUME"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the volume label
    60176016        returned for a share. Useful for CDROMs with installation programs
    60186017        that insist on a particular volume label.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>volume</code></em> = <code class="literal">
    60196018# the name of the share</code>
    60206019</em></span>
    6021 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557884"></a>
     6020</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557881"></a>
    60226021
    60236022wide links (S)
    6024 </h3></div></div></div><a class="indexterm" name="id2557885"></a><a name="WIDELINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not links
     6023</h3></div></div></div><a class="indexterm" name="id2557882"></a><a name="WIDELINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not links
    60256024        in the UNIX file system may be followed by the server. Links
    60266025        that point to areas within the directory tree exported by the
    … …  
    60306029        that Samba has to  do in order to perform the link checks.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>wide links</code></em> = <code class="literal">yes</code>
    60316030</em></span>
    6032 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557936"></a>
     6031</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557933"></a>
    60336032
    60346033winbind cache time (G)
    6035 </h3></div></div></div><a class="indexterm" name="id2557937"></a><a name="WINBINDCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of
     6034</h3></div></div></div><a class="indexterm" name="id2557934"></a><a name="WINBINDCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of
    60366035        seconds the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon will cache
    60376036        user and group information before querying a Windows NT server
    … …  
    60416040        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind cache time</code></em> = <code class="literal">300</code>
    60426041</em></span>
    6043 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558007"></a>
     6042</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558005"></a>
    60446043
    60456044winbind enum groups (G)
    6046 </h3></div></div></div><a class="indexterm" name="id2558008"></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
     6045</h3></div></div></div><a class="indexterm" name="id2558006"></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
    60476046        the enumeration of groups through the <code class="literal">setgrent()</code>,
    60486047        <code class="literal">getgrent()</code> and
    … …  
    60526051        call will not return any data. </p><div class="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>
    60536052</em></span>
    6054 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558098"></a>
     6053</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558095"></a>
    60556054
    60566055winbind enum users (G)
    6057 </h3></div></div></div><a class="indexterm" name="id2558099"></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
     6056</h3></div></div></div><a class="indexterm" name="id2558096"></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
    60586057        necessary to suppress the enumeration of users through the <code class="literal">setpwent()</code>,
    60596058         <code class="literal">getpwent()</code> and
    … …  
    60676066        usernames. </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind enum users</code></em> = <code class="literal">no</code>
    60686067</em></span>
    6069 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558192"></a>
     6068</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558189"></a>
    60706069
    60716070winbind expand groups (G)
    6072 </h3></div></div></div><a class="indexterm" name="id2558193"></a><a name="WINBINDEXPANDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum depth that winbindd
     6071</h3></div></div></div><a class="indexterm" name="id2558190"></a><a name="WINBINDEXPANDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum depth that winbindd
    60736072              will traverse when flattening nested group memberships
    60746073              of Windows domain groups.  This is different from the
    … …  
    60826081         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>
    60836082</em></span>
    6084 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558260"></a>
     6083</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558257"></a>
    60856084
    60866085winbind nested groups (G)
    6087 </h3></div></div></div><a class="indexterm" name="id2558261"></a><a name="WINBINDNESTEDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to yes, this parameter activates the support for nested
     6086</h3></div></div></div><a class="indexterm" name="id2558258"></a><a name="WINBINDNESTEDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to yes, this parameter activates the support for nested
    60886087                 groups. Nested groups are also called local groups or
    60896088                 aliases. They work like their counterparts in Windows: Nested
    … …  
    60936092                 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>
    60946093</em></span>
    6095 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558310"></a>
     6094</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558307"></a>
    60966095
    60976096winbind normalize names (G)
    6098 </h3></div></div></div><a class="indexterm" name="id2558311"></a><a name="WINBINDNORMALIZENAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether winbindd will replace
     6097</h3></div></div></div><a class="indexterm" name="id2558308"></a><a name="WINBINDNORMALIZENAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether winbindd will replace
    60996098        whitespace in user and group names with an underscore (_) character.
    61006099        For example, whether the name "Space Kadet" should be
    … …  
    61086107</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind normalize names</code></em> = <code class="literal">yes</code>
    61096108</em></span>
    6110 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558376"></a>
     6109</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558373"></a>
    61116110
    61126111winbind nss info (G)
    6113 </h3></div></div></div><a class="indexterm" name="id2558377"></a><a name="WINBINDNSSINFO"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control how Winbind retrieves Name
     6112</h3></div></div></div><a class="indexterm" name="id2558374"></a><a name="WINBINDNSSINFO"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control how Winbind retrieves Name
    61146113        Service Information to construct a user's home directory and login shell.
    61156114        Currently the following settings are available:
    … …  
    61336132</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind nss info</code></em> = <code class="literal">template sfu</code>
    61346133</em></span>
    6135 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558496"></a>
     6134</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558493"></a>
    61366135
    61376136winbind offline logon (G)
    6138 </h3></div></div></div><a class="indexterm" name="id2558497"></a><a name="WINBINDOFFLINELOGON"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control whether Winbind should
     6137</h3></div></div></div><a class="indexterm" name="id2558494"></a><a name="WINBINDOFFLINELOGON"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control whether Winbind should
    61396138        allow to login with the <em class="parameter"><code>pam_winbind</code></em>
    61406139        module using Cached Credentials. If enabled, winbindd will store user credentials
    … …  
    61446143</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind offline logon</code></em> = <code class="literal">true</code>
    61456144</em></span>
    6146 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558565"></a>
     6145</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558562"></a>
    61476146
    61486147winbind refresh tickets (G)
    6149 </h3></div></div></div><a class="indexterm" name="id2558566"></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
     6148</h3></div></div></div><a class="indexterm" name="id2558563"></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
    61506149        retrieved using the <em class="parameter"><code>pam_winbind</code></em> module.
    61516150
    … …  
    61546153</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind refresh tickets</code></em> = <code class="literal">true</code>
    61556154</em></span>
    6156 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558632"></a>
     6155</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558628"></a>
    61576156
    61586157winbind rpc only (G)
    6159 </h3></div></div></div><a class="indexterm" name="id2558633"></a><a name="WINBINDRPCONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6158</h3></div></div></div><a class="indexterm" name="id2558630"></a><a name="WINBINDRPCONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    61606159        Setting this parameter to <code class="literal">yes</code> forces
    61616160        winbindd to use RPC instead of LDAP to retrieve information from Domain
    … …  
    61636162        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind rpc only</code></em> = <code class="literal">no</code>
    61646163</em></span>
    6165 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558681"></a>
     6164</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558677"></a>
    61666165
    61676166winbind separator (G)
    6168 </h3></div></div></div><a class="indexterm" name="id2558682"></a><a name="WINBINDSEPARATOR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows an admin to define the character
     6167</h3></div></div></div><a class="indexterm" name="id2558678"></a><a name="WINBINDSEPARATOR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows an admin to define the character
    61696168        used when listing a username of the form of <em class="replaceable"><code>DOMAIN
    61706169        </code></em>\<em class="replaceable"><code>user</code></em>.  This parameter
    … …  
    61776176</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind separator</code></em> = <code class="literal">+</code>
    61786177</em></span>
    6179 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558768"></a>
     6178</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558764"></a>
    61806179
    61816180winbind trusted domains only (G)
    6182 </h3></div></div></div><a class="indexterm" name="id2558769"></a><a name="WINBINDTRUSTEDDOMAINSONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6181</h3></div></div></div><a class="indexterm" name="id2558765"></a><a name="WINBINDTRUSTEDDOMAINSONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    61836182        This parameter is designed to allow Samba servers that are members
    61846183        of a Samba controlled domain to use UNIX accounts distributed via NIS,
    … …  
    61926191        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind trusted domains only</code></em> = <code class="literal">no</code>
    61936192</em></span>
    6194 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558847"></a>
     6193</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558844"></a>
    61956194
    61966195winbind use default domain (G)
    6197 </h3></div></div></div><a class="indexterm" name="id2558848"></a><a name="WINBINDUSEDEFAULTDOMAIN"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether the
     6196</h3></div></div></div><a class="indexterm" name="id2558845"></a><a name="WINBINDUSEDEFAULTDOMAIN"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether the
    61986197         <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon should operate on users 
    61996198        without domain component in their username. Users without a domain
    … …  
    62056204</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind use default domain</code></em> = <code class="literal">yes</code>
    62066205</em></span>
    6207 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558919"></a>
     6206</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558916"></a>
    62086207
    62096208wins hook (G)
    6210 </h3></div></div></div><a class="indexterm" name="id2558920"></a><a name="WINSHOOK"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba is running as a WINS server this
     6209</h3></div></div></div><a class="indexterm" name="id2558917"></a><a name="WINSHOOK"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba is running as a WINS server this
    62116210        allows you to call an external program for all changes to the
    62126211        WINS database. The primary use for this option is to allow the
    … …  
    62296228                        empty then the name should be deleted.</p></li></ul></div><p>An example script that calls the BIND dynamic DNS update
    62306229        program <code class="literal">nsupdate</code> is provided in the examples
    6231         directory of the Samba source code. </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559025"></a>
     6230        directory of the Samba source code. </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559022"></a>
    62326231
    62336232wins proxy (G)
    6234 </h3></div></div></div><a class="indexterm" name="id2559026"></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
     6233</h3></div></div></div><a class="indexterm" name="id2559024"></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
    62356234        queries on behalf of  other hosts. You may need to set this
    62366235        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>
    62376236</em></span>
    6238 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559080"></a>
     6237</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559077"></a>
    62396238
    62406239wins server (G)
    6241 </h3></div></div></div><a class="indexterm" name="id2559081"></a><a name="WINSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the IP address (or DNS name: IP
     6240</h3></div></div></div><a class="indexterm" name="id2559078"></a><a name="WINSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the IP address (or DNS name: IP
    62426241        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
    62436242        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
    … …  
    62586257</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>
    62596258</em></span>
    6260 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559190"></a>
     6259</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559188"></a>
    62616260
    62626261wins support (G)
    6263 </h3></div></div></div><a class="indexterm" name="id2559191"></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
     6262</h3></div></div></div><a class="indexterm" name="id2559189"></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
    62646263        not set this to <code class="constant">yes</code> unless you have a multi-subnetted network and
    62656264        you wish a particular <code class="literal">nmbd</code> to be your WINS server.
    … …  
    62676266        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>
    62686267</em></span>
    6269 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559260"></a>
     6268</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559257"></a>
    62706269
    62716270workgroup (G)
    6272 </h3></div></div></div><a class="indexterm" name="id2559261"></a><a name="WORKGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what workgroup your server will
     6271</h3></div></div></div><a class="indexterm" name="id2559258"></a><a name="WORKGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what workgroup your server will
    62736272        appear to be in when queried by clients. Note that this parameter
    62746273        also controls the Domain name used with
    … …  
    62786277</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>workgroup</code></em> = <code class="literal">MYGROUP</code>
    62796278</em></span>
    6280 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559332"></a>
     6279</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559329"></a>
    62816280
    62826281<a name="WRITABLE"></a>writable
    6283 </h3></div></div></div><a class="indexterm" name="id2559333"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559363"></a>
     6282</h3></div></div></div><a class="indexterm" name="id2559330"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559360"></a>
    62846283
    62856284writeable (S)
    6286 </h3></div></div></div><a class="indexterm" name="id2559364"></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">read only</a>.</p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559402"></a>
     6285</h3></div></div></div><a class="indexterm" name="id2559362"></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">read only</a>.</p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559399"></a>
    62876286
    62886287write cache size (S)
    6289 </h3></div></div></div><a class="indexterm" name="id2559403"></a><a name="WRITECACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this integer parameter is set to non-zero value,
     6288</h3></div></div></div><a class="indexterm" name="id2559400"></a><a name="WRITECACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this integer parameter is set to non-zero value,
    62906289    Samba will create an in-memory cache for each oplocked file
    62916290    (it does <span class="emphasis"><em>not</em></span> do this for
    … …  
    63056304#  for a 256k cache size per file</code>
    63066305</em></span>
    6307 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559485"></a>
     6306</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559483"></a>
    63086307
    63096308write list (S)
    6310 </h3></div></div></div><a class="indexterm" name="id2559486"></a><a name="WRITELIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6309</h3></div></div></div><a class="indexterm" name="id2559484"></a><a name="WRITELIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
    63116310    This is a list of users that are given read-write access to a service. If the
    63126311    connecting user is in this list then they will be given write access, no matter
    … …  
    63236322</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>write list</code></em> = <code class="literal">admin, root, @staff</code>
    63246323</em></span>
    6325 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559579"></a>
     6324</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559576"></a>
    63266325
    63276326write raw (G)
    6328 </h3></div></div></div><a class="indexterm" name="id2559580"></a><a name="WRITERAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
     6327</h3></div></div></div><a class="indexterm" name="id2559577"></a><a name="WRITERAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
    63296328    will support raw write SMB's when transferring data from clients.
    63306329    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>
    63316330</em></span>
    6332 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559622"></a>
     6331</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559620"></a>
    63336332
    63346333wtmp directory (G)
    6335 </h3></div></div></div><a class="indexterm" name="id2559623"></a><a name="WTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6334</h3></div></div></div><a class="indexterm" name="id2559621"></a><a name="WTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    63366335        This parameter is only available if Samba has been configured and compiled with the option <code class="literal">
    63376336        --with-utmp</code>. It specifies a directory pathname that is used to store the wtmp or wtmpx files (depending on
    … …  
    63456344</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>wtmp directory</code></em> = <code class="literal">/var/log/wtmp</code>
    63466345</em></span>
    6347 </p></dd></dl></div></div></div></div><div class="refsect1" lang="en"><a name="id2559706"></a><h2>WARNINGS</h2><p>
     6346</p></dd></dl></div></div></div></div><div class="refsect1" lang="en"><a name="id2559703"></a><h2>WARNINGS</h2><p>
    63486347        Although the configuration file permits service names to contain spaces, your client software may not.
    63496348        Spaces will be ignored in comparisons anyway, so it shouldn't be a problem - but be aware of the possibility.
    … …  
    63586357        care when designing these sections. In particular, ensure that the permissions on spool directories are
    63596358        correct.
    6360         </p></div><div class="refsect1" lang="en"><a name="id2559756"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2559767"></a><h2>SEE ALSO</h2><p>
    6361         <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" lang="en"><a name="id2559846"></a><h2>AUTHOR</h2><p>
     6359        </p></div><div class="refsect1" lang="en"><a name="id2559753"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2559764"></a><h2>SEE ALSO</h2><p>
     6360        <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" lang="en"><a name="id2559844"></a><h2>AUTHOR</h2><p>
    63626361        The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed
    63636362        by the Samba Team as an Open Source project similar to the way the Linux kernel is developed.

  • branches/samba-3.2.x/docs/htmldocs/manpages/smbcacls.1.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2479215"></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" lang="en"><a name="id2479244"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2479216"></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" lang="en"><a name="id2479245"></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 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 acls</span></dt><dd><p>Modify the mask value (permissions) for the ACLs
    … …  
    5353<code class="constant">".progname"</code> will be appended (e.g. log.smbclient,
    5454log.smbd, etc...). The log file is never removed by the client.
    55 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478381"></a><h2>ACL FORMAT</h2><p>The format of an ACL is one or more ACL entries separated by
     55</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478382"></a><h2>ACL FORMAT</h2><p>The format of an ACL is one or more ACL entries separated by
    5656        either commas or newlines.  An ACL entry is one of the following: </p><pre class="programlisting">
    5757REVISION:&lt;revision number&gt;
    … …  
    7878                permissions</p></li><li><p><span class="emphasis"><em>CHANGE</em></span> - Equivalent to 'RXWD' permissions
    7979                </p></li><li><p><span class="emphasis"><em>FULL</em></span> - Equivalent to 'RWXDPO'
    80                 permissions</p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2478546"></a><h2>EXIT STATUS</h2><p>The <code class="literal">smbcacls</code> program sets the exit status
     80                permissions</p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2478547"></a><h2>EXIT STATUS</h2><p>The <code class="literal">smbcacls</code> program sets the exit status
    8181        depending on the success or otherwise of the operations performed. 
    8282        The exit status may be one of the following values. </p><p>If the operation succeeded, smbcacls returns and exit
    … …  
    8484        or there was an error getting or setting the ACLs, an exit status
    8585        of 1 is returned.  If there was an error parsing any command line
    86         arguments, an exit status of 2 is returned. </p></div><div class="refsect1" lang="en"><a name="id2478579"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478590"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     86        arguments, an exit status of 2 is returned. </p></div><div class="refsect1" lang="en"><a name="id2478580"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478591"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    8787        were created by Andrew Tridgell. Samba is now developed
    8888        by the Samba Team as an Open Source project similar

  • branches/samba-3.2.x/docs/htmldocs/manpages/smbclient.1.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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] [-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] [-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" lang="en"><a name="id2479451"></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"><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] [-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] [-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" lang="en"><a name="id2479452"></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" lang="en"><a name="id2479491"></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" lang="en"><a name="id2479492"></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
    … …  
    268268                commands to be executed instead of prompting from stdin. <em class="parameter"><code>
    269269                -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
    270                 to the server, e.g. <code class="literal">-c 'print -'</code>. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2526299"></a><h2>OPERATIONS</h2><p>Once the client is running, the user is presented with
     270                to the server, e.g. <code class="literal">-c 'print -'</code>. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2526294"></a><h2>OPERATIONS</h2><p>Once the client is running, the user is presented with
    271271        a prompt : </p><p><code class="prompt">smb:\&gt; </code></p><p>The backslash ("\\") indicates the current working directory
    272272        on the server, and will change if the current working directory
    … …  
    466466                the given arbitrary number. Without an argument prints out the current
    467467                vuid being used. Used for internal Samba testing purposes.
    468                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2527422"></a><h2>NOTES</h2><p>Some servers are fussy about the case of supplied usernames,
     468                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2527418"></a><h2>NOTES</h2><p>Some servers are fussy about the case of supplied usernames,
    469469        passwords, share names (AKA service names) and machine names.
    470470        If you fail to connect try giving all parameters in uppercase.
    … …  
    473473        on a valid NetBIOS name being used, so you need to supply a valid
    474474        name that would be known to the server.</p><p>smbclient supports long file names where the server
    475         supports the LANMAN2 protocol or above. </p></div><div class="refsect1" lang="en"><a name="id2527448"></a><h2>ENVIRONMENT VARIABLES</h2><p>The variable <code class="envar">USER</code> may contain the
     475        supports the LANMAN2 protocol or above. </p></div><div class="refsect1" lang="en"><a name="id2527443"></a><h2>ENVIRONMENT VARIABLES</h2><p>The variable <code class="envar">USER</code> may contain the
    476476        username of the person  using the client. This information is
    477477        used only if the protocol  level is high enough to support
    … …  
    483483        to instead of connecting to a server.  This functionality is primarily
    484484        intended as a development aid, and works best when using a LMHOSTS
    485         file</p></div><div class="refsect1" lang="en"><a name="id2527486"></a><h2>INSTALLATION</h2><p>The location of the client program is a matter for
     485        file</p></div><div class="refsect1" lang="en"><a name="id2527481"></a><h2>INSTALLATION</h2><p>The location of the client program is a matter for
    486486        individual system administrators. The following are thus
    487487        suggestions only. </p><p>It is recommended that the smbclient software be installed
    … …  
    494494        running SMB/CIFS server. It is possible to run <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> as an ordinary user - running that server as a daemon
    495495        on a user-accessible port (typically any port number over 1024)
    496         would provide a suitable test server. </p></div><div class="refsect1" lang="en"><a name="id2527541"></a><h2>DIAGNOSTICS</h2><p>Most diagnostics issued by the client are logged in a
     496        would provide a suitable test server. </p></div><div class="refsect1" lang="en"><a name="id2527537"></a><h2>DIAGNOSTICS</h2><p>Most diagnostics issued by the client are logged in a
    497497        specified log file. The log file name is specified at compile time,
    498498        but may be overridden on the command line. </p><p>The number and nature of diagnostics available depends
    499499        on the debug level used by the client. If you have problems,
    500         set the debug level to 3 and peruse the log files. </p></div><div class="refsect1" lang="en"><a name="id2527560"></a><h2>VERSION</h2><p>This man page is correct for version 3.2 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2527571"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     500        set the debug level to 3 and peruse the log files. </p></div><div class="refsect1" lang="en"><a name="id2527556"></a><h2>VERSION</h2><p>This man page is correct for version 3.2 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2527567"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    501501        were created by Andrew Tridgell. Samba is now developed
    502502        by the Samba Team as an Open Source project similar

  • branches/samba-3.2.x/docs/htmldocs/manpages/smbcontrol.1.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2479176"></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" lang="en"><a name="id2479227"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2480138"></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" lang="en"><a name="id2480189"></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 &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the
    44configuration details required by the server.  The
    … …  
    1717                to only that process.</p></dd><dt><span class="term">message-type</span></dt><dd><p>Type of message to send. See
    1818                the section <code class="constant">MESSAGE-TYPES</code> for details.
    19                 </p></dd><dt><span class="term">parameters</span></dt><dd><p>any parameters required for the message-type</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479370"></a><h2>MESSAGE-TYPES</h2><p>Available message types are:</p><div class="variablelist"><dl><dt><span class="term">close-share</span></dt><dd><p>Order smbd to close the client
     19                </p></dd><dt><span class="term">parameters</span></dt><dd><p>any parameters required for the message-type</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2482572"></a><h2>MESSAGE-TYPES</h2><p>Available message types are:</p><div class="variablelist"><dl><dt><span class="term">close-share</span></dt><dd><p>Order smbd to close the client
    2020        connections to the named share. Note that this doesn't affect client
    2121        connections to any other shares. This message-type takes an argument of the
    … …  
    6060        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
    6161        to <code class="constant">smbd</code>, <code class="constant">nmbd</code>, or <code class="constant">winbindd</code>.
    62         </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478457"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    63         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478468"></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" lang="en"><a name="id2478492"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     62        </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478445"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     63        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478456"></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" lang="en"><a name="id2478481"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    6464        were created by Andrew Tridgell. Samba is now developed
    6565        by the Samba Team as an Open Source project similar

  • branches/samba-3.2.x/docs/htmldocs/manpages/smbcquotas.1.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2479248"></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" lang="en"><a name="id2479276"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2482449"></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" lang="en"><a name="id2482477"></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
    … …  
    6363via the <code class="literal">ps</code> command.  To be safe always allow
    6464<code class="literal">rpcclient</code> to prompt for a password and type
    65 it in directly. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478472"></a><h2>QUOTA_SET_COMAND</h2><p>The format of an the QUOTA_SET_COMMAND is an operation
     65it in directly. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478461"></a><h2>QUOTA_SET_COMAND</h2><p>The format of an the QUOTA_SET_COMMAND is an operation
    6666        name followed by a set of parameters specific to that operation.
    6767        </p><p>To set user quotas for the user specified by -u or for the
    … …  
    7575        </p><p><strong class="userinput"><code>
    7676        FSQFLAGS:QUOTA_ENABLED/DENY_DISK/LOG_SOFTLIMIT/LOG_HARD_LIMIT
    77         </code></strong></p><p>All limits are specified as a number of bytes.</p></div><div class="refsect1" lang="en"><a name="id2478524"></a><h2>EXIT STATUS</h2><p>The <code class="literal">smbcquotas</code> program sets the exit status
     77        </code></strong></p><p>All limits are specified as a number of bytes.</p></div><div class="refsect1" lang="en"><a name="id2478513"></a><h2>EXIT STATUS</h2><p>The <code class="literal">smbcquotas</code> program sets the exit status
    7878        depending on the success or otherwise of the operations performed.
    7979        The exit status may be one of the following values. </p><p>If the operation succeeded, smbcquotas returns an exit
    … …  
    8181        or when there was an error getting or setting the quota(s), an exit status
    8282        of 1 is returned.  If there was an error parsing any command line
    83         arguments, an exit status of 2 is returned. </p></div><div class="refsect1" lang="en"><a name="id2478557"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478568"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     83        arguments, an exit status of 2 is returned. </p></div><div class="refsect1" lang="en"><a name="id2478546"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478557"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    8484        were created by Andrew Tridgell. Samba is now developed
    8585        by the Samba Team as an Open Source project similar

  • branches/samba-3.2.x/docs/htmldocs/manpages/smbd.8.html

    r202 r204  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbd</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="smbd.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbd &#8212; server to provide SMB/CIFS services to clients</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbd</code> [-D] [-F] [-S] [-i] [-h] [-V] [-b] [-d &lt;debug level&gt;] [-l &lt;log directory&gt;] [-p &lt;port number(s)&gt;] [-P &lt;profiling level&gt;] [-O &lt;socket option&gt;] [-s &lt;configuration file&gt;]</p></div></div><div class="refsect1" lang="en"><a name="id2479219"></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">smbd</code> is the server daemon that
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbd</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="smbd.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbd &#8212; server to provide SMB/CIFS services to clients</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbd</code> [-D] [-F] [-S] [-i] [-h] [-V] [-b] [-d &lt;debug level&gt;] [-l &lt;log directory&gt;] [-p &lt;port number(s)&gt;] [-P &lt;profiling level&gt;] [-O &lt;socket option&gt;] [-s &lt;configuration file&gt;]</p></div></div><div class="refsect1" lang="en"><a name="id2479220"></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">smbd</code> is the server daemon that
    22        provides filesharing and printing services to Windows clients.
    33        The server provides filespace and printer services to
    … …  
    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" lang="en"><a name="id2479306"></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" lang="en"><a name="id2479307"></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" lang="en"><a name="id2478467"></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" lang="en"><a name="id2478468"></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" lang="en"><a name="id2478594"></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" lang="en"><a name="id2478595"></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" lang="en"><a name="id2478615"></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" lang="en"><a name="id2478616"></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" lang="en"><a name="id2478645"></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" lang="en"><a name="id2478646"></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" lang="en"><a name="id2478706"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    123         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478717"></a><h2>DIAGNOSTICS</h2><p>Most diagnostics issued by the server are logged
     122        </p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2478707"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     123        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478718"></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" lang="en"><a name="id2478745"></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" lang="en"><a name="id2478746"></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" lang="en"><a name="id2525654"></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" lang="en"><a name="id2525649"></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" lang="en"><a name="id2525748"></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" lang="en"><a name="id2525743"></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" lang="en"><a name="id2525834"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     154        http://samba.org/cifs/</a>.</p></div><div class="refsect1" lang="en"><a name="id2525829"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/smbget.1.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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] [-?, --help] [--usage] {smb://host/share/path/to/file} [smb://url2/] [...]</p></div></div><div class="refsect1" lang="en"><a name="id2479271"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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] [-?, --help] [--usage] {smb://host/share/path/to/file} [smb://url2/] [...]</p></div></div><div class="refsect1" lang="en"><a name="id2479272"></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
    … …  
    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" lang="en"><a name="id2478292"></a><h2>EXAMPLES</h2><pre class="programlisting">
     11</pre></div><div class="refsect1" lang="en"><a name="id2478293"></a><h2>EXAMPLES</h2><pre class="programlisting">
    1212# Recursively download 'src' directory
    1313smbget -R smb://rhonwyn/jelmer/src
    … …  
    2020</pre></div><div class="refsect1" lang="en"><a name="id2478310"></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" lang="en"><a name="id2478323"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    23         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478334"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     22turned on).</p></div><div class="refsect1" lang="en"><a name="id2478324"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     23        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478335"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/smbgetrc.5.html

    r202 r204  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbgetrc</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="smbgetrc.5"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbgetrc &#8212; configuration file for smbget</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">smbgetrc</code></p></div><div class="refsect1" lang="en"><a name="id2516082"></a><h2>DESCRIPTION</h2><p>
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbgetrc</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="smbgetrc.5"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbgetrc &#8212; configuration file for smbget</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">smbgetrc</code></p></div><div class="refsect1" lang="en"><a name="id2516076"></a><h2>DESCRIPTION</h2><p>
    22                This manual page documents the format and options of the <span class="emphasis"><em>smbgetrc</em></span>
    33                file. This is the configuration file used by the <a class="citerefentry" href="smbget.1.html"><span class="citerefentry"><span class="refentrytitle">smbget</span>(1)</span></a>
    … …  
    55                        and value should be separated by a space.
    66        </p><p>By default, smbget reads its configuration from <span class="emphasis"><em>$HOME/.smbgetrc</em></span>, though
    7                 other locations can be specified using the command-line options.</p></div><div class="refsect1" lang="en"><a name="id2516114"></a><h2>OPTIONS</h2><p>
     7                other locations can be specified using the command-line options.</p></div><div class="refsect1" lang="en"><a name="id2516109"></a><h2>OPTIONS</h2><p>
    88        The following keys can be set:
    99</p><div class="variablelist"><dl><dt><span class="term">resume on|off</span></dt><dd><p>
    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" lang="en"><a name="id2479270"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    13         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2479282"></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>.
    14         </p></div><div class="refsect1" lang="en"><a name="id2479306"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     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" lang="en"><a name="id2479268"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     13        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2479279"></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>.
     14        </p></div><div class="refsect1" lang="en"><a name="id2479304"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/smbpasswd.5.html

    r202 r204  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbpasswd</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="smbpasswd.5"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbpasswd &#8212; The Samba encrypted password file</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">smbpasswd</code></p></div><div class="refsect1" lang="en"><a name="id2516082"></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>smbpasswd is the Samba encrypted password file. It contains
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbpasswd</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="smbpasswd.5"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbpasswd &#8212; The Samba encrypted password file</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">smbpasswd</code></p></div><div class="refsect1" lang="en"><a name="id2516076"></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>smbpasswd is the Samba encrypted password file. It contains
    22        the username, Unix user id and the SMB hashed passwords of the
    33        user, as well as account flag information and the time the
    44        password was last changed. This file format has been evolving with
    5         Samba and has had several different formats in the past. </p></div><div class="refsect1" lang="en"><a name="id2516109"></a><h2>FILE FORMAT</h2><p>The format of the smbpasswd file used by Samba 2.2
     5        Samba and has had several different formats in the past. </p></div><div class="refsect1" lang="en"><a name="id2516103"></a><h2>FILE FORMAT</h2><p>The format of the smbpasswd file used by Samba 2.2
    66        is very similar to the familiar Unix <code class="filename">passwd(5)</code>
    77        file. It is an ASCII file containing one line for each user. Each field
    … …  
    8080        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2479411"></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" lang="en"><a name="id2479437"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     82        </p></div><div class="refsect1" lang="en"><a name="id2479436"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/smbpasswd.8.html

    r202 r204  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbpasswd</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="smbpasswd.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbpasswd &#8212; change a user's SMB password</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbpasswd</code> [-a] [-c &lt;config file&gt;] [-x] [-d] [-e] [-D debuglevel] [-n] [-r &lt;remote machine&gt;] [-R &lt;name resolve order&gt;] [-m] [-U username[%password]] [-h] [-s] [-w pass] [-W] [-i] [-L] [username]</p></div></div><div class="refsect1" lang="en"><a name="id2479253"></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 smbpasswd program has several different
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbpasswd</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="smbpasswd.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbpasswd &#8212; change a user's SMB password</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbpasswd</code> [-a] [-c &lt;config file&gt;] [-x] [-d] [-e] [-D debuglevel] [-n] [-r &lt;remote machine&gt;] [-R &lt;name resolve order&gt;] [-m] [-U username[%password]] [-h] [-s] [-w pass] [-W] [-i] [-L] [username]</p></div></div><div class="refsect1" lang="en"><a name="id2479255"></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 smbpasswd program has several different
    22        functions, depending on whether it is run by the <span class="emphasis"><em>root</em></span> user
    33        or not. When run as a normal user it allows the user to change
    … …  
    2626        smbpasswd</code> accesses the local smbpasswd file
    2727        directly, thus enabling changes to be made even if smbd is not
    28         running. </p></div><div class="refsect1" lang="en"><a name="id2479374"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-a</span></dt><dd><p>
     28        running. </p></div><div class="refsect1" lang="en"><a name="id2479375"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-a</span></dt><dd><p>
    2929                This option specifies that the username following should be added to the local smbpasswd file, with the new
    3030                password typed (type &lt;Enter&gt; for the old password). This option is ignored if the username following
    … …  
    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" lang="en"><a name="id2525541"></a><h2>NOTES</h2><p>Since <code class="literal">smbpasswd</code> works in client-server
     154                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2525536"></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" lang="en"><a name="id2525593"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2525604"></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" lang="en"><a name="id2525629"></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" lang="en"><a name="id2525589"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2525600"></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" lang="en"><a name="id2525624"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/smbspool.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbspool</code> {job} {user} {title} {copies} {options} [filename]</p></div></div><div class="refsect1" lang="en"><a name="id2479161"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbspool</code> {job} {user} {title} {copies} {options} [filename]</p></div></div><div class="refsect1" lang="en"><a name="id2479162"></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" lang="en"><a name="id2479252"></a><h2>OPTIONS</h2><div class="itemizedlist"><ul type="disc"><li><p>The job argument (argv[1]) contains the
     13        running smbspool.</p></div><div class="refsect1" lang="en"><a name="id2479253"></a><h2>OPTIONS</h2><div class="itemizedlist"><ul type="disc"><li><p>The job argument (argv[1]) contains the
    1414                job ID number and is presently not used by smbspool.
    1515                </p></li><li><p>The user argument (argv[2]) contains the
    … …  
    2424                not used by smbspool.</p></li><li><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" lang="en"><a name="id2479303"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2479314"></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" lang="en"><a name="id2479338"></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" lang="en"><a name="id2479304"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2479315"></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" lang="en"><a name="id2479339"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/smbstatus.1.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2479191"></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" lang="en"><a name="id2479219"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2479193"></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" lang="en"><a name="id2479220"></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" lang="en"><a name="id2478304"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    32         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478315"></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" lang="en"><a name="id2478339"></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" lang="en"><a name="id2478305"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     32        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478316"></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" lang="en"><a name="id2478340"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/smbtar.1.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2479230"></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
     2        directly to UNIX tape drives</p></div><div class="refsynopsisdiv"><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" lang="en"><a name="id2479231"></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
    33        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" lang="en"><a name="id2479265"></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.
    … …  
    1818                after each file is read. </p></dd><dt><span class="term">-r</span></dt><dd><p>Restore. Files are restored to the share
    1919                from the tar file. </p></dd><dt><span class="term">-l log level</span></dt><dd><p>Log (debug) level. Corresponds to the
    20                 <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" lang="en"><a name="id2479483"></a><h2>ENVIRONMENT VARIABLES</h2><p>The <em class="parameter"><code>$TAPE</code></em> variable specifies the
     20                <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" lang="en"><a name="id2479484"></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" lang="en"><a name="id2478241"></a><h2>BUGS</h2><p>The <code class="literal">smbtar</code> script has different
    23         options from ordinary tar and from smbclient's tar command. </p></div><div class="refsect1" lang="en"><a name="id2478259"></a><h2>CAVEATS</h2><p>Sites that are more careful about security may not like
     22        with the -t option. </p></div><div class="refsect1" lang="en"><a name="id2478243"></a><h2>BUGS</h2><p>The <code class="literal">smbtar</code> script has different
     23        options from ordinary tar and from smbclient's tar command. </p></div><div class="refsect1" lang="en"><a name="id2478261"></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
    2525        on entire shares; should work on file lists. smbtar works best
    26         with GNU tar and may not work well with other versions. </p></div><div class="refsect1" lang="en"><a name="id2478273"></a><h2>DIAGNOSTICS</h2><p>See the <span class="emphasis"><em>DIAGNOSTICS</em></span> section for the <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a> command.</p></div><div class="refsect1" lang="en"><a name="id2478295"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    27         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478306"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</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="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>.</p></div><div class="refsect1" lang="en"><a name="id2478340"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     26        with GNU tar and may not work well with other versions. </p></div><div class="refsect1" lang="en"><a name="id2478275"></a><h2>DIAGNOSTICS</h2><p>See the <span class="emphasis"><em>DIAGNOSTICS</em></span> section for the <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a> command.</p></div><div class="refsect1" lang="en"><a name="id2478298"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     27        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478309"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</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="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>.</p></div><div class="refsect1" lang="en"><a name="id2478342"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    2828        were created by Andrew Tridgell. Samba is now developed
    2929        by the Samba Team as an Open Source project similar

  • branches/samba-3.2.x/docs/htmldocs/manpages/smbtree.1.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbtree</code> [-b] [-D] [-S]</p></div></div><div class="refsect1" lang="en"><a name="id2516105"></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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbtree</code> [-b] [-D] [-S]</p></div></div><div class="refsect1" lang="en"><a name="id2516102"></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" lang="en"><a name="id2479167"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-b</span></dt><dd><p>Query network nodes by sending requests
     7        </p></div><div class="refsect1" lang="en"><a name="id2479168"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-b</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</span></dt><dd><p>Only print a list of all
    … …  
    6868<code class="literal">rpcclient</code> to prompt for a password and type
    6969it in directly. </p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    70 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478305"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
    71         suite.</p></div><div class="refsect1" lang="en"><a name="id2478316"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     70</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478306"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
     71        suite.</p></div><div class="refsect1" lang="en"><a name="id2478317"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    7272        were created by Andrew Tridgell. Samba is now developed
    7373        by the Samba Team as an Open Source project similar

  • branches/samba-3.2.x/docs/htmldocs/manpages/swat.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2516106"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2516103"></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
    44        to all the configurable options in the <code class="filename">smb.conf</code> file allowing an
    5         administrator to easily look up the effects of any change. </p><p><code class="literal">swat</code> is run from <code class="literal">inetd</code> </p></div><div class="refsect1" lang="en"><a name="id2479201"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-s smb configuration file</span></dt><dd><p>The default configuration file path is
     5        administrator to easily look up the effects of any change. </p><p><code class="literal">swat</code> is run from <code class="literal">inetd</code> </p></div><div class="refsect1" lang="en"><a name="id2479202"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-s smb configuration file</span></dt><dd><p>The default configuration file path is
    66                determined at compile time.  The file specified contains
    77                the configuration details required by the <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> server. This is the file
    … …  
    4242log.smbd, etc...). The log file is never removed by the client.
    4343</p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    44 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478262"></a><h2>INSTALLATION</h2><p>Swat is included as binary package with most distributions. The
     44</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478264"></a><h2>INSTALLATION</h2><p>Swat is included as binary package with most distributions. The
    4545        package manager in this case takes care of the installation and
    4646        configuration. This section is only for those who have compiled
    … …  
    4949        </code> to install the <code class="literal">swat</code> binary
    5050        and the various help files and images. A default install would put
    51         these in: </p><div class="itemizedlist"><ul type="disc"><li><p>/usr/local/samba/sbin/swat</p></li><li><p>/usr/local/samba/swat/images/*</p></li><li><p>/usr/local/samba/swat/help/*</p></li></ul></div><div class="refsect2" lang="en"><a name="id2478310"></a><h3>Inetd Installation</h3><p>You need to edit your <code class="filename">/etc/inetd.conf
     51        these in: </p><div class="itemizedlist"><ul type="disc"><li><p>/usr/local/samba/sbin/swat</p></li><li><p>/usr/local/samba/swat/images/*</p></li><li><p>/usr/local/samba/swat/help/*</p></li></ul></div><div class="refsect2" lang="en"><a name="id2478312"></a><h3>Inetd Installation</h3><p>You need to edit your <code class="filename">/etc/inetd.conf
    5252                </code> and <code class="filename">/etc/services</code>
    5353                to enable SWAT to be launched via <code class="literal">inetd</code>.</p><p>In <code class="filename">/etc/services</code> you need to
    … …  
    6363                and <code class="filename">/etc/inetd.conf</code> you need to send a
    6464                HUP signal to inetd. To do this use <code class="literal">kill -1 PID
    65                 </code> where PID is the process ID of the inetd daemon. </p></div></div><div class="refsect1" lang="en"><a name="id2478423"></a><h2>LAUNCHING</h2><p>To launch SWAT just run your favorite web browser and
     65                </code> where PID is the process ID of the inetd daemon. </p></div></div><div class="refsect1" lang="en"><a name="id2478424"></a><h2>LAUNCHING</h2><p>To launch SWAT just run your favorite web browser and
    6666        point it at "http://localhost:901/".</p><p>Note that you can attach to SWAT from any IP connected
    6767        machine but connecting from a remote machine leaves your
    6868        connection open to password sniffing as passwords will be sent
    69         in the clear over the wire. </p></div><div class="refsect1" lang="en"><a name="id2478442"></a><h2>FILES</h2><div class="variablelist"><dl><dt><span class="term"><code class="filename">/etc/inetd.conf</code></span></dt><dd><p>This file must contain suitable startup
     69        in the clear over the wire. </p></div><div class="refsect1" lang="en"><a name="id2478443"></a><h2>FILES</h2><div class="variablelist"><dl><dt><span class="term"><code class="filename">/etc/inetd.conf</code></span></dt><dd><p>This file must contain suitable startup
    7070                information for the meta-daemon.</p></dd><dt><span class="term"><code class="filename">/etc/services</code></span></dt><dd><p>This file must contain a mapping of service name
    7171                (e.g., swat) to service port (e.g., 901) and protocol type
    … …  
    7474                /usr/samba/lib/smb.conf</code> and <code class="filename">/etc/smb.conf
    7575                </code>.  This file describes all the services the server
    76                 is to make available to clients. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478524"></a><h2>WARNINGS</h2><p><code class="literal">swat</code> will rewrite your <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file. It will rearrange the entries and delete all
     76                is to make available to clients. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478525"></a><h2>WARNINGS</h2><p><code class="literal">swat</code> will rewrite your <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file. It will rearrange the entries and delete all
    7777        comments, <em class="parameter"><code>include=</code></em> and <em class="parameter"><code>copy=
    7878        </code></em> options. If you have a carefully crafted <code class="filename">
    79         smb.conf</code> then back it up or don't use swat! </p></div><div class="refsect1" lang="en"><a name="id2478568"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478579"></a><h2>SEE ALSO</h2><p><code class="literal">inetd(5)</code>, <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></p></div><div class="refsect1" lang="en"><a name="id2478609"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     79        smb.conf</code> then back it up or don't use swat! </p></div><div class="refsect1" lang="en"><a name="id2478569"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478580"></a><h2>SEE ALSO</h2><p><code class="literal">inetd(5)</code>, <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></p></div><div class="refsect1" lang="en"><a name="id2478610"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/tdbbackup.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">tdbbackup</code> [-s suffix] [-v] [-h]</p></div></div><div class="refsect1" lang="en"><a name="id2516108"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">tdbbackup</code> [-s suffix] [-v] [-h]</p></div></div><div class="refsect1" lang="en"><a name="id2516104"></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" lang="en"><a name="id2479170"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h</span></dt><dd><p>
     5        </p></div><div class="refsect1" lang="en"><a name="id2479171"></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" lang="en"><a name="id2479230"></a><h2>COMMANDS</h2><p><span class="emphasis"><em>GENERAL INFORMATION</em></span></p><p>
     14                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479232"></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" lang="en"><a name="id2479310"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2479321"></a><h2>AUTHOR</h2><p>
     32                </p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2479312"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2479322"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/tdbdump.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">tdbdump</code> {filename}</p></div></div><div class="refsect1" lang="en"><a name="id2516092"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">tdbdump</code> {filename}</p></div></div><div class="refsect1" lang="en"><a name="id2516089"></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" lang="en"><a name="id2516126"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2479168"></a><h2>AUTHOR</h2><p>
     6        </p></div><div class="refsect1" lang="en"><a name="id2516123"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2479170"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/tdbtool.8.html

    r202 r204  
    33                  [
    44                <em class="replaceable"><code>COMMANDS</code></em>
    5                 ...]</p></div></div><div class="refsect1" lang="en"><a name="id2516117"></a><h2>DESCRIPTION</h2><p>This tool is part of the
     5                ...]</p></div></div><div class="refsect1" lang="en"><a name="id2516113"></a><h2>DESCRIPTION</h2><p>This tool is part of the
    66        <a class="citerefentry" href="samba.1.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(1)</span></a> suite.</p><p><code class="literal">tdbtool</code> a tool for displaying and
    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" lang="en"><a name="id2479177"></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" lang="en"><a name="id2479179"></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>.
    … …  
    5757                <code class="option">quit</code>
    5858                </span></dt><dd><p>Exit <code class="literal">tdbtool</code>.
    59                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478236"></a><h2>CAVEATS</h2><p>The contents of the Samba TDB files are private
     59                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478239"></a><h2>CAVEATS</h2><p>The contents of the Samba TDB files are private
    6060        to the implementation and should not be altered with
    6161        <code class="literal">tdbtool</code>.
    62         </p></div><div class="refsect1" lang="en"><a name="id2478254"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478265"></a><h2>AUTHOR</h2><p> The original Samba software and related utilities were
     62        </p></div><div class="refsect1" lang="en"><a name="id2478257"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478268"></a><h2>AUTHOR</h2><p> The original Samba software and related utilities were
    6363        created by Andrew Tridgell.  Samba is now developed by the
    6464        Samba Team as an Open Source project similar to the way the

  • branches/samba-3.2.x/docs/htmldocs/manpages/testparm.1.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2479170"></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"><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" lang="en"><a name="id2479171"></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" lang="en"><a name="id2479253"></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" lang="en"><a name="id2479255"></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.
    … …  
    4444                if the hostname parameter is supplied. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479464"></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
    4545                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" lang="en"><a name="id2478239"></a><h2>DIAGNOSTICS</h2><p>The program will issue a message saying whether the
     46                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478241"></a><h2>DIAGNOSTICS</h2><p>The program will issue a message saying whether the
    4747        configuration file loaded OK or not. This message may be preceded by
    4848        errors and warnings if the file did not load. If the file was
    4949        loaded OK, the program then dumps all known service details
    50         to stdout. </p></div><div class="refsect1" lang="en"><a name="id2478254"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    51         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478265"></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" lang="en"><a name="id2478291"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     50        to stdout. </p></div><div class="refsect1" lang="en"><a name="id2478256"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     51        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2478267"></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" lang="en"><a name="id2478292"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    5252        were created by Andrew Tridgell. Samba is now developed
    5353        by the Samba Team as an Open Source project similar

  • branches/samba-3.2.x/docs/htmldocs/manpages/umount.cifs.8.html

    r202 r204  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>umount.cifs</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="umount.cifs.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>umount.cifs &#8212; for normal, non-root users, to unmount their own Common Internet File System (CIFS) mounts</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">umount.cifs</code> {mount-point} [-nVvhfle]</p></div></div><div class="refsect1" lang="en"><a name="id2516106"></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>umount.cifs unmounts a Linux CIFS filesystem. It can be invoked
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>umount.cifs</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="umount.cifs.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>umount.cifs &#8212; for normal, non-root users, to unmount their own Common Internet File System (CIFS) mounts</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">umount.cifs</code> {mount-point} [-nVvhfle]</p></div></div><div class="refsect1" lang="en"><a name="id2518328"></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>umount.cifs unmounts a Linux CIFS filesystem. It can be invoked
    22indirectly by the
    33<a class="citerefentry" href="umount.8.html"><span class="citerefentry"><span class="refentrytitle">umount</span>(8)</span></a> command
    … …  
    1212setuid root (or equivalently update the /etc/permissions file) to allow non-root users to umount shares to directories for which they have write permission.  The umount.cifs utility is typically
    1313not needed if unmounts need only be performed by root users, or if user mounts and unmounts
    14 can rely on specifying explicit entries in /etc/fstab See</p><p><a class="citerefentry" href="fstab.5.html"><span class="citerefentry"><span class="refentrytitle">fstab</span>(5)</span></a></p></div><div class="refsect1" lang="en"><a name="id2479208"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">--verbose</span></dt><dd><p>print additional debugging information</p></dd><dt><span class="term">--no-mtab</span></dt><dd><p>Do not update the mtab even if unmount completes successfully (/proc/mounts will still display the correct information)</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479242"></a><h2>NOTES</h2><p>This command is normally intended to be installed setuid (since root users can already run unmount).  An alternative to using umount.cifs is to add specfic entries for the user mounts that you wish a particular user or users to mount and unmount to /etc/fstab</p></div><div class="refsect1" lang="en"><a name="id2479256"></a><h2>CONFIGURATION</h2><p>
     14can rely on specifying explicit entries in /etc/fstab See</p><p><a class="citerefentry" href="fstab.5.html"><span class="citerefentry"><span class="refentrytitle">fstab</span>(5)</span></a></p></div><div class="refsect1" lang="en"><a name="id2480168"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">--verbose</span></dt><dd><p>print additional debugging information</p></dd><dt><span class="term">--no-mtab</span></dt><dd><p>Do not update the mtab even if unmount completes successfully (/proc/mounts will still display the correct information)</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2482442"></a><h2>NOTES</h2><p>This command is normally intended to be installed setuid (since root users can already run unmount).  An alternative to using umount.cifs is to add specfic entries for the user mounts that you wish a particular user or users to mount and unmount to /etc/fstab</p></div><div class="refsect1" lang="en"><a name="id2482456"></a><h2>CONFIGURATION</h2><p>
    1515The primary mechanism for making configuration changes and for reading
    1616debug information for the cifs vfs is via the Linux /proc filesystem.
    … …  
    1818configuration files and pseudo files which can display debug information. 
    1919For more information see the kernel file <code class="filename">fs/cifs/README</code>.
    20 </p></div><div class="refsect1" lang="en"><a name="id2479283"></a><h2>BUGS</h2><p>At this time umount.cifs does not lock the mount table using the same lock as the umount utility does, so do not attempt to do multiple unmounts from different processes (and in particular unmounts of a cifs mount and another type of filesystem mount at the same time).
     20</p></div><div class="refsect1" lang="en"><a name="id2482482"></a><h2>BUGS</h2><p>At this time umount.cifs does not lock the mount table using the same lock as the umount utility does, so do not attempt to do multiple unmounts from different processes (and in particular unmounts of a cifs mount and another type of filesystem mount at the same time).
    2121        </p><p>If the same mount point is mounted multiple times by cifs, umount.cifs will remove all of the matching entries from the mount table (although umount.cifs will actually only unmount the last one), rather than only removing the last matching entry in /etc/mtab.  The pseudofile /proc/mounts will display correct information though, and the lack of an entry in /etc/mtab does not prevent subsequent unmounts.</p><p>
    2222Note that the typical response to a bug report is a suggestion
    … …  
    2525when reporting bugs (minimum: umount.cifs (try umount.cifs -V), kernel (see /proc/version) and
    2626server type you are trying to contact.
    27 </p></div><div class="refsect1" lang="en"><a name="id2479316"></a><h2>VERSION</h2><p>This man page is correct for version 1.34 of
    28         the cifs vfs filesystem (roughly Linux kernel 2.6.12).</p></div><div class="refsect1" lang="en"><a name="id2479328"></a><h2>SEE ALSO</h2><p>
     27</p></div><div class="refsect1" lang="en"><a name="id2482516"></a><h2>VERSION</h2><p>This man page is correct for version 1.34 of
     28        the cifs vfs filesystem (roughly Linux kernel 2.6.12).</p></div><div class="refsect1" lang="en"><a name="id2482528"></a><h2>SEE ALSO</h2><p>
    2929        Documentation/filesystems/cifs.txt and fs/cifs/README in the linux kernel
    3030        source tree may contain additional options and information.
    31 </p><p><a class="citerefentry" href="mount.cifs.8.html"><span class="citerefentry"><span class="refentrytitle">mount.cifs</span>(8)</span></a></p></div><div class="refsect1" lang="en"><a name="id2479349"></a><h2>AUTHOR</h2><p>Steve French</p><p>The syntax was loosely based on the umount utility and the manpage was loosely based on that of mount.cifs.8. The man page was created by Steve French</p><p>The maintainer of the Linux cifs vfs and the userspace
     31</p><p><a class="citerefentry" href="mount.cifs.8.html"><span class="citerefentry"><span class="refentrytitle">mount.cifs</span>(8)</span></a></p></div><div class="refsect1" lang="en"><a name="id2482549"></a><h2>AUTHOR</h2><p>Steve French</p><p>The syntax was loosely based on the umount utility and the manpage was loosely based on that of mount.cifs.8. The man page was created by Steve French</p><p>The maintainer of the Linux cifs vfs and the userspace
    3232                tool <span class="emphasis"><em>umount.cifs</em></span> is <a class="ulink" href="mailto:sfrench@samba.org" target="_top">Steve French</a>.
    3333                The <a class="ulink" href="mailto:linux-cifs-client@lists.samba.org" target="_top">Linux CIFS Mailing list</a>

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfs_audit.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = audit</code></p></div></div><div class="refsect1" lang="en"><a name="id2516087"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = audit</code></p></div></div><div class="refsect1" lang="en"><a name="id2516081"></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 class="simplelist" border="0" summary="Simple list"><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" lang="en"><a name="id2479210"></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 class="simplelist" border="0" summary="Simple list"><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" lang="en"><a name="id2479212"></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
    77                </p></dd><dt><span class="term">audit:priority = PRIORITY</span></dt><dd><p>Log messages with the named
    88                <a class="citerefentry" href="syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a> priority.
    9                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479263"></a><h2>EXAMPLES</h2><p>Log operations on all shares using the LOCAL1 facility
     9                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479264"></a><h2>EXAMPLES</h2><p>Log operations on all shares using the LOCAL1 facility
    1010        and NOTICE priority:</p><pre class="programlisting">
    1111        <em class="parameter"><code>[global]</code></em>

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfs_cacheprime.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = cacheprime</code></p></div></div><div class="refsect1" lang="en"><a name="id2516089"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = cacheprime</code></p></div></div><div class="refsect1" lang="en"><a name="id2518311"></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" lang="en"><a name="id2479175"></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
    11                 the kernel data cache.</p><p>The following suffixes may be applied to BYTES:</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">K</code> - BYTES is a number of kilobytes</p></li><li><p><code class="literal">M</code> - BYTES is a number of megabytes</p></li><li><p><code class="literal">G</code> - BYTES is a number of gigabytes</p></li></ul></div></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479234"></a><h2>EXAMPLES</h2><p>For a hypothetical disk array, it is necessary to ensure
     10        has the file open. </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2480140"></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
     11                the kernel data cache.</p><p>The following suffixes may be applied to BYTES:</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">K</code> - BYTES is a number of kilobytes</p></li><li><p><code class="literal">M</code> - BYTES is a number of megabytes</p></li><li><p><code class="literal">G</code> - BYTES is a number of gigabytes</p></li></ul></div></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2482436"></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),
    1313        and aligned on 1 megabyte boundaries:
    … …  
    1616        <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = cacheprime</a>
    1717        <a class="link" href="smb.conf.5.html#CACHEPRIME:RSIZE">cacheprime:rsize = 1M</a>
    18 </pre></div><div class="refsect1" lang="en"><a name="id2479387"></a><h2>CAVEATS</h2><p><code class="literal">cacheprime</code> is not a a substitute for
     18</pre></div><div class="refsect1" lang="en"><a name="id2482590"></a><h2>CAVEATS</h2><p><code class="literal">cacheprime</code> is not a a substitute for
    1919        a general-purpose readahead mechanism. It is intended for use
    2020        only in very specific environments where disk operations must
    2121        be aligned and sized to known values (as much as that is possible).
    22         </p></div><div class="refsect1" lang="en"><a name="id2479405"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    23         </p></div><div class="refsect1" lang="en"><a name="id2479416"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     22        </p></div><div class="refsect1" lang="en"><a name="id2482608"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
     23        </p></div><div class="refsect1" lang="en"><a name="id2482619"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfs_cap.8.html

    r202 r204  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_cap</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="vfs_cap.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_cap &#8212; CAP encode filenames</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = cap</code></p></div></div><div class="refsect1" lang="en"><a name="id2516086"></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_cap</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="vfs_cap.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_cap &#8212; CAP encode filenames</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = cap</code></p></div></div><div class="refsect1" lang="en"><a name="id2516081"></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>CAP (Columbia Appletalk Protocol) encoding is a
    33        technique for representing non-ASCII filenames in ASCII. The
    … …  
    55        from CAP format, allowing users to name files in their native
    66        encoding.  </p><p>CAP encoding is most commonly
    7         used in Japanese language environments. </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2516124"></a><h2>EXAMPLES</h2><p>On a system using GNU libiconv, use CAP encoding to support
     7        used in Japanese language environments. </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2516120"></a><h2>EXAMPLES</h2><p>On a system using GNU libiconv, use CAP encoding to support
    88        users in the Shift_JIS locale:</p><pre class="programlisting">
    99        <em class="parameter"><code>[global]</code></em>
    … …  
    1212        <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = cap</a>
    1313</pre></div><div class="refsect1" lang="en"><a name="id2479315"></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" lang="en"><a name="id2479325"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     14        </p></div><div class="refsect1" lang="en"><a name="id2479326"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfs_catia.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = catia</code></p></div></div><div class="refsect1" lang="en"><a name="id2516086"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = catia</code></p></div></div><div class="refsect1" lang="en"><a name="id2516081"></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" lang="en"><a name="id2516119"></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" lang="en"><a name="id2516115"></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">path = /data/cad</a>

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfs_commit.8.html

    r202 r204  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_commit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="vfs_commit.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_commit &#8212; flush dirty data at specified intervals</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = commit</code></p></div></div><div class="refsect1" lang="en"><a name="id2516090"></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_commit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="vfs_commit.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_commit &#8212; flush dirty data at specified intervals</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = commit</code></p></div></div><div class="refsect1" lang="en"><a name="id2518311"></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_commit</code> VFS module keeps track of
    33        the amount of data written to a file and synchronizes it to
    … …  
    88        commit:dthresh value. Secondly, write performance can be
    99        improved on some systems by flushing file data early and at
    10         regular intervals.</p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2479173"></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
     10        regular intervals.</p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2480134"></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 type="disc"><li><p><code class="literal">K</code> - BYTES is a number of kilobytes</p></li><li><p><code class="literal">M</code> - BYTES is a number of megabytes</p></li><li><p><code class="literal">G</code> - BYTES is a number of gigabytes</p></li></ul></div></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479231"></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 type="disc"><li><p><code class="literal">K</code> - BYTES is a number of kilobytes</p></li><li><p><code class="literal">M</code> - BYTES is a number of megabytes</p></li><li><p><code class="literal">G</code> - BYTES is a number of gigabytes</p></li></ul></div></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2482434"></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">vfs objects = commit</a>
    1717        <a class="link" href="smb.conf.5.html#COMMIT:DTHRESH">commit:dthresh = 512K</a>
    18 </pre></div><div class="refsect1" lang="en"><a name="id2479395"></a><h2>CAVEATS</h2><p>On some systems, the data synchronization performed by
     18</pre></div><div class="refsect1" lang="en"><a name="id2482598"></a><h2>CAVEATS</h2><p>On some systems, the data synchronization performed by
    1919        <code class="literal">commit</code> may reduce performance.
    20         </p></div><div class="refsect1" lang="en"><a name="id2479411"></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" lang="en"><a name="id2479422"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     20        </p></div><div class="refsect1" lang="en"><a name="id2482615"></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" lang="en"><a name="id2482626"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfs_default_quota.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = default_quota</code></p></div></div><div class="refsect1" lang="en"><a name="id2516090"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = default_quota</code></p></div></div><div class="refsect1" lang="en"><a name="id2518313"></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" lang="en"><a name="id2479174"></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" lang="en"><a name="id2480143"></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" lang="en"><a name="id2479248"></a><h2>EXAMPLES</h2><p>Store the default quota record in the quota record for
     24                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2482451"></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">default_quota:uid = 65535</a>
    3030        <a class="link" href="smb.conf.5.html#DEFAULT_QUOTA:UIDNOLIMIT">default_quota:uid nolimit = yes</a>
    31 </pre></div><div class="refsect1" lang="en"><a name="id2479412"></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" lang="en"><a name="id2479423"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     31</pre></div><div class="refsect1" lang="en"><a name="id2482616"></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" lang="en"><a name="id2482626"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfs_extd_audit.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = extd_audit</code></p></div></div><div class="refsect1" lang="en"><a name="id2516089"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = extd_audit</code></p></div></div><div class="refsect1" lang="en"><a name="id2518311"></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
    … …  
    88        <code class="literal">vfs_extd_audit</code> is identical to
    99        <a class="citerefentry" href="vfs_audit.8.html"><span class="citerefentry"><span class="refentrytitle">vfs_audit</span>(8)</span></a>.
    10         </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2479199"></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" lang="en"><a name="id2479210"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     10        </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2480163"></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" lang="en"><a name="id2480174"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfs_fake_perms.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = fake_perms</code></p></div></div><div class="refsect1" lang="en"><a name="id2516089"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = fake_perms</code></p></div></div><div class="refsect1" lang="en"><a name="id2518311"></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
    … …  
    77        the client even though the files will never be overwritten as
    88        the client logs out or shuts down.
    9         </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2516126"></a><h2>EXAMPLES</h2><pre class="programlisting">
     9        </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2480128"></a><h2>EXAMPLES</h2><pre class="programlisting">
    1010        <em class="parameter"><code>[Profiles]</code></em>
    1111        <a class="link" href="smb.conf.5.html#PATH">path = /profiles</a>
    1212        <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = fake_perms</a>
    13 </pre></div><div class="refsect1" lang="en"><a name="id2479309"></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" lang="en"><a name="id2479320"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     13</pre></div><div class="refsect1" lang="en"><a name="id2480170"></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" lang="en"><a name="id2480181"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfs_full_audit.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = full_audit</code></p></div></div><div class="refsect1" lang="en"><a name="id2516090"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = full_audit</code></p></div></div><div class="refsect1" lang="en"><a name="id2518311"></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 type="disc"><li><p><code class="literal">PREFIX</code> - the result of the full_audit:prefix string after variable substitutions</p></li><li><p><code class="literal">OPERATION</code> - the name of the VFS operation</p></li><li><p><code class="literal">RESULT</code> - whether the operation succeeded or failed</p></li><li><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" lang="en"><a name="id2478326"></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 type="disc"><li><p><code class="literal">PREFIX</code> - the result of the full_audit:prefix string after variable substitutions</p></li><li><p><code class="literal">OPERATION</code> - the name of the VFS operation</p></li><li><p><code class="literal">RESULT</code> - whether the operation succeeded or failed</p></li><li><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" lang="en"><a name="id2478314"></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
    … …  
    2525                </p></dd><dt><span class="term">full_audit:priority = PRIORITY</span></dt><dd><p>Log messages with the named
    2626                <a class="citerefentry" href="syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a> priority.
    27                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478435"></a><h2>EXAMPLES</h2><p>Log file and directory open operations on the [records]
     27                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478424"></a><h2>EXAMPLES</h2><p>Log file and directory open operations on the [records]
    2828        share using the LOCAL7 facility and ALERT priority, including
    2929        the username and IP address:</p><pre class="programlisting">
    … …  
    3636        <a class="link" href="smb.conf.5.html#FULL_AUDIT:FACILITY">full_audit:facility = LOCAL7</a>
    3737        <a class="link" href="smb.conf.5.html#FULL_AUDIT:PRIORITY">full_audit:priority = ALERT</a>
    38 </pre></div><div class="refsect1" lang="en"><a name="id2478649"></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" lang="en"><a name="id2478660"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     38</pre></div><div class="refsect1" lang="en"><a name="id2478638"></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" lang="en"><a name="id2478649"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    4040        were created by Andrew Tridgell. Samba is now developed
    4141        by the Samba Team as an Open Source project similar

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfs_gpfs.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = gpfs</code></p></div></div><div class="refsect1" lang="en"><a name="id2516087"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = gpfs</code></p></div></div><div class="refsect1" lang="en"><a name="id2516081"></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" lang="en"><a name="id2479184"></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" lang="en"><a name="id2479185"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">nfs4:mode = [ simple | special ]</span></dt><dd><p>
    1212                Enable/Disable substitution of special IDs on GPFS. This parameter
    1313                should not affect the windows users in anyway. It only ensures that Samba
    … …  
    2020                by the underlying filesystem. This parameter should be enabled with
    2121                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 type="disc"><li><p><code class="literal">yes</code> - Enable chown if as supported by the under filesystem</p></li><li><p><code class="literal">no (default)</code> - Disable chown</p></li></ul></div></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479349"></a><h2>EXAMPLES</h2><p>A GPFS mount can be exported via Samba as follows :</p><pre class="programlisting">
     22                that is considered a risk.</p><p>Following is the behaviour of Samba for different values : </p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">yes</code> - Enable chown if as supported by the under filesystem</p></li><li><p><code class="literal">no (default)</code> - Disable chown</p></li></ul></div></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479350"></a><h2>EXAMPLES</h2><p>A GPFS mount can be exported via Samba as follows :</p><pre class="programlisting">
    2323        <em class="parameter"><code>[samba_gpfs_share]</code></em>
    2424        <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = gpfs</a>
    … …  
    2626        <a class="link" href="smb.conf.5.html#NFS4:MODE">nfs4: mode = special</a>
    2727        <a class="link" href="smb.conf.5.html#NFS4:ACEDUP">nfs4: acedup = merge</a>
    28 </pre></div><div class="refsect1" lang="en"><a name="id2478264"></a><h2>CAVEATS</h2><p>The gpfs gpl libraries are required by <code class="literal">gpfs</code> VFS
     28</pre></div><div class="refsect1" lang="en"><a name="id2478265"></a><h2>CAVEATS</h2><p>The gpfs gpl libraries are required by <code class="literal">gpfs</code> VFS
    2929        module during both compilation and runtime.
    3030        Also this VFS module is tested to work on SLES 9/10 and RHEL 4.4
    31         </p></div><div class="refsect1" lang="en"><a name="id2478281"></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" lang="en"><a name="id2478292"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     31        </p></div><div class="refsect1" lang="en"><a name="id2478282"></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" lang="en"><a name="id2478294"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfs_netatalk.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = netatalk</code></p></div></div><div class="refsect1" lang="en"><a name="id2516089"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = netatalk</code></p></div></div><div class="refsect1" lang="en"><a name="id2518311"></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
    44        CIFS clients. .AppleDouble files may be created by historic
    5         implementations of AFP (Apple Filing Protocol) on servers. </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2516123"></a><h2>EXAMPLES</h2><p>Hide .AppleDouble files on the [data] share:</p><pre class="programlisting">
     5        implementations of AFP (Apple Filing Protocol) on servers. </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2480126"></a><h2>EXAMPLES</h2><p>Hide .AppleDouble files on the [data] share:</p><pre class="programlisting">
    66        <em class="parameter"><code>[data]</code></em>
    77        <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = netatalk</a>
    8 </pre></div><div class="refsect1" lang="en"><a name="id2479298"></a><h2>CAVEATS</h2><p>This module is largely historic and unlikely to be of use
     8</pre></div><div class="refsect1" lang="en"><a name="id2480160"></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" lang="en"><a name="id2479310"></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" lang="en"><a name="id2479321"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     11        </p></div><div class="refsect1" lang="en"><a name="id2480172"></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" lang="en"><a name="id2480183"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfs_notify_fam.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = notify_fam</code></p></div></div><div class="refsect1" lang="en"><a name="id2516089"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = notify_fam</code></p></div></div><div class="refsect1" lang="en"><a name="id2518311"></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" lang="en"><a name="id2516122"></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" lang="en"><a name="id2480126"></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">vfs objects = notify_fam</a>
    8 </pre></div><div class="refsect1" lang="en"><a name="id2479298"></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" lang="en"><a name="id2479309"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     8</pre></div><div class="refsect1" lang="en"><a name="id2480159"></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" lang="en"><a name="id2480170"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfs_prealloc.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = prealloc</code></p></div></div><div class="refsect1" lang="en"><a name="id2516090"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = prealloc</code></p></div></div><div class="refsect1" lang="en"><a name="id2518311"></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
    44        is useful in environments where files are of a predetermined
    55        size will be written to a disk subsystem where extending file
    6         allocations is expensive.  </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2516125"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">prealloc:EXT = BYTES</span></dt><dd><p>Preallocate all files with the extension EXT to
     6        allocations is expensive.  </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2480126"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">prealloc:EXT = BYTES</span></dt><dd><p>Preallocate all files with the extension EXT to
    77                the size specified by BYTES.
    8                 </p><p>The following suffixes may be applied to BYTES:</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">K</code> - BYTES is a number of kilobytes</p></li><li><p><code class="literal">M</code> - BYTES is a number of megabytes</p></li><li><p><code class="literal">G</code> - BYTES is a number of gigabytes</p></li></ul></div></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479220"></a><h2>EXAMPLES</h2><p>A process writes TIFF files to a Samba share, and the
     8                </p><p>The following suffixes may be applied to BYTES:</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">K</code> - BYTES is a number of kilobytes</p></li><li><p><code class="literal">M</code> - BYTES is a number of megabytes</p></li><li><p><code class="literal">G</code> - BYTES is a number of gigabytes</p></li></ul></div></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2480186"></a><h2>EXAMPLES</h2><p>A process writes TIFF files to a Samba share, and the
    99        is known these files will almost always be around 4 megabytes
    1010        (4194304 bytes): </p><pre class="programlisting">
    … …  
    1313        <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = prealloc</a>
    1414        <a class="link" href="smb.conf.5.html#PREALLOC:TIFF">prealloc:tiff = 4M</a>
    15 </pre></div><div class="refsect1" lang="en"><a name="id2479385"></a><h2>CAVEATS</h2><p><code class="literal">vfs_prealloc</code> is not supported on all
     15</pre></div><div class="refsect1" lang="en"><a name="id2482588"></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" lang="en"><a name="id2479401"></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" lang="en"><a name="id2479412"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     18        </p></div><div class="refsect1" lang="en"><a name="id2482604"></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" lang="en"><a name="id2482615"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfs_readahead.8.html

    r202 r204  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_readahead</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="vfs_readahead.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_readahead &#8212; pre-load the kernel buffer cache</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = readahead</code></p></div></div><div class="refsect1" lang="en"><a name="id2516089"></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_readahead</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="vfs_readahead.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_readahead &#8212; pre-load the kernel buffer cache</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = readahead</code></p></div></div><div class="refsect1" lang="en"><a name="id2518311"></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 <code class="literal">vfs_readahead</code> VFS module detects
    33        read requests at multiples of a given offset (hex 0x80000 by
    … …  
    1313        same value as the readahead:offset option and if not
    1414        set explicitly will use the current value of
    15         readahead:offset.</p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2479186"></a><h2>OPTIONS</h2><div class="variablelist"><p>The following suffixes may be applied to BYTES:</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">K</code> - BYTES is a number of kilobytes</p></li><li><p><code class="literal">M</code> - BYTES is a number of megabytes</p></li><li><p><code class="literal">G</code> - BYTES is a number of gigabytes</p></li></ul></div><dl><dt><span class="term">readahead:offset = BYTES</span></dt><dd><p>The offset multiple that causes readahead to be
     15        readahead:offset.</p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2480151"></a><h2>OPTIONS</h2><div class="variablelist"><p>The following suffixes may be applied to BYTES:</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">K</code> - BYTES is a number of kilobytes</p></li><li><p><code class="literal">M</code> - BYTES is a number of megabytes</p></li><li><p><code class="literal">G</code> - BYTES is a number of gigabytes</p></li></ul></div><dl><dt><span class="term">readahead:offset = BYTES</span></dt><dd><p>The offset multiple that causes readahead to be
    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" lang="en"><a name="id2479260"></a><h2>EXAMPLES</h2><pre class="programlisting">
     18                readahead call.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2482463"></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">vfs objects = readahead</a>
    21 </pre></div><div class="refsect1" lang="en"><a name="id2479395"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    22         </p></div><div class="refsect1" lang="en"><a name="id2479406"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     21</pre></div><div class="refsect1" lang="en"><a name="id2482598"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
     22        </p></div><div class="refsect1" lang="en"><a name="id2482609"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    2323        were created by Andrew Tridgell. Samba is now developed
    2424        by the Samba Team as an Open Source project similar

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfs_readonly.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = readonly</code></p></div></div><div class="refsect1" lang="en"><a name="id2516090"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = readonly</code></p></div></div><div class="refsect1" lang="en"><a name="id2518310"></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
    44        time period. Clients connecting during this time will be denied
    55        write access to all files in the share, irrespective of ther
    6         actual access privileges.</p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2516125"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">readonly:period = BEGIN, END</span></dt><dd><p>Only mark the share as read only if the client
     6        actual access privileges.</p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2480127"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">readonly:period = BEGIN, END</span></dt><dd><p>Only mark the share as read only if the client
    77                connection was made between the times marked by the
    88                BEGIN and END date specifiers.
    … …  
    1010                same as that accepted by the -d option of GNU
    1111                <a class="citerefentry" href="date.1.html"><span class="citerefentry"><span class="refentrytitle">date</span>(1)</span></a>.
    12                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479197"></a><h2>EXAMPLES</h2><p>Mark all shares read only:</p><pre class="programlisting">
     12                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2480162"></a><h2>EXAMPLES</h2><p>Mark all shares read only:</p><pre class="programlisting">
    1313        <em class="parameter"><code>[global]</code></em>
    1414        <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = readonly</a>
    … …  
    1818        <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = readonly</a>
    1919        <a class="link" href="smb.conf.5.html#READONLY:PERIOD">readonly:period = readonly:period = "today 9:00","today 17:00"</a>
    20 </pre></div><div class="refsect1" lang="en"><a name="id2479385"></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" lang="en"><a name="id2479396"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     20</pre></div><div class="refsect1" lang="en"><a name="id2482588"></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" lang="en"><a name="id2482599"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfs_recycle.8.html

    r202 r204  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_recycle</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="vfs_recycle.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_recycle &#8212; Samba VFS recycle bin</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = recycle</code></p></div></div><div class="refsect1" lang="en"><a name="id2516090"></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_recycle</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="vfs_recycle.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_recycle &#8212; Samba VFS recycle bin</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = recycle</code></p></div></div><div class="refsect1" lang="en"><a name="id2518310"></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_recycle</code> intercepts file deletion
    33        requests and moves the affected files to a temporary repository
    … …  
    1111        can recover files from the recycle bin. If the recycle:keeptree
    1212        option has been specified, deleted files will be found in a path
    13         identical with that from which the file was deleted.  </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2479175"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">recycle:repository = PATH</span></dt><dd><p>Path of the directory where deleted files should be moved.
     13        identical with that from which the file was deleted.  </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2480135"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">recycle:repository = PATH</span></dt><dd><p>Path of the directory where deleted files should be moved.
    1414                </p><p>If this option is not set, the default path .recycle
    1515                is used. </p></dd><dt><span class="term">recycle:directory_mode = MODE</span></dt><dd><p>Set MODE to the octal mode the recycle repository
    … …  
    4848                and ? are supported) for which no versioning should
    4949                be used. Only useful when recycle:versions is enabled.
    50                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479387"></a><h2>EXAMPLES</h2><p>Log operations on all shares using the LOCAL1 facility
     50                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2482588"></a><h2>EXAMPLES</h2><p>Log operations on all shares using the LOCAL1 facility
    5151        and NOTICE priority:</p><pre class="programlisting">
    5252        <em class="parameter"><code>[global]</code></em>
    … …  
    5454        <a class="link" href="smb.conf.5.html#RECYCLE:FACILITY">recycle:facility = LOCAL1</a>
    5555        <a class="link" href="smb.conf.5.html#RECYCLE:PRIORITY">recycle:priority = NOTICE</a>
    56 </pre></div><div class="refsect1" lang="en"><a name="id2479446"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    57         </p></div><div class="refsect1" lang="en"><a name="id2479457"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     56</pre></div><div class="refsect1" lang="en"><a name="id2482649"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
     57        </p></div><div class="refsect1" lang="en"><a name="id2482660"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    5858        were created by Andrew Tridgell. Samba is now developed
    5959        by the Samba Team as an Open Source project similar

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfs_shadow_copy.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = shadow_copy</code></p></div></div><div class="refsect1" lang="en"><a name="id2516092"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = shadow_copy</code></p></div></div><div class="refsect1" lang="en"><a name="id2518313"></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" lang="en"><a name="id2516125"></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" lang="en"><a name="id2480131"></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" lang="en"><a name="id2479276"></a><h2>EXAMPLES</h2><p>Add shadow copy support to user home directories:</p><pre class="programlisting">
     19        </pre></div><div class="refsect1" lang="en"><a name="id2482481"></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">vfs objects = shadow_copy</a>
    22 </pre></div><div class="refsect1" lang="en"><a name="id2479414"></a><h2>CAVEATS</h2><p>This is not a backup, archival, or version control solution.
     22</pre></div><div class="refsect1" lang="en"><a name="id2482618"></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" lang="en"><a name="id2479439"></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" lang="en"><a name="id2479450"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     28        version control system.</p></div><div class="refsect1" lang="en"><a name="id2482642"></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" lang="en"><a name="id2482654"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfs_streams_depot.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = streams_depot</code></p></div></div><div class="refsect1" lang="en"><a name="id2516092"></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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = streams_depot</code></p></div></div><div class="refsect1" lang="en"><a name="id2518313"></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" lang="en"><a name="id2516126"></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" lang="en"><a name="id2479187"></a><h2>EXAMPLES</h2><pre class="programlisting">
     8        directory.</p></div><div class="refsect1" lang="en"><a name="id2480131"></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" lang="en"><a name="id2480156"></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">vfs objects = streams_depot</a>
    12 </pre></div><div class="refsect1" lang="en"><a name="id2479321"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     12</pre></div><div class="refsect1" lang="en"><a name="id2480188"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfs_streams_xattr.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = streams_xattr</code></p></div></div><div class="refsect1" lang="en"><a name="id2516090"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = streams_xattr</code></p></div></div><div class="refsect1" lang="en"><a name="id2518313"></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" lang="en"><a name="id2516135"></a><h2>EXAMPLES</h2><pre class="programlisting">
     11        applications that store serious amounts of data in ADSs.</p></div><div class="refsect1" lang="en"><a name="id2480142"></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">vfs objects = streams_xattr</a>
    14 </pre></div><div class="refsect1" lang="en"><a name="id2479304"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     14</pre></div><div class="refsect1" lang="en"><a name="id2480171"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfs_xattr_tdb.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = xattr_tdb</code></p></div></div><div class="refsect1" lang="en"><a name="id2516090"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = xattr_tdb</code></p></div></div><div class="refsect1" lang="en"><a name="id2518311"></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.
    … …  
    55        filesystems which do not support Extended Attributes
    66        by themselves. 
    7         </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2516124"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">xattr_tdb:file = PATH</span></dt><dd><p>Name of the tdb file the EAs are stored in.
     7        </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2480125"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">xattr_tdb:file = PATH</span></dt><dd><p>Name of the tdb file the EAs are stored in.
    88                If this option is not set, the default filename
    9                 <code class="filename">xattr.tdb</code> is used.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2479192"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     9                <code class="filename">xattr.tdb</code> is used.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2480156"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/vfstest.1.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2516114"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2516110"></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
    44        supports cascaded VFS modules.
    5         </p></div><div class="refsect1" lang="en"><a name="id2479175"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-c|--command=command</span></dt><dd><p>Execute the specified (colon-separated) commands.
     5        </p></div><div class="refsect1" lang="en"><a name="id2479176"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-c|--command=command</span></dt><dd><p>Execute the specified (colon-separated) commands.
    66                See below for the commands that are available.
    77                </p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    … …  
    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" lang="en"><a name="id2479437"></a><h2>COMMANDS</h2><p><span class="emphasis"><em>VFS COMMANDS</em></span></p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">load &lt;module.so&gt;</code> - Load specified VFS module </p></li><li><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" lang="en"><a name="id2479438"></a><h2>COMMANDS</h2><p><span class="emphasis"><em>VFS COMMANDS</em></span></p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">load &lt;module.so&gt;</code> - Load specified VFS module </p></li><li><p><code class="literal">populate &lt;char&gt; &lt;size&gt;</code> - Populate a data buffer with the specified data
    3636                </p></li><li><p><code class="literal">showdata [&lt;offset&gt; &lt;len&gt;]</code> - Show data currently in data buffer
    37                 </p></li><li><p><code class="literal">connect</code> - VFS connect()</p></li><li><p><code class="literal">disconnect</code> - VFS disconnect()</p></li><li><p><code class="literal">disk_free</code> - VFS disk_free()</p></li><li><p><code class="literal">opendir</code> - VFS opendir()</p></li><li><p><code class="literal">readdir</code> - VFS readdir()</p></li><li><p><code class="literal">mkdir</code> - VFS mkdir()</p></li><li><p><code class="literal">rmdir</code> - VFS rmdir()</p></li><li><p><code class="literal">closedir</code> - VFS closedir()</p></li><li><p><code class="literal">open</code> - VFS open()</p></li><li><p><code class="literal">close</code> - VFS close()</p></li><li><p><code class="literal">read</code> - VFS read()</p></li><li><p><code class="literal">write</code> - VFS write()</p></li><li><p><code class="literal">lseek</code> - VFS lseek()</p></li><li><p><code class="literal">rename</code> - VFS rename()</p></li><li><p><code class="literal">fsync</code> - VFS fsync()</p></li><li><p><code class="literal">stat</code> - VFS stat()</p></li><li><p><code class="literal">fstat</code> - VFS fstat()</p></li><li><p><code class="literal">lstat</code> - VFS lstat()</p></li><li><p><code class="literal">unlink</code> - VFS unlink()</p></li><li><p><code class="literal">chmod</code> - VFS chmod()</p></li><li><p><code class="literal">fchmod</code> - VFS fchmod()</p></li><li><p><code class="literal">chown</code> - VFS chown()</p></li><li><p><code class="literal">fchown</code> - VFS fchown()</p></li><li><p><code class="literal">chdir</code> - VFS chdir()</p></li><li><p><code class="literal">getwd</code> - VFS getwd()</p></li><li><p><code class="literal">utime</code> - VFS utime()</p></li><li><p><code class="literal">ftruncate</code> - VFS ftruncate()</p></li><li><p><code class="literal">lock</code> - VFS lock()</p></li><li><p><code class="literal">symlink</code> - VFS symlink()</p></li><li><p><code class="literal">readlink</code> - VFS readlink()</p></li><li><p><code class="literal">link</code> - VFS link()</p></li><li><p><code class="literal">mknod</code> - VFS mknod()</p></li><li><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 type="disc"><li><p><code class="literal">conf &lt;smb.conf&gt;</code> - Load a different configuration file</p></li><li><p><code class="literal">help [&lt;command&gt;]</code> - Get list of commands or info about specified command</p></li><li><p><code class="literal">debuglevel &lt;level&gt;</code> - Set debug level</p></li><li><p><code class="literal">freemem</code> - Free memory currently in use</p></li><li><p><code class="literal">exit</code> - Exit vfstest</p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2478588"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
    38         suite.</p></div><div class="refsect1" lang="en"><a name="id2478599"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     37                </p></li><li><p><code class="literal">connect</code> - VFS connect()</p></li><li><p><code class="literal">disconnect</code> - VFS disconnect()</p></li><li><p><code class="literal">disk_free</code> - VFS disk_free()</p></li><li><p><code class="literal">opendir</code> - VFS opendir()</p></li><li><p><code class="literal">readdir</code> - VFS readdir()</p></li><li><p><code class="literal">mkdir</code> - VFS mkdir()</p></li><li><p><code class="literal">rmdir</code> - VFS rmdir()</p></li><li><p><code class="literal">closedir</code> - VFS closedir()</p></li><li><p><code class="literal">open</code> - VFS open()</p></li><li><p><code class="literal">close</code> - VFS close()</p></li><li><p><code class="literal">read</code> - VFS read()</p></li><li><p><code class="literal">write</code> - VFS write()</p></li><li><p><code class="literal">lseek</code> - VFS lseek()</p></li><li><p><code class="literal">rename</code> - VFS rename()</p></li><li><p><code class="literal">fsync</code> - VFS fsync()</p></li><li><p><code class="literal">stat</code> - VFS stat()</p></li><li><p><code class="literal">fstat</code> - VFS fstat()</p></li><li><p><code class="literal">lstat</code> - VFS lstat()</p></li><li><p><code class="literal">unlink</code> - VFS unlink()</p></li><li><p><code class="literal">chmod</code> - VFS chmod()</p></li><li><p><code class="literal">fchmod</code> - VFS fchmod()</p></li><li><p><code class="literal">chown</code> - VFS chown()</p></li><li><p><code class="literal">fchown</code> - VFS fchown()</p></li><li><p><code class="literal">chdir</code> - VFS chdir()</p></li><li><p><code class="literal">getwd</code> - VFS getwd()</p></li><li><p><code class="literal">utime</code> - VFS utime()</p></li><li><p><code class="literal">ftruncate</code> - VFS ftruncate()</p></li><li><p><code class="literal">lock</code> - VFS lock()</p></li><li><p><code class="literal">symlink</code> - VFS symlink()</p></li><li><p><code class="literal">readlink</code> - VFS readlink()</p></li><li><p><code class="literal">link</code> - VFS link()</p></li><li><p><code class="literal">mknod</code> - VFS mknod()</p></li><li><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 type="disc"><li><p><code class="literal">conf &lt;smb.conf&gt;</code> - Load a different configuration file</p></li><li><p><code class="literal">help [&lt;command&gt;]</code> - Get list of commands or info about specified command</p></li><li><p><code class="literal">debuglevel &lt;level&gt;</code> - Set debug level</p></li><li><p><code class="literal">freemem</code> - Free memory currently in use</p></li><li><p><code class="literal">exit</code> - Exit vfstest</p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2478590"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
     38        suite.</p></div><div class="refsect1" lang="en"><a name="id2478601"></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

  • branches/samba-3.2.x/docs/htmldocs/manpages/wbinfo.1.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">wbinfo</code> [-a user%password] [--all-domains] [--allocate-gid] [--allocate-uid] [-D domain] [--domain domain] [-g] [--getdcname domain] [--get-auth-user] [-G gid] [-h] [-i user] [-I ip] [-K user%password] [-m] [-n name] [-N netbios-name] [--own-domain] [-p] [-r user] [-s sid] [--separator] [--sequence] [--set-auth-user user%password] [-S sid] [-t] [-u] [--uid-info uid] [--user-domgroups sid] [--user-sids sid] [-U uid] [-V] [-Y sid] [--verbose]</p></div></div><div class="refsect1" lang="en"><a name="id2479377"></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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">wbinfo</code> [-a user%password] [--all-domains] [--allocate-gid] [--allocate-uid] [-D domain] [--domain domain] [-g] [--getdcname domain] [--get-auth-user] [-G gid] [-h] [-i user] [-I ip] [-K user%password] [-m] [-n name] [-N netbios-name] [--own-domain] [-p] [-r user] [-s sid] [--separator] [--sequence] [--set-auth-user user%password] [-S sid] [-t] [-u] [--uid-info uid] [--user-domgroups sid] [--user-sids sid] [-U uid] [-V] [-Y sid] [--verbose]</p></div></div><div class="refsect1" lang="en"><a name="id2479378"></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" lang="en"><a name="id2479432"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-a|--authenticate username%password</span></dt><dd><p>Attempt to authenticate a user via winbindd.
     4        to return information.</p></div><div class="refsect1" lang="en"><a name="id2479433"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-a|--authenticate username%password</span></dt><dd><p>Attempt to authenticate a user via winbindd.
    55                This checks both authenticaion methods and reports its results.
    66                </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Do not be tempted to use this
    … …  
    8383                the operation will fail. </p></dd><dt><span class="term">-V</span></dt><dd><p>Prints the program version number.
    8484</p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    85 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478788"></a><h2>EXIT STATUS</h2><p>The wbinfo program returns 0 if the operation
     85</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478789"></a><h2>EXIT STATUS</h2><p>The wbinfo program returns 0 if the operation
    8686        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
    87         failure. </p></div><div class="refsect1" lang="en"><a name="id2525483"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    88         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2525494"></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" lang="en"><a name="id2525518"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     87        failure. </p></div><div class="refsect1" lang="en"><a name="id2525479"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     88        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2525490"></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" lang="en"><a name="id2525513"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    8989        were created by Andrew Tridgell. Samba is now developed
    9090        by the Samba Team as an Open Source project similar

  • branches/samba-3.2.x/docs/htmldocs/manpages/winbindd.8.html

    r202 r204  
    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.73.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><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"><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" lang="en"><a name="id2479178"></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"><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" lang="en"><a name="id2479179"></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
    … …  
    6161        WINS server.</p><pre class="programlisting">
    6262hosts:          files wins
    63 </pre></div><div class="refsect1" lang="en"><a name="id2478335"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-F</span></dt><dd><p>If specified, this parameter causes
     63</pre></div><div class="refsect1" lang="en"><a name="id2478337"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-F</span></dt><dd><p>If specified, this parameter causes
    6464                the main <code class="literal">winbindd</code> process to not daemonize,
    6565                i.e. double-fork and disassociate with the terminal.
    … …  
    114114                default behavior is to launch a child process that is responsible for
    115115                updating expired cache entries.
    116                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478600"></a><h2>NAME AND ID RESOLUTION</h2><p>Users and groups on a Windows NT server are assigned
     116                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2478601"></a><h2>NAME AND ID RESOLUTION</h2><p>Users and groups on a Windows NT server are assigned
    117117        a security id (SID) which is globally unique when the
    118118        user or group is created.  To convert the Windows NT user or group
    … …  
    130130        and group rids. </p><p>See the <a class="link" href="smb.conf.5.html#IDMAPDOMAINS">idmap domains</a> or the old <a class="link" href="smb.conf.5.html#IDMAPBACKEND">idmap backend</a> parameters in
    131131        <code class="filename">smb.conf</code> for options for sharing this
    132         database, such as via LDAP.</p></div><div class="refsect1" lang="en"><a name="id2478674"></a><h2>CONFIGURATION</h2><p>Configuration of the <code class="literal">winbindd</code> daemon
     132        database, such as via LDAP.</p></div><div class="refsect1" lang="en"><a name="id2478675"></a><h2>CONFIGURATION</h2><p>Configuration of the <code class="literal">winbindd</code> daemon
    133133        is done through configuration parameters in the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file.  All parameters should be specified in the
    134134        [global] section of smb.conf. </p><div class="itemizedlist"><ul type="disc"><li><p>
    … …  
    147147                instead of LDAP to retrieve information from Domain
    148148                Controllers.
    149                 </p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2525542"></a><h2>EXAMPLE SETUP</h2><p>
     149                </p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2525538"></a><h2>EXAMPLE SETUP</h2><p>
    150150        To setup winbindd for user and group lookups plus
    151151        authentication from a domain controller use something like the
    … …  
    198198        the DOMAIN+user syntax for the username. You may wish to use the
    199199        commands <code class="literal">getent passwd</code> and <code class="literal">getent group
    200         </code> to confirm the correct operation of winbindd.</p></div><div class="refsect1" lang="en"><a name="id2525750"></a><h2>NOTES</h2><p>The following notes are useful when configuring and
     200        </code> to confirm the correct operation of winbindd.</p></div><div class="refsect1" lang="en"><a name="id2525746"></a><h2>NOTES</h2><p>The following notes are useful when configuring and
    201201        running <code class="literal">winbindd</code>: </p><p><a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> must be running on the local machine
    202202        for <code class="literal">winbindd</code> to work. </p><p>PAM is really easy to misconfigure.  Make sure you know what
    … …  
    206206        be the same.  The user and group ids will only be valid for the local
    207207        machine, unless a shared <a class="link" href="smb.conf.5.html#IDMAPBACKEND">idmap backend</a> is configured.</p><p>If the the Windows NT SID to UNIX user and group id mapping
    208         file is damaged or destroyed then the mappings will be lost. </p></div><div class="refsect1" lang="en"><a name="id2525821"></a><h2>SIGNALS</h2><p>The following signals can be used to manipulate the
     208        file is damaged or destroyed then the mappings will be lost. </p></div><div class="refsect1" lang="en"><a name="id2525817"></a><h2>SIGNALS</h2><p>The following signals can be used to manipulate the
    209209        <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
    210210                apply any parameter changes to the running
    … …  
    214214                winbindd</code> to write status information to the winbind
    215215                log file.</p><p>Log files are stored in the filename specified by the
    216                 log file parameter.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2525887"></a><h2>FILES</h2><div class="variablelist"><dl><dt><span class="term"><code class="filename">/etc/nsswitch.conf(5)</code></span></dt><dd><p>Name service switch configuration file.</p></dd><dt><span class="term">/tmp/.winbindd/pipe</span></dt><dd><p>The UNIX pipe over which clients communicate with
     216                log file parameter.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2525882"></a><h2>FILES</h2><div class="variablelist"><dl><dt><span class="term"><code class="filename">/etc/nsswitch.conf(5)</code></span></dt><dd><p>Name service switch configuration file.</p></dd><dt><span class="term">/tmp/.winbindd/pipe</span></dt><dd><p>The UNIX pipe over which clients communicate with
    217217                the <code class="literal">winbindd</code> program.  For security reasons, the
    218218                winbind client will only attempt to connect to the winbindd daemon
    … …  
    235235                This directory is by default <code class="filename">/usr/local/samba/var/locks
    236236                </code>. </p></dd><dt><span class="term">$LOCKDIR/winbindd_cache.tdb</span></dt><dd><p>Storage for cached user and group information.
    237                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2526042"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    238         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2526053"></a><h2>SEE ALSO</h2><p><code class="filename">nsswitch.conf(5)</code>, <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>, <a class="citerefentry" href="wbinfo.1.html"><span class="citerefentry"><span class="refentrytitle">wbinfo</span>(1)</span></a>, <a class="citerefentry" href="ntlm_auth.8.html"><span class="citerefentry"><span class="refentrytitle">ntlm_auth</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="pam_winbind.8.html"><span class="citerefentry"><span class="refentrytitle">pam_winbind</span>(8)</span></a></p></div><div class="refsect1" lang="en"><a name="id2526111"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     237                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2526038"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     238        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2526049"></a><h2>SEE ALSO</h2><p><code class="filename">nsswitch.conf(5)</code>, <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>, <a class="citerefentry" href="wbinfo.1.html"><span class="citerefentry"><span class="refentrytitle">wbinfo</span>(1)</span></a>, <a class="citerefentry" href="ntlm_auth.8.html"><span class="citerefentry"><span class="refentrytitle">ntlm_auth</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="pam_winbind.8.html"><span class="citerefentry"><span class="refentrytitle">pam_winbind</span>(8)</span></a></p></div><div class="refsect1" lang="en"><a name="id2526106"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    239239        were created by Andrew Tridgell. Samba is now developed
    240240        by the Samba Team as an Open Source project similar
Note: See TracChangeset for help on using the changeset viewer.