Ignore:
Timestamp:
Mar 1, 2010, 3:05:48 PM (15 years ago)
Author:
Herwig Bauernfeind
Message:

Update Samba 3.3.x to 3.3.11

Location:
branches/samba-3.3.x/docs/htmldocs/manpages
Files:
84 edited

Legend:

Unmodified
Added
Removed

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

    r368 r411  
    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.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="cifs.upcall"><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" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">cifs.upcall</code> [--trust-dns|-t] [--version|-v] {keyid}</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528928"></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.74.0"></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> [--trust-dns|-t] [--version|-v] {keyid}</p></div></div><div class="refsect1" lang="en"><a name="id2522940"></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" title="OPTIONS"><a name="id2489324"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-c</span></dt><dd><p>This option is deprecated and is currently ignored.
     7to be run that way.</p></div><div class="refsect1" lang="en"><a name="id2483345"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-c</span></dt><dd><p>This option is deprecated and is currently ignored.
    88                </p></dd><dt><span class="term">--trust-dns|-t</span></dt><dd><p>With krb5 upcalls, the name used as the host portion of the service principal defaults to the hostname portion of the UNC. This option allows the upcall program to reverse resolve the network address of the server in order to get the hostname.</p><p>This is less secure than not trusting DNS. When using this option, it's possible that an attacker could get control of DNS and trick the client into mounting a different server altogether. It's preferable to instead add server principals to the KDC for every possible hostname, but this option exists for cases where that isn't possible. The default is to not trust reverse hostname lookups in this fashion.
    99                </p></dd><dt><span class="term">--version|-v</span></dt><dd><p>Print version number and exit.
    10                 </p></dd></dl></div></div><div class="refsect1" title="CONFIGURATION FOR KEYCTL"><a name="id2489514"></a><h2>CONFIGURATION FOR KEYCTL</h2><p>cifs.upcall is designed to be called from the kernel via the
     10                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483529"></a><h2>CONFIGURATION FOR KEYCTL</h2><p>cifs.upcall is designed to be called from the kernel via the
    1111        request-key callout program. This requires that request-key be told
    1212        where and how to call this program. The current cifs.upcall program
    … …  
    2121</pre><p>
    2222See <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.
    23 </p></div><div class="refsect1" title="SEE ALSO"><a name="id2489585"></a><h2>SEE ALSO</h2><p>
     23</p></div><div class="refsect1" lang="en"><a name="id2483600"></a><h2>SEE ALSO</h2><p>
    2424        <a class="citerefentry" href="request-key.conf.5.html"><span class="citerefentry"><span class="refentrytitle">request-key.conf</span>(5)</span></a>,
    2525        <a class="citerefentry" href="mount.cifs.8.html"><span class="citerefentry"><span class="refentrytitle">mount.cifs</span>(8)</span></a>
    26         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489611"></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
     26        </p></div><div class="refsect1" lang="en"><a name="id2483626"></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
    2727                CIFS Mailing list</a> is the preferred place to ask
    2828                questions regarding these programs.

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>eventlogadm</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="eventlogadm"><a name="eventlogadm.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>eventlogadm &#8212; push records into the Samba event log store</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">eventlogadm</code> [<code class="option">-d</code>] [<code class="option">-h</code>]  <code class="option">-o</code>
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>eventlogadm</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="eventlogadm.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>eventlogadm &#8212; push records into the Samba event log store</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">eventlogadm</code> [<code class="option">-d</code>] [<code class="option">-h</code>]  <code class="option">-o</code>
    22                <code class="literal">addsource</code>
    33                <em class="replaceable"><code>EVENTLOG</code></em>
    … …  
    77                <code class="literal">write</code>
    88                <em class="replaceable"><code>EVENTLOG</code></em>
    9                  </p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2489354"></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="id2483376"></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" title="OPTIONS"><a name="id2489516"></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="id2483530"></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" title="EVENTLOG RECORD FORMAT"><a name="id2489631"></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="id2483646"></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
    3737        and data separated by a colon character. Records are separated
    38         by at least one or more blank line.</p><p>The event log record field are:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     38        by at least one or more blank line.</p><p>The event log record field are:</p><div class="itemizedlist"><ul type="disc"><li><p>
    3939                <code class="literal">LEN</code> - This field should be 0, since <code class="literal">eventlogadm</code> will calculate this value.
    40                 </p></li><li class="listitem"><p>
     40                </p></li><li><p>
    4141                <code class="literal">RS1</code> - This must be the value 1699505740.
    42                 </p></li><li class="listitem"><p>
     42                </p></li><li><p>
    4343                <code class="literal">RCN</code> -  This field should be 0.
    44                 </p></li><li class="listitem"><p>
     44                </p></li><li><p>
    4545                <code class="literal">TMG</code> - The time the eventlog record
    4646                was generated; format is the number of seconds since
    4747                00:00:00 January 1, 1970, UTC.
    48                 </p></li><li class="listitem"><p>
     48                </p></li><li><p>
    4949                <code class="literal">TMW</code> - The time the eventlog record was
    5050                written; format is the number of seconds since 00:00:00
    5151                January 1, 1970, UTC.
    52                 </p></li><li class="listitem"><p>
     52                </p></li><li><p>
    5353                <code class="literal">EID</code> - The eventlog ID.
    54                 </p></li><li class="listitem"><p>
     54                </p></li><li><p>
    5555                <code class="literal">ETP</code> - The event type -- one of
    5656                "INFO",
    5757                "ERROR", "WARNING", "AUDIT
    5858                SUCCESS" or "AUDIT FAILURE".
    59                 </p></li><li class="listitem"><p>
     59                </p></li><li><p>
    6060                <code class="literal">ECT</code> - The event category; this depends
    6161                on the message file. It is primarily used as a means of
    6262                filtering in the eventlog viewer.
    63                 </p></li><li class="listitem"><p>
     63                </p></li><li><p>
    6464                <code class="literal">RS2</code> - This field should be 0.
    65                 </p></li><li class="listitem"><p>
     65                </p></li><li><p>
    6666                <code class="literal">CRN</code> - This field should be 0.
    67                 </p></li><li class="listitem"><p>
     67                </p></li><li><p>
    6868                <code class="literal">USL</code> - This field should be 0.
    69                 </p></li><li class="listitem"><p>
     69                </p></li><li><p>
    7070                <code class="literal">SRC</code> - This field contains the source
    7171                name associated with the event log. If a message file is
    7272                used with an event log, there will be a registry entry
    7373                for associating this source name with a message file DLL.
    74                 </p></li><li class="listitem"><p>
     74                </p></li><li><p>
    7575                <code class="literal">SRN</code> - The name of the machine on
    7676                which the eventlog was generated. This is typically the
    7777                host name.
    78                 </p></li><li class="listitem"><p>
     78                </p></li><li><p>
    7979                <code class="literal">STR</code> - The text associated with the
    8080                eventlog. There may be more than one string in a record.
    81                 </p></li><li class="listitem"><p>
     81                </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" title="EXAMPLES"><a name="id2487492"></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="id2481512"></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" title="VERSION"><a name="id2487542"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id2487553"></a><h2>AUTHOR</h2><p> The original Samba software and related utilities were
     106        </pre></div><div class="refsect1" lang="en"><a name="id2481562"></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="id2481573"></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.3.x/docs/htmldocs/manpages/findsmb.1.html

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

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>idmap_ad</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="idmap_ad"><a name="idmap_ad.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>idmap_ad &#8212; Samba's idmap_ad Backend for Winbind</p></div><div class="refsynopsisdiv" title="DESCRIPTION"><h2>DESCRIPTION</h2><p>The idmap_ad plugin provides a way for Winbind to read
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>idmap_ad</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="idmap_ad.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>idmap_ad &#8212; Samba's idmap_ad Backend for Winbind</p></div><div class="refsynopsisdiv"><h2>DESCRIPTION</h2><p>The idmap_ad plugin provides a way for Winbind to read
    22        id mappings from an AD server that uses RFC2307/SFU schema
    33        extensions. This module implements only the "idmap"
    … …  
    55        by the administrator by adding the posixAccount/posixGroup
    66        classes and relative attribute/value pairs to the user and
    7         group objects in the AD.</p></div><div class="refsect1" title="IDMAP OPTIONS"><a name="id2528900"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">range = low - high</span></dt><dd><p>
     7        group objects in the AD.</p></div><div class="refsect1" lang="en"><a name="id2522919"></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 be 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" title="EXAMPLES"><a name="id2489314"></a><h2>EXAMPLES</h2><p>
     19                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483331"></a><h2>EXAMPLES</h2><p>
    2020        The following example shows how to retrieve idmappings from our principal and
    2121        and trusted AD domains. If trusted domains are present id conflicts must be
    … …  
    3333        idmap config CORP : backend  = ad
    3434        idmap config CORP : range = 1000-999999
    35         </pre></div><div class="refsect1" title="AUTHOR"><a name="id2489338"></a><h2>AUTHOR</h2><p>
     35        </pre></div><div class="refsect1" lang="en"><a name="id2483355"></a><h2>AUTHOR</h2><p>
    3636        The original Samba software and related utilities
    3737        were created by Andrew Tridgell. Samba is now developed

  • branches/samba-3.3.x/docs/htmldocs/manpages/idmap_adex.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>idmap_adex</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="idmap_adex"><a name="idmap_adex.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>idmap_adex &#8212; Samba's idmap_adex Backend for Winbind</p></div><div class="refsynopsisdiv" title="DESCRIPTION"><h2>DESCRIPTION</h2><p>
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>idmap_adex</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="idmap_adex.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>idmap_adex &#8212; Samba's idmap_adex Backend for Winbind</p></div><div class="refsynopsisdiv"><h2>DESCRIPTION</h2><p>
    22          The idmap_adex plugin provides a way for Winbind to read
    33          id mappings from an AD server that uses RFC2307 schema
    … …  
    1414          catalog servers.  This can be done using the Active Directory Schema
    1515          Management MMC plugin (schmmgmt.dll).
    16         </p></div><div class="refsynopsisdiv" title="NSS_INFO"><h2>NSS_INFO</h2><p>
     16        </p></div><div class="refsynopsisdiv"><h2>NSS_INFO</h2><p>
    1717          The nss_info plugin supports reading the unixHomeDirectory,
    1818          gidNumber, loginShell, and uidNumber attributes from the user
    … …  
    2626          on the user object.  While group name aliases are implemented
    2727          by reading the displayname attribute from the group object.
    28         </p></div><div class="refsect1" title="EXAMPLES"><a name="id2528941"></a><h2>EXAMPLES</h2><p>
     28        </p></div><div class="refsect1" lang="en"><a name="id2522952"></a><h2>EXAMPLES</h2><p>
    2929          The following example shows how to retrieve idmappings and NSS data
    3030          from our principal and trusted AD domains.
    … …  
    3737        winbind nss info = adex
    3838        winbind normalize names = yes
    39         </pre></div><div class="refsect1" title="AUTHOR"><a name="id2489320"></a><h2>AUTHOR</h2><p>
     39        </pre></div><div class="refsect1" lang="en"><a name="id2483341"></a><h2>AUTHOR</h2><p>
    4040        The original Samba software and related utilities
    4141        were created by Andrew Tridgell. Samba is now developed

  • branches/samba-3.3.x/docs/htmldocs/manpages/idmap_hash.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>idmap_hash</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="idmap_hash"><a name="idmap_hash.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>idmap_hash &#8212; Samba's idmap_hash Backend for Winbind</p></div><div class="refsynopsisdiv" title="DESCRIPTION"><h2>DESCRIPTION</h2><p>The idmap_hash plugin implements a hashing algorithm used
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>idmap_hash</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="idmap_hash.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>idmap_hash &#8212; Samba's idmap_hash Backend for Winbind</p></div><div class="refsynopsisdiv"><h2>DESCRIPTION</h2><p>The idmap_hash plugin implements a hashing algorithm used
    22          map SIDs for domain users and groups to a 31-bit uid and gid.
    33          This plugin also implements the nss_info API and can be used
    … …  
    55          "winbind normlaize names" and "winbind nss info"
    66          parameters in smb.conf.
    7         </p></div><div class="refsect1" title="IDMAP OPTIONS"><a name="id2528906"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">name_map</span></dt><dd><p>
     7        </p></div><div class="refsect1" lang="en"><a name="id2522917"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">name_map</span></dt><dd><p>
    88                    Specifies the absolute path to the name mapping
    99                    file used by the nss_info API.  Entries in the file
    … …  
    1111                    = <em class="replaceable"><code>qualified domain name</code></em>".
    1212                    Mapping of both user and group names is supported.
    13                 </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id2528938"></a><h2>EXAMPLES</h2><p>The following example utilizes the idmap_hash plugin for
     13                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2522949"></a><h2>EXAMPLES</h2><p>The following example utilizes the idmap_hash plugin for
    1414          the idmap and nss_info information.
    1515        </p><pre class="programlisting">
    … …  
    2222        winbind normalize names = yes
    2323        idmap_hash:name_map = /etc/samba/name_map.cfg
    24         </pre></div><div class="refsect1" title="AUTHOR"><a name="id2489317"></a><h2>AUTHOR</h2><p>
     24        </pre></div><div class="refsect1" lang="en"><a name="id2483338"></a><h2>AUTHOR</h2><p>
    2525        The original Samba software and related utilities
    2626        were created by Andrew Tridgell. Samba is now developed

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>idmap_ldap</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="idmap_ldap"><a name="idmap_ldap.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>idmap_ldap &#8212; Samba's idmap_ldap Backend for Winbind</p></div><div class="refsynopsisdiv" title="DESCRIPTION"><h2>DESCRIPTION</h2><p>The idmap_ldap plugin provides a means for Winbind to
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>idmap_ldap</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="idmap_ldap.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>idmap_ldap &#8212; Samba's idmap_ldap Backend for Winbind</p></div><div class="refsynopsisdiv"><h2>DESCRIPTION</h2><p>The idmap_ldap plugin provides a means for Winbind to
    22        store and retrieve SID/uid/gid mapping tables in an LDAP directory
    33        service.
    … …  
    2020        should have the same range as the default range, since it needs
    2121        to use the global uid / gid allocator. See the example below.
    22         </p></div><div class="refsect1" title="IDMAP OPTIONS"><a name="id2528933"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">ldap_base_dn = DN</span></dt><dd><p>
     22        </p></div><div class="refsect1" lang="en"><a name="id2522944"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">ldap_base_dn = DN</span></dt><dd><p>
    2323                        Defines the directory base suffix to use when searching for
    2424                        SID/uid/gid mapping entries.  If not defined, idmap_ldap will default
    … …  
    3737                        "idmap uid" and "idmap gid" options
    3838                        from smb.conf.
    39                 </p></dd></dl></div></div><div class="refsect1" title="IDMAP ALLOC OPTIONS"><a name="id2489360"></a><h2>IDMAP ALLOC OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">ldap_base_dn = DN</span></dt><dd><p>
     39                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483381"></a><h2>IDMAP ALLOC OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">ldap_base_dn = DN</span></dt><dd><p>
    4040                        Defines the directory base suffix under which new SID/uid/gid mapping
    4141                        entries should be stored.  If not defined, idmap_ldap will default
    … …  
    4848                        be sent.  If not defined, idmap_ldap will assume that ldap://localhost/
    4949                        should be used.
    50                 </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id2489544"></a><h2>EXAMPLES</h2><p>
     50                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483559"></a><h2>EXAMPLES</h2><p>
    5151        The follow sets of a LDAP configuration which uses two LDAP
    5252        directories, one for storing the ID mappings and one for retrieving
    … …  
    6161        idmap alloc config : ldap_url   = ldap://id-master/
    6262        idmap alloc config : ldap_base_dn = ou=idmap,dc=example,dc=com
    63         </pre></div><div class="refsynopsisdiv" title="NOTE"><h2>NOTE</h2><p>In order to use authentication against ldap servers you may
     63        </pre></div><div class="refsynopsisdiv"><h2>NOTE</h2><p>In order to use authentication against ldap servers you may
    6464        need to provide a DN and a password. To avoid exposing the password
    6565        in plain text in the configuration file we store it into a security
    6666        store. The "net idmap " command is used to store a secret
    6767        for the DN specified in a specific idmap domain.
    68         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489581"></a><h2>AUTHOR</h2><p>
     68        </p></div><div class="refsect1" lang="en"><a name="id2483595"></a><h2>AUTHOR</h2><p>
    6969        The original Samba software and related utilities
    7070        were created by Andrew Tridgell. Samba is now developed

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>idmap_nss</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="idmap_nss"><a name="idmap_nss.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>idmap_nss &#8212; Samba's idmap_nss Backend for Winbind</p></div><div class="refsynopsisdiv" title="DESCRIPTION"><h2>DESCRIPTION</h2><p>The idmap_nss plugin provides a means to map Unix users and groups
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>idmap_nss</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="idmap_nss.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>idmap_nss &#8212; Samba's idmap_nss Backend for Winbind</p></div><div class="refsynopsisdiv"><h2>DESCRIPTION</h2><p>The idmap_nss plugin provides a means to map Unix users and groups
    22        to Windows accounts and obseletes the "winbind trusted domains only"
    33        smb.conf option.  This provides a simple means of ensuring that the SID
    … …  
    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" title="EXAMPLES"><a name="id2528901"></a><h2>EXAMPLES</h2><p>
     7        </p></div><div class="refsect1" lang="en"><a name="id2522920"></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
    … …  
    1616        idmap config SAMBA : backend  = nss
    1717        idmap config SAMBA : range = 1000-999999
    18         </pre></div><div class="refsect1" title="AUTHOR"><a name="id2528921"></a><h2>AUTHOR</h2><p>
     18        </pre></div><div class="refsect1" lang="en"><a name="id2522940"></a><h2>AUTHOR</h2><p>
    1919        The original Samba software and related utilities
    2020        were created by Andrew Tridgell. Samba is now developed

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>idmap_rid</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="idmap_rid"><a name="idmap_rid.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>idmap_rid &#8212; Samba's idmap_rid Backend for Winbind</p></div><div class="refsynopsisdiv" title="DESCRIPTION"><h2>DESCRIPTION</h2><p>The idmap_rid backend provides a way to use an algorithmic
     1<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.74.0"></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" title="IDMAP OPTIONS"><a name="id2528897"></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="id2522916"></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.
    … …  
    1616                </p><p>
    1717                        Use of this parameter is deprecated.
    18                 </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id2489314"></a><h2>EXAMPLES</h2><p>This example shows how to configure a domain with idmap_rid</p><pre class="programlisting">
     18                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483331"></a><h2>EXAMPLES</h2><p>This example shows how to configure a domain with idmap_rid</p><pre class="programlisting">
    1919        [global]
    2020        idmap backend = tdb
    … …  
    2424        idmap config TRUSTED : backend  = rid
    2525        idmap config TRUSTED : range    = 50000 - 99999
    26         </pre></div><div class="refsect1" title="AUTHOR"><a name="id2489332"></a><h2>AUTHOR</h2><p>
     26        </pre></div><div class="refsect1" lang="en"><a name="id2483350"></a><h2>AUTHOR</h2><p>
    2727        The original Samba software and related utilities
    2828        were created by Andrew Tridgell. Samba is now developed

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>idmap_tdb</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="idmap_tdb"><a name="idmap_tdb.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>idmap_tdb &#8212; Samba's idmap_tdb Backend for Winbind</p></div><div class="refsynopsisdiv" title="DESCRIPTION"><h2>DESCRIPTION</h2><p>
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>idmap_tdb</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="idmap_tdb.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>idmap_tdb &#8212; Samba's idmap_tdb Backend for Winbind</p></div><div class="refsynopsisdiv"><h2>DESCRIPTION</h2><p>
    22        The idmap_tdb plugin is the default backend used by winbindd
    33        for storing SID/uid/gid mapping tables.
    … …  
    2020        should have the same range as the default range, since it needs
    2121        to use the global uid / gid allocator. See the example below.
    22         </p></div><div class="refsect1" title="IDMAP OPTIONS"><a name="id2528926"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">range = low - high</span></dt><dd><p>
     22        </p></div><div class="refsect1" lang="en"><a name="id2522945"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">range = low - high</span></dt><dd><p>
    2323                        Defines the available matching uid and gid range for which the
    2424                        backend is authoritative.
    … …  
    2626                        the "idmap uid" and "idmap gid" options
    2727                        from smb.conf.
    28                 </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id2489319"></a><h2>EXAMPLES</h2><p>
     28                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483336"></a><h2>EXAMPLES</h2><p>
    2929        This example shows how tdb is used as a the default idmap backend.
    3030        It configures the idmap range through the global options for all
    … …  
    5454        idmap config DOM1 : backend = tdb
    5555        idmap config DOM1 : range = 1000000-2000000
    56         </pre></div><div class="refsect1" title="AUTHOR"><a name="id2489361"></a><h2>AUTHOR</h2><p>
     56        </pre></div><div class="refsect1" lang="en"><a name="id2483377"></a><h2>AUTHOR</h2><p>
    5757        The original Samba software and related utilities
    5858        were created by Andrew Tridgell. Samba is now developed

  • branches/samba-3.3.x/docs/htmldocs/manpages/idmap_tdb2.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>idmap_tdb2</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="idmap_tdb2"><a name="idmap_tdb2.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>idmap_tdb2 &#8212; Samba's idmap_tdb2 Backend for Winbind</p></div><div class="refsynopsisdiv" title="DESCRIPTION"><h2>DESCRIPTION</h2><p>
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>idmap_tdb2</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="idmap_tdb2.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>idmap_tdb2 &#8212; Samba's idmap_tdb2 Backend for Winbind</p></div><div class="refsynopsisdiv"><h2>DESCRIPTION</h2><p>
    22        The idmap_tdb2 plugin is a substitute for the default idmap_tdb
    33        backend used by winbindd for storing SID/uid/gid mapping tables
    … …  
    2121        should have the same range as the default range, since it needs
    2222        to use the global uid / gid allocator. See the example below.
    23         </p></div><div class="refsect1" title="IDMAP OPTIONS"><a name="id2528934"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">range = low - high</span></dt><dd><p>
     23        </p></div><div class="refsect1" lang="en"><a name="id2522945"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">range = low - high</span></dt><dd><p>
    2424                        Defines the available matching uid and gid range for which the
    2525                        backend is authoritative.
    … …  
    2727                        the "idmap uid" and "idmap gid" options
    2828                        from smb.conf.
    29                 </p></dd></dl></div></div><div class="refsect1" title="IDMAP SCRIPT"><a name="id2489317"></a><h2>IDMAP SCRIPT</h2><p>
     29                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483338"></a><h2>IDMAP SCRIPT</h2><p>
    3030        The tdb2 idmap backend supports a script for performing id mappings
    3131        through the smb.conf option <em class="parameter"><code>idmap : script</code></em>.
    … …  
    4848        SIDs unmapped by the script might get mapped to IDs that had
    4949        previously been mapped by the script.
    50         </p></div><div class="refsect1" title="EXAMPLES"><a name="id2489359"></a><h2>EXAMPLES</h2><p>
     50        </p></div><div class="refsect1" lang="en"><a name="id2483382"></a><h2>EXAMPLES</h2><p>
    5151        This example shows how tdb2 is used as a the default idmap backend.
    5252        It configures the idmap range through the global options for all
    … …  
    5757        idmap uid = 1000000-2000000
    5858        idmap gid = 1000000-2000000
    59         </pre></div><div class="refsect1" title="AUTHOR"><a name="id2489512"></a><h2>AUTHOR</h2><p>
     59        </pre></div><div class="refsect1" lang="en"><a name="id2483528"></a><h2>AUTHOR</h2><p>
    6060        The original Samba software and related utilities
    6161        were created by Andrew Tridgell. Samba is now developed

  • branches/samba-3.3.x/docs/htmldocs/manpages/index.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title></title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article"><div class="titlepage"><hr></div><div class="variablelist"><dl><dt><span class="term"><a class="ulink" href="cifs.upcall.8.html" target="_top">cifs.upcall(8)</a></span></dt><dd><p>Userspace upcall helper for Common Internet File System (CIFS)
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title></title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><hr></div><div class="variablelist"><dl><dt><span class="term"><a class="ulink" href="cifs.upcall.8.html" target="_top">cifs.upcall(8)</a></span></dt><dd><p>Userspace upcall helper for Common Internet File System (CIFS)
    22</p></dd><dt><span class="term"><a class="ulink" href="eventlogadm.8.html" target="_top">eventlogadm(8)</a></span></dt><dd><p>push records into the Samba event log store
    33</p></dd><dt><span class="term"><a class="ulink" href="findsmb.1.html" target="_top">findsmb(1)</a></span></dt><dd><p>list info about machines that respond to SMB

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ldb</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="ldb"><a name="ldb.3"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ldb<b>The Samba Project</b> &#8212; A light-weight database library</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">#include &lt;ldb.h&gt;</pre></div><div class="refsect1" title="description"><a name="id2528860"></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.74.0"></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="id2522914"></a><h2>description</h2><p>
    22ldb is a light weight embedded database library and API. With a
    33programming interface that is very similar to LDAP, ldb can store its
    … …  
    3535database. Then I suggest you look at the ldb_connect(3) and
    3636ldb_search(3) manual pages.
    37         </p></div><div class="refsect1" title="TOOLS"><a name="id2528917"></a><h2>TOOLS</h2><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     37        </p></div><div class="refsect1" lang="en"><a name="id2483339"></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
    40                 </p></li><li class="listitem"><p>
     40                </p></li><li><p>
    4141                        <span class="application">ldbedit(1)</span>
    4242                         - edit all or part of a ldb database using your favourite editor
    43                 </p></li><li class="listitem"><p>
     43                </p></li><li><p>
    4444                        <span class="application">ldbadd(1)</span>
    4545                         - add records to a ldb database using LDIF formatted input
    46                 </p></li><li class="listitem"><p>
     46                </p></li><li><p>
    4747                        <span class="application">ldbdel(1)</span>
    4848                         - delete records from a ldb database
    49                 </p></li><li class="listitem"><p>
     49                </p></li><li><p>
    5050                        <span class="application">ldbmodify(1)</span>
    5151                         - modify records in a ldb database using LDIF formatted input
    52                 </p></li></ul></div></div><div class="refsect1" title="FUNCTIONS"><a name="id2489670"></a><h2>FUNCTIONS</h2><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     52                </p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2483525"></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
    55                 </p></li><li class="listitem"><p>
     55                </p></li><li><p>
    5656                        <code class="function">ldb_search(3)</code>
    5757                         - perform a database search
    58                 </p></li><li class="listitem"><p>
     58                </p></li><li><p>
    5959                        <code class="function">ldb_add(3)</code>
    6060                         - add a record to the database
    61                 </p></li><li class="listitem"><p>
     61                </p></li><li><p>
    6262                        <code class="function">ldb_delete(3)</code>
    6363                         - delete a record from the database
    64                 </p></li><li class="listitem"><p>
     64                </p></li><li><p>
    6565                        <code class="function">ldb_modify(3)</code>
    6666                         - modify a record in the database
    67                 </p></li><li class="listitem"><p>
     67                </p></li><li><p>
    6868                        <code class="function">ldb_errstring(3)</code>
    6969                         - retrieve extended error information from the last operation
    70                 </p></li><li class="listitem"><p>
     70                </p></li><li><p>
    7171                        <code class="function">ldb_ldif_write(3)</code>
    7272                         - write a LDIF formatted message
    73                 </p></li><li class="listitem"><p>
     73                </p></li><li><p>
    7474                        <code class="function">ldb_ldif_write_file(3)</code>
    7575                         - write a LDIF formatted message to a file
    76                 </p></li><li class="listitem"><p>
     76                </p></li><li><p>
    7777                        <code class="function">ldb_ldif_read(3)</code>
    7878                         - read a LDIF formatted message
    79                 </p></li><li class="listitem"><p>
     79                </p></li><li><p>
    8080                        <code class="function">ldb_ldif_read_free(3)</code>
    8181                         - free the result of a ldb_ldif_read()
    82                 </p></li><li class="listitem"><p>
     82                </p></li><li><p>
    8383                        <code class="function">ldb_ldif_read_file(3)</code>
    8484                         - read a LDIF message from a file
    85                 </p></li><li class="listitem"><p>
     85                </p></li><li><p>
    8686                        <code class="function">ldb_ldif_read_string(3)</code>
    8787                         - read a LDIF message from a string
    88                 </p></li><li class="listitem"><p>
     88                </p></li><li><p>
    8989                        <code class="function">ldb_msg_find_element(3)</code>
    9090                         - find an element in a ldb_message
    91                 </p></li><li class="listitem"><p>
     91                </p></li><li><p>
    9292                        <code class="function">ldb_val_equal_exact(3)</code>
    9393                         - compare two ldb_val structures
    94                 </p></li><li class="listitem"><p>
     94                </p></li><li><p>
    9595                        <code class="function">ldb_msg_find_val(3)</code>
    9696                         - find an element by value
    97                 </p></li><li class="listitem"><p>
     97                </p></li><li><p>
    9898                        <code class="function">ldb_msg_add_empty(3)</code>
    9999                         - add an empty message element to a ldb_message
    100                 </p></li><li class="listitem"><p>
     100                </p></li><li><p>
    101101                        <code class="function">ldb_msg_add(3)</code>
    102102                         - add a non-empty message element to a ldb_message
    103                 </p></li><li class="listitem"><p>
     103                </p></li><li><p>
    104104                        <code class="function">ldb_msg_element_compare(3)</code>
    105105                         - compare two ldb_message_element structures
    106                 </p></li><li class="listitem"><p>
     106                </p></li><li><p>
    107107                        <code class="function">ldb_msg_find_int(3)</code>
    108108                         - return an integer value from a ldb_message
    109                 </p></li><li class="listitem"><p>
     109                </p></li><li><p>
    110110                        <code class="function">ldb_msg_find_uint(3)</code>
    111111                         - return an unsigned integer value from a ldb_message
    112                 </p></li><li class="listitem"><p>
     112                </p></li><li><p>
    113113                        <code class="function">ldb_msg_find_double(3)</code>
    114114                         - return a double value from a ldb_message
    115                 </p></li><li class="listitem"><p>
     115                </p></li><li><p>
    116116                        <code class="function">ldb_msg_find_string(3)</code>
    117117                         - return a string value from a ldb_message
    118                 </p></li><li class="listitem"><p>
     118                </p></li><li><p>
    119119                        <code class="function">ldb_set_alloc(3)</code>
    120120                         - set the memory allocation function to be used by ldb
    121                 </p></li><li class="listitem"><p>
     121                </p></li><li><p>
    122122                        <code class="function">ldb_set_debug(3)</code>
    123123                         - set a debug handler to be used by ldb
    124                 </p></li><li class="listitem"><p>
     124                </p></li><li><p>
    125125                        <code class="function">ldb_set_debug_stderr(3)</code>
    126126                         - set a debug handler for stderr output
    127                 </p></li></ul></div></div><div class="refsect1" title="Author"><a name="id2487457"></a><h2>Author</h2><p>
     127                </p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2481474"></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.3.x/docs/htmldocs/manpages/ldbadd.1.html

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

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ldbdel</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="ldbdel"><a name="ldbdel.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ldbdel &#8212; Command-line program for deleting LDB records</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">ldbdel</code> [-h] [-H LDB-URL] [dn] [...]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528893"></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.74.0"></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="id2522944"></a><h2>DESCRIPTION</h2><p>ldbdel deletes records from an ldb(7) database.
    22                It deletes the records identified by the dn's specified
    33                on the command-line. </p><p>ldbdel uses either the database that is specified with
    44                the -H option or the database specified by the LDB_URL environment
    5                 variable.</p></div><div class="refsect1" title="OPTIONS"><a name="id2528911"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h</span></dt><dd><p>
     5                variable.</p></div><div class="refsect1" lang="en"><a name="id2483328"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h</span></dt><dd><p>
    66                Show list of available options.</p></dd><dt><span class="term">-H &lt;ldb-url&gt;</span></dt><dd><p>
    77                                LDB URL to connect to. See ldb(7) for details.
    8                         </p></dd></dl></div></div><div class="refsect1" title="ENVIRONMENT"><a name="id2489633"></a><h2>ENVIRONMENT</h2><div class="variablelist"><dl><dt><span class="term">LDB_URL</span></dt><dd><p>LDB URL to connect to (can be overrided by using the
    9                                         -H command-line option.)</p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id2489654"></a><h2>VERSION</h2><p>This man page is correct for version 4.0 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2489665"></a><h2>SEE ALSO</h2><p>ldb(7), ldbmodify, ldbadd, ldif(5)</p></div><div class="refsect1" title="AUTHOR"><a name="id2489675"></a><h2>AUTHOR</h2><p> ldb was written by
     8                        </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483362"></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="id2483383"></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="id2483394"></a><h2>SEE ALSO</h2><p>ldb(7), ldbmodify, ldbadd, ldif(5)</p></div><div class="refsect1" lang="en"><a name="id2483529"></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.3.x/docs/htmldocs/manpages/ldbedit.1.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ldbedit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="ldbedit"><a name="ldbedit.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ldbedit &#8212; Edit LDB databases using your preferred editor</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">ldbedit</code> [-?] [--usage] [-s base|one|sub] [-b basedn] [-a] [-e editor] [-H LDB-URL] [expression] [attributes...]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2489335"></a><h2>DESCRIPTION</h2><p>ldbedit is a utility that allows you to edit LDB entries (in
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ldbedit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="ldbedit.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ldbedit &#8212; Edit LDB databases using your preferred editor</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">ldbedit</code> [-?] [--usage] [-s base|one|sub] [-b basedn] [-a] [-e editor] [-H LDB-URL] [expression] [attributes...]</p></div></div><div class="refsect1" lang="en"><a name="id2483352"></a><h2>DESCRIPTION</h2><p>ldbedit is a utility that allows you to edit LDB entries (in
    22            tdb files, sqlite files or LDAP servers) using your preferred editor.
    33            ldbedit generates an LDIF file based on your query, allows you to edit
    44            the LDIF, and then merges that LDIF back into the LDB backend.
    5         </p></div><div class="refsect1" title="OPTIONS"><a name="id2489350"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-?, </span><span class="term">--help</span></dt><dd><p>
     5        </p></div><div class="refsect1" lang="en"><a name="id2483367"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-?, </span><span class="term">--help</span></dt><dd><p>
    66                        Show list of available options, and a phrase describing what that option
    77                        does.
    … …  
    3535                        this option, ldbedit will only provide a
    3636                        summary change line.
    37                     </p></dd></dl></div></div><div class="refsect1" title="ENVIRONMENT"><a name="id2489634"></a><h2>ENVIRONMENT</h2><div class="variablelist"><dl><dt><span class="term">LDB_URL</span></dt><dd><p>LDB URL to connect to. This can be
     37                    </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483651"></a><h2>ENVIRONMENT</h2><div class="variablelist"><dl><dt><span class="term">LDB_URL</span></dt><dd><p>LDB URL to connect to. This can be
    3838                    overridden by using the -H command-line option.)
    3939                    </p></dd><dt><span class="term">VISUAL and EDITOR</span></dt><dd><p>
    … …  
    4242                        EDITOR, and both are overridden by the
    4343                        -e command-line option.
    44                     </p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id2489675"></a><h2>VERSION</h2><p>This man page is correct for version 4.0 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2489686"></a><h2>SEE ALSO</h2><p>ldb(7), ldbmodify(1), ldbdel(1), ldif(5), vi(1)</p></div><div class="refsect1" title="AUTHOR"><a name="id2489697"></a><h2>AUTHOR</h2><p>
     44                    </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483692"></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="id2483703"></a><h2>SEE ALSO</h2><p>ldb(7), ldbmodify(1), ldbdel(1), ldif(5), vi(1)</p></div><div class="refsect1" lang="en"><a name="id2483714"></a><h2>AUTHOR</h2><p>
    4545            ldb was written by
    4646            <a class="ulink" href="http://samba.org/~tridge/" target="_top">Andrew Tridgell</a>.

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

    r368 r411  
    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.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="ldbmodify"><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" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">ldbmodify</code> [-H LDB-URL] [ldif-file]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528912"></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.74.0"></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="id2522930"></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" title="OPTIONS"><a name="id2528930"></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="id2522949"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-H &lt;ldb-url&gt;</span></dt><dd><p>
    66                                LDB URL to connect to. See ldb(7) for details.
    7                         </p></dd></dl></div></div><div class="refsect1" title="ENVIRONMENT"><a name="id2489320"></a><h2>ENVIRONMENT</h2><div class="variablelist"><dl><dt><span class="term">LDB_URL</span></dt><dd><p>LDB URL to connect to (can be overrided by using the
    8                                         -H command-line option.)</p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id2489342"></a><h2>VERSION</h2><p>This man page is correct for version 4.0 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2489353"></a><h2>SEE ALSO</h2><p>ldb(7), ldbedit</p></div><div class="refsect1" title="AUTHOR"><a name="id2489363"></a><h2>AUTHOR</h2><p> ldb was written by
     7                        </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483337"></a><h2>ENVIRONMENT</h2><div class="variablelist"><dl><dt><span class="term">LDB_URL</span></dt><dd><p>LDB URL to connect to (can be overrided by using the
     8                                        -H command-line option.)</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483359"></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="id2483370"></a><h2>SEE ALSO</h2><p>ldb(7), ldbedit</p></div><div class="refsect1" lang="en"><a name="id2483380"></a><h2>AUTHOR</h2><p> ldb was written by
    99                 <a class="ulink" href="http://samba.org/~tridge/" target="_top">Andrew Tridgell</a>.
    1010        </p><p>

  • branches/samba-3.3.x/docs/htmldocs/manpages/ldbrename.1.html

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

  • branches/samba-3.3.x/docs/htmldocs/manpages/ldbsearch.1.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ldbsearch</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="ldbsearch"><a name="ldbsearch.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ldbsearch &#8212; Search for records in a LDB database</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">ldbsearch</code> [-h] [-s base|one|sub] [-b basedn] [-i] [-H LDB-URL] [expression] [attributes]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2489322"></a><h2>DESCRIPTION</h2><p>ldbsearch searches a LDB database for records matching the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ldbsearch</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="ldbsearch.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ldbsearch &#8212; Search for records in a LDB database</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">ldbsearch</code> [-h] [-s base|one|sub] [-b basedn] [-i] [-H LDB-URL] [expression] [attributes]</p></div></div><div class="refsect1" lang="en"><a name="id2483339"></a><h2>DESCRIPTION</h2><p>ldbsearch searches a LDB database for records matching the
    22                specified expression (see the ldapsearch(1) manpage for
    33                a description of the expression format). For each
    44                record, the specified attributes are printed.
    5         </p></div><div class="refsect1" title="OPTIONS"><a name="id2489336"></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="id2483353"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h</span></dt><dd><p>
    66                Show list of available options.</p></dd><dt><span class="term">-H &lt;ldb-url&gt;</span></dt><dd><p>
    77                                LDB URL to connect to. See ldb(7) for details.
    8                         </p></dd><dt><span class="term">-s one|sub|base</span></dt><dd><p>Search scope to use. One-level, subtree or base.</p></dd><dt><span class="term">-i</span></dt><dd><p>Read search expressions from stdin. </p></dd><dt><span class="term">-b basedn</span></dt><dd><p>Specify Base DN to use.</p></dd></dl></div></div><div class="refsect1" title="ENVIRONMENT"><a name="id2489527"></a><h2>ENVIRONMENT</h2><div class="variablelist"><dl><dt><span class="term">LDB_URL</span></dt><dd><p>LDB URL to connect to (can be overrided by using the
    9                                         -H command-line option.)</p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id2489548"></a><h2>VERSION</h2><p>This man page is correct for version 4.0 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2489560"></a><h2>SEE ALSO</h2><p>ldb(7), ldbedit(1)</p></div><div class="refsect1" title="AUTHOR"><a name="id2489570"></a><h2>AUTHOR</h2><p> ldb was written by
     8                        </p></dd><dt><span class="term">-s one|sub|base</span></dt><dd><p>Search scope to use. One-level, subtree or base.</p></dd><dt><span class="term">-i</span></dt><dd><p>Read search expressions from stdin. </p></dd><dt><span class="term">-b basedn</span></dt><dd><p>Specify Base DN to use.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483544"></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="id2483565"></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="id2483576"></a><h2>SEE ALSO</h2><p>ldb(7), ldbedit(1)</p></div><div class="refsect1" lang="en"><a name="id2483586"></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.3.x/docs/htmldocs/manpages/libsmbclient.7.html

    r368 r411  
    1 <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.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="libsmbclient"><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" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><p>
     1<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.74.0"></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><p>
    22        Browser URL:
    33        <code class="literal">smb://[[[domain:]user[:password@]]server[/share[/path[/file]]]] [?options]
    44        </code>
    5         </p></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528909"></a><h2>DESCRIPTION</h2><p>
     5        </p></p></div></div><div class="refsect1" lang="en"><a name="id2522921"></a><h2>DESCRIPTION</h2><p>
    66        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.
    77        </p><p>
    … …  
    1515        extension of the capabilities of tools such as file managers and browsers.  This man page describes the
    1616        configuration options for this tool so that the user may obtain greatest utility of use.
    17         </p></div><div class="refsect1" title="OPTIONS"><a name="id2489316"></a><h2>OPTIONS</h2><p>
     17        </p></div><div class="refsect1" lang="en"><a name="id2483338"></a><h2>OPTIONS</h2><p>
    1818        What the URLs mean:
    1919        </p><div class="variablelist"><dl><dt><span class="term">smb://</span></dt><dd><p>
    … …  
    4747        parameter and will use its value when if the <code class="literal">user</code> parameter was not included
    4848        in the URL.
    49         </p></div><div class="refsect1" title="PROGRAMMERS GUIDE"><a name="id2489586"></a><h2>PROGRAMMERS GUIDE</h2><p>
     49        </p></div><div class="refsect1" lang="en"><a name="id2483602"></a><h2>PROGRAMMERS GUIDE</h2><p>
    5050        Watch this space for future updates.
    51         </p></div><div class="refsect1" title="VERSION"><a name="id2489597"></a><h2>VERSION</h2><p>
     51        </p></div><div class="refsect1" lang="en"><a name="id2483613"></a><h2>VERSION</h2><p>
    5252        This man page is correct for version 3 of the Samba suite.
    53         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489608"></a><h2>AUTHOR</h2><p>
     53        </p></div><div class="refsect1" lang="en"><a name="id2483624"></a><h2>AUTHOR</h2><p>
    5454        The original Samba software and related utilities were created by Andrew Tridgell.
    5555        Samba is now developed by the Samba Team as an Open Source project similar to the way

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

    r368 r411  
    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.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="lmhosts"><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" title="Synopsis"><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" title="DESCRIPTION"><a name="id2528903"></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.74.0"></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="id2522922"></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" title="FILE FORMAT"><a name="id2489309"></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="id2483326"></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
    8         in the lmhosts file contains the following information:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>IP Address - in dotted decimal format.</p></li><li class="listitem"><p>NetBIOS Name - This name format is a
     8        in the lmhosts file contains the following information:</p><div class="itemizedlist"><ul type="disc"><li><p>IP Address - in dotted decimal format.</p></li><li><p>NetBIOS Name - This name format is a
    99                maximum fifteen character host name, with an optional
    1010                trailing '#' character followed by the NetBIOS name type
    … …  
    2626        type for a name "NTSERVER" is queried. Any other name type will not
    2727        be resolved.</p><p>The default location of the <code class="filename">lmhosts</code> file
    28         is in the same directory as the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file.</p></div><div class="refsect1" title="FILES"><a name="id2489512"></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="id2483527"></a><h2>FILES</h2><p>lmhosts is loaded from the configuration directory. This is
    2929                usually <code class="filename">/etc/samba</code> or <code class="filename">/usr/local/samba/lib</code>.
    30         </p></div><div class="refsect1" title="VERSION"><a name="id2489534"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2489545"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>, <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>, and <a class="citerefentry" href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a>
    31         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489580"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     30        </p></div><div class="refsect1" lang="en"><a name="id2483550"></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="id2483561"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>, <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>, and <a class="citerefentry" href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a>
     31        </p></div><div class="refsect1" lang="en"><a name="id2483595"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    3232        were created by Andrew Tridgell. Samba is now developed
    3333        by the Samba Team as an Open Source project similar

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>log2pcap</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="log2pcap"><a name="log2pcap.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>log2pcap &#8212; Extract network traces from Samba log files</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">log2pcap</code> [-h] [-q] [logfile] [pcap_file]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528928"></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.74.0"></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="id2522947"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">log2pcap</code> reads in a
    22        samba log file and generates a pcap file (readable
    33        by most sniffers, such as ethereal or tcpdump) based on the packet
    … …  
    66        right, <code class="constant">10</code> to get the first 512 data bytes of the
    77        packet and <code class="constant">50</code> to get the whole packet.
    8         </p></div><div class="refsect1" title="OPTIONS"><a name="id2489347"></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="id2483364"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h</span></dt><dd><p>If this parameter is
    99                specified the output file will be a
    1010                hex dump, in a format that is readable
    … …  
    1818                to stdout.
    1919                </p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    20 </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id2489548"></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="id2483565"></a><h2>EXAMPLES</h2><p>Extract all network traffic from all samba log files:</p><pre class="programlisting">
    2121                        <code class="prompt">$</code> log2pcap &lt; /var/log/* &gt; trace.pcap
    2222        </pre><p>Convert to pcap using text2pcap:</p><pre class="programlisting">
    2323        <code class="prompt">$</code> log2pcap -h samba.log | text2pcap -T 139,139 - trace.pcap
    24         </pre></div><div class="refsect1" title="VERSION"><a name="id2489589"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="BUGS"><a name="id2489600"></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="id2483606"></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="id2483617"></a><h2>BUGS</h2><p>Only SMB data is extracted from the samba logs, no LDAP,
    2525        NetBIOS lookup or other data.</p><p>The generated TCP and IP headers don't contain a valid
    26         checksum.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2489616"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="text2pcap.1.html"><span class="citerefentry"><span class="refentrytitle">text2pcap</span>(1)</span></a>, <a class="citerefentry" href="ethereal.1.html"><span class="citerefentry"><span class="refentrytitle">ethereal</span>(1)</span></a></p></div><div class="refsect1" title="AUTHOR"><a name="id2489639"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     26        checksum.</p></div><div class="refsect1" lang="en"><a name="id2483633"></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="id2483656"></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.3.x/docs/htmldocs/manpages/mount.cifs.8.html

    r368 r411  
    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.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="mount.cifs"><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" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">mount.cifs</code> {service} {mount-point} [-o options]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528928"></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.74.0"></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="id2522940"></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
    … …  
    2424        </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
    2525                the mounted resource is unmounted (usually via the umount utility).
    26         </p></div><div class="refsect1" title="OPTIONS"><a name="id2489361"></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
     26        </p></div><div class="refsect1" lang="en"><a name="id2483382"></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
    2727                                this is not given, then the environment variable <span class="emphasis"><em>USER</em></span> is used. This option can also take the
    2828form "user%password" or "workgroup/user" or
    2929"workgroup/user%password" to allow the password and workgroup
    3030to be specified as part of the username.
    31                 </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
     31                </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
    3232        The cifs vfs accepts the parameter <em class="parameter"><code>user=</code></em>, or for users familiar with smbfs it accepts the longer form of the parameter <em class="parameter"><code>username=</code></em>.  Similarly the longer smbfs style parameter names may be accepted as synonyms for the shorter cifs parameters <em class="parameter"><code>pass=</code></em>,<em class="parameter"><code>dom=</code></em> and <em class="parameter"><code>cred=</code></em>.
    3333        </p></div></dd><dt><span class="term">password=<em class="replaceable"><code>arg</code></em></span></dt><dd><p>specifies the CIFS password. If this
    … …  
    167167                "noacl" on mount.</p></dd><dt><span class="term">nocase</span></dt><dd><p>Request case insensitive path name matching (case
    168168                sensitive is the default if the server suports it).
    169                 </p></dd><dt><span class="term">sec=</span></dt><dd><p>Security mode.  Allowed values are:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>none    attempt to connection as a null user (no name) </p></li><li class="listitem"><p>krb5    Use Kerberos version 5 authentication</p></li><li class="listitem"><p>krb5i   Use Kerberos authentication and packet signing</p></li><li class="listitem"><p>ntlm    Use NTLM password hashing (default)</p></li><li class="listitem"><p>ntlmi   Use NTLM password hashing with signing (if
     169                </p></dd><dt><span class="term">sec=</span></dt><dd><p>Security mode.  Allowed values are:</p><div class="itemizedlist"><ul type="disc"><li><p>none    attempt to connection as a null user (no name) </p></li><li><p>krb5    Use Kerberos version 5 authentication</p></li><li><p>krb5i   Use Kerberos authentication and packet signing</p></li><li><p>ntlm    Use NTLM password hashing (default)</p></li><li><p>ntlmi   Use NTLM password hashing with signing (if
    170170                                /proc/fs/cifs/PacketSigningEnabled on or if
    171                                 server requires signing also can be the default)</p></li><li class="listitem"><p>ntlmv2  Use NTLMv2 password hashing</p></li><li class="listitem"><p>ntlmv2i Use NTLMv2 password hashing with packet signing</p></li></ul></div><p>[NB This [sec parameter] is under development and expected to be available in cifs kernel module 1.40 and later]
     171                                server requires signing also can be the default)</p></li><li><p>ntlmv2  Use NTLMv2 password hashing</p></li><li><p>ntlmv2i Use NTLMv2 password hashing with packet signing</p></li></ul></div><p>[NB This [sec parameter] is under development and expected to be available in cifs kernel module 1.40 and later]
    172172                </p></dd><dt><span class="term">nobrl</span></dt><dd><p>Do not send byte range lock requests to the server.
    173173                This is necessary for certain applications that break
    … …  
    219219                </p></dd><dt><span class="term">wsize=<em class="replaceable"><code>arg</code></em></span></dt><dd><p>default network write size (default 57344)
    220220                maximum wsize currently allowed by CIFS is 57344 (fourteen
    221                 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" title="SERVICE FORMATTING AND DELIMITERS"><a name="id2487437"></a><h2>SERVICE FORMATTING AND DELIMITERS</h2><p>
     221                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="id2481455"></a><h2>SERVICE FORMATTING AND DELIMITERS</h2><p>
    222222                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.
    223223        </p><p>
    224224                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.
    225         </p></div><div class="refsect1" title="ENVIRONMENT VARIABLES"><a name="id2487878"></a><h2>ENVIRONMENT VARIABLES</h2><p>
     225        </p></div><div class="refsect1" lang="en"><a name="id2481896"></a><h2>ENVIRONMENT VARIABLES</h2><p>
    226226                The variable <span class="emphasis"><em>USER</em></span> may contain the username of the
    227227person to be used to authenticate to the server.
    … …  
    235235of a file to read the password from. A single line of input is
    236236read and used as the password.
    237         </p></div><div class="refsect1" title="NOTES"><a name="id2487912"></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" title="CONFIGURATION"><a name="id2487924"></a><h2>CONFIGURATION</h2><p>
     237        </p></div><div class="refsect1" lang="en"><a name="id2481931"></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="id2481943"></a><h2>CONFIGURATION</h2><p>
    238238The primary mechanism for making configuration changes and for reading
    239239debug information for the cifs vfs is via the Linux /proc filesystem.
    … …  
    246246installation (device driver load).
    247247For more information see the kernel file <code class="filename">fs/cifs/README</code>.
    248 </p></div><div class="refsect1" title="BUGS"><a name="id2487957"></a><h2>BUGS</h2><p>Mounting using the CIFS URL specification is currently not supported.
     248</p></div><div class="refsect1" lang="en"><a name="id2481976"></a><h2>BUGS</h2><p>Mounting using the CIFS URL specification is currently not supported.
    249249        </p><p>The credentials file does not handle usernames or passwords with
    250250                leading space.</p><p>
    … …  
    254254when reporting bugs (minimum: mount.cifs (try mount.cifs -V), kernel (see /proc/version) and
    255255server type you are trying to contact.
    256 </p></div><div class="refsect1" title="VERSION"><a name="id2487982"></a><h2>VERSION</h2><p>This man page is correct for version 1.52 of
    257         the cifs vfs filesystem (roughly Linux kernel 2.6.24).</p></div><div class="refsect1" title="SEE ALSO"><a name="id2487994"></a><h2>SEE ALSO</h2><p>
     256</p></div><div class="refsect1" lang="en"><a name="id2482001"></a><h2>VERSION</h2><p>This man page is correct for version 1.52 of
     257        the cifs vfs filesystem (roughly Linux kernel 2.6.24).</p></div><div class="refsect1" lang="en"><a name="id2482013"></a><h2>SEE ALSO</h2><p>
    258258        Documentation/filesystems/cifs.txt and fs/cifs/README in the linux kernel
    259259        source tree may contain additional options and information.
    260 </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" title="AUTHOR"><a name="id2488015"></a><h2>AUTHOR</h2><p>Steve French</p><p>The syntax and manpage were loosely based on that of smbmount. It
     260</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="id2482034"></a><h2>AUTHOR</h2><p>Steve French</p><p>The syntax and manpage were loosely based on that of smbmount. It
    261261                was converted to Docbook/XML by Jelmer Vernooij.</p><p>The maintainer of the Linux cifs vfs and the userspace
    262262                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.3.x/docs/htmldocs/manpages/net.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>net</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="net"><a name="net.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>net &#8212; Tool for administration of Samba and remote
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>net</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="net.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>net &#8212; Tool for administration of Samba and remote
    22        CIFS servers.
    3         </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">net</code> {&lt;ads|rap|rpc&gt;} [-h] [-w workgroup] [-W myworkgroup] [-U user] [-I ip-address] [-p port] [-n myname] [-s conffile] [-S server] [-l] [-P] [-d debuglevel] [-V] [--request-timeout seconds]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2489664"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The Samba net utility is meant to work just like the net utility
     3        </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">net</code> {&lt;ads|rap|rpc&gt;} [-h] [-w workgroup] [-W myworkgroup] [-U user] [-I ip-address] [-p port] [-n myname] [-s conffile] [-S server] [-l] [-P] [-d debuglevel] [-V] [--request-timeout seconds]</p></div></div><div class="refsect1" lang="en"><a name="id2483395"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The Samba net utility is meant to work just like the net utility
    44        available for windows and DOS. The first argument should be used
    55        to specify the protocol to use when executing a certain command.
    … …  
    88        argument is omitted, net will try to determine it automatically.
    99        Not all commands are available on all protocols.
    10         </p></div><div class="refsect1" title="OPTIONS"><a name="id2489693"></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="id2483548"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    1111</p></dd><dt><span class="term">-w target-workgroup</span></dt><dd><p>
    1212                Sets target workgroup or domain. You have to specify
    … …  
    5858data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
    5959override the <a class="link" href="smb.conf.5.html#" target="_top"></a> parameter
    60 in the <code class="filename">smb.conf</code> file.</p></dd></dl></div></div><div class="refsect1" title="COMMANDS"><a name="id2487548"></a><h2>COMMANDS</h2><div class="refsect2" title="CHANGESECRETPW"><a name="id2487554"></a><h3>CHANGESECRETPW</h3><p>This command allows the Samba machine account password to be set from an external application
     60in the <code class="filename">smb.conf</code> file.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481567"></a><h2>COMMANDS</h2><div class="refsect2" lang="en"><a name="id2481572"></a><h3>CHANGESECRETPW</h3><p>This command allows the Samba machine account password to be set from an external application
    6161to a machine account password that has already been stored in Active Directory. DO NOT USE this command
    6262unless you know exactly what you are doing. The use of this command requires that the force flag (-f)
    … …  
    6565this without care and attention as it will overwrite a legitimate machine password without warning.
    6666YOU HAVE BEEN WARNED.
    67 </p></div><div class="refsect2" title="TIME"><a name="id2487574"></a><h3>TIME</h3><p>The <code class="literal">NET TIME</code> command allows you to view the time on a remote server
    68         or synchronise the time on the local server with the time on the remote server.</p><div class="refsect3" title="TIME"><a name="id2487592"></a><h4>TIME</h4><p>Without any options, the <code class="literal">NET TIME</code> command
     67</p></div><div class="refsect2" lang="en"><a name="id2481593"></a><h3>TIME</h3><p>The <code class="literal">NET TIME</code> command allows you to view the time on a remote server
     68        or synchronise the time on the local server with the time on the remote server.</p><div class="refsect3" lang="en"><a name="id2481610"></a><h4>TIME</h4><p>Without any options, the <code class="literal">NET TIME</code> command
    6969displays the time on the remote server.
    70 </p></div><div class="refsect3" title="TIME SYSTEM"><a name="id2487608"></a><h4>TIME SYSTEM</h4><p>Displays the time on the remote server in a format ready for <code class="literal">/bin/date</code>.</p></div><div class="refsect3" title="TIME SET"><a name="id2487625"></a><h4>TIME SET</h4><p>Tries to set the date and time of the local server to that on
    71 the remote server using <code class="literal">/bin/date</code>. </p></div><div class="refsect3" title="TIME ZONE"><a name="id2487643"></a><h4>TIME ZONE</h4><p>Displays the timezone in hours from GMT on the remote computer.</p></div></div><div class="refsect2" title="[RPC|ADS] JOIN [TYPE] [-U username[%password]] [createupn=UPN] [createcomputer=OU] [options]"><a name="id2487655"></a><h3>[RPC|ADS] JOIN [TYPE] [-U username[%password]] [createupn=UPN] [createcomputer=OU] [options]</h3><p>
     70</p></div><div class="refsect3" lang="en"><a name="id2481627"></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="id2481644"></a><h4>TIME SET</h4><p>Tries to set the date and time of the local server to that on
     71the remote server using <code class="literal">/bin/date</code>. </p></div><div class="refsect3" lang="en"><a name="id2481661"></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="id2481673"></a><h3>[RPC|ADS] JOIN [TYPE] [-U username[%password]] [createupn=UPN] [createcomputer=OU] [options]</h3><p>
    7272Join a domain.  If the account already exists on the server, and
    7373[TYPE] is MEMBER, the machine will attempt to join automatically.
    … …  
    8686and ldap, so it may need to be doubled or quadrupled to pass through,
    8787and it is not used as a delimiter.
    88 </p></div><div class="refsect2" title="[RPC] OLDJOIN [options]"><a name="id2487689"></a><h3>[RPC] OLDJOIN [options]</h3><p>Join a domain. Use the OLDJOIN option to join the domain
     88</p></div><div class="refsect2" lang="en"><a name="id2481708"></a><h3>[RPC] OLDJOIN [options]</h3><p>Join a domain. Use the OLDJOIN option to join the domain
    8989using the old style of domain joining - you need to create a trust
    90 account in server manager first.</p></div><div class="refsect2" title="[RPC|ADS] USER"><a name="id2487702"></a><h3>[RPC|ADS] USER</h3><div class="refsect3" title="[RPC|ADS] USER"><a name="id2487707"></a><h4>[RPC|ADS] USER</h4><p>List all users</p></div><div class="refsect3" title="[RPC|ADS] USER DELETE target"><a name="id2487718"></a><h4>[RPC|ADS] USER DELETE <em class="replaceable"><code>target</code></em></h4><p>Delete specified user</p></div><div class="refsect3" title="[RPC|ADS] USER INFO target"><a name="id2487730"></a><h4>[RPC|ADS] USER INFO <em class="replaceable"><code>target</code></em></h4><p>List the domain groups of the specified user.</p></div><div class="refsect3" title="[RPC|ADS] USER RENAME oldname newname"><a name="id2487743"></a><h4>[RPC|ADS] USER RENAME <em class="replaceable"><code>oldname</code></em> <em class="replaceable"><code>newname</code></em></h4><p>Rename specified user.</p></div><div class="refsect3" title="[RPC|ADS] USER ADD name [password] [-F user flags] [-C comment]"><a name="id2487758"></a><h4>[RPC|ADS] USER ADD <em class="replaceable"><code>name</code></em> [password] [-F user flags] [-C comment]</h4><p>Add specified user.</p></div></div><div class="refsect2" title="[RPC|ADS] GROUP"><a name="id2487773"></a><h3>[RPC|ADS] GROUP</h3><div class="refsect3" title="[RPC|ADS] GROUP [misc options] [targets]"><a name="id2487779"></a><h4>[RPC|ADS] GROUP [misc options] [targets]</h4><p>List user groups.</p></div><div class="refsect3" title="[RPC|ADS] GROUP DELETE name [misc. options]"><a name="id2487790"></a><h4>[RPC|ADS] GROUP DELETE <em class="replaceable"><code>name</code></em> [misc. options]</h4><p>Delete specified group.</p></div><div class="refsect3" title="[RPC|ADS] GROUP ADD name [-C comment]"><a name="id2487803"></a><h4>[RPC|ADS] GROUP ADD <em class="replaceable"><code>name</code></em> [-C comment]</h4><p>Create specified group.</p></div></div><div class="refsect2" title="[RAP|RPC] SHARE"><a name="id2487818"></a><h3>[RAP|RPC] SHARE</h3><div class="refsect3" title="[RAP|RPC] SHARE [misc. options] [targets]"><a name="id2487823"></a><h4>[RAP|RPC] SHARE [misc. options] [targets]</h4><p>Enumerates all exported resources (network shares) on target server.</p></div><div class="refsect3" title="[RAP|RPC] SHARE ADD name=serverpath [-C comment] [-M maxusers] [targets]"><a name="id2487835"></a><h4>[RAP|RPC] SHARE ADD <em class="replaceable"><code>name=serverpath</code></em> [-C comment] [-M maxusers] [targets]</h4><p>Adds a share from a server (makes the export active). Maxusers
     90account in server manager first.</p></div><div class="refsect2" lang="en"><a name="id2481720"></a><h3>[RPC|ADS] USER</h3><div class="refsect3" lang="en"><a name="id2481726"></a><h4>[RPC|ADS] USER</h4><p>List all users</p></div><div class="refsect3" lang="en"><a name="id2481736"></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="id2481748"></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="id2481761"></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="id2481777"></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="id2481792"></a><h3>[RPC|ADS] GROUP</h3><div class="refsect3" lang="en"><a name="id2481797"></a><h4>[RPC|ADS] GROUP [misc options] [targets]</h4><p>List user groups.</p></div><div class="refsect3" lang="en"><a name="id2481808"></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="id2481822"></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="id2481836"></a><h3>[RAP|RPC] SHARE</h3><div class="refsect3" lang="en"><a name="id2481842"></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="id2481854"></a><h4>[RAP|RPC] SHARE ADD <em class="replaceable"><code>name=serverpath</code></em> [-C comment] [-M maxusers] [targets]</h4><p>Adds a share from a server (makes the export active). Maxusers
    9191specifies the number of users that can be connected to the
    92 share simultaneously.</p></div><div class="refsect3" title="SHARE DELETE sharename"><a name="id2487852"></a><h4>SHARE DELETE <em class="replaceable"><code>sharename</code></em></h4><p>Delete specified share.</p></div></div><div class="refsect2" title="[RPC|RAP] FILE"><a name="id2487865"></a><h3>[RPC|RAP] FILE</h3><div class="refsect3" title="[RPC|RAP] FILE"><a name="id2487871"></a><h4>[RPC|RAP] FILE</h4><p>List all open files on remote server.</p></div><div class="refsect3" title="[RPC|RAP] FILE CLOSE fileid"><a name="id2487882"></a><h4>[RPC|RAP] FILE CLOSE <em class="replaceable"><code>fileid</code></em></h4><p>Close file with specified <em class="replaceable"><code>fileid</code></em> on
    93 remote server.</p></div><div class="refsect3" title="[RPC|RAP] FILE INFO fileid"><a name="id2487898"></a><h4>[RPC|RAP] FILE INFO <em class="replaceable"><code>fileid</code></em></h4><p>
     92share simultaneously.</p></div><div class="refsect3" lang="en"><a name="id2481870"></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="id2481884"></a><h3>[RPC|RAP] FILE</h3><div class="refsect3" lang="en"><a name="id2481889"></a><h4>[RPC|RAP] FILE</h4><p>List all open files on remote server.</p></div><div class="refsect3" lang="en"><a name="id2481900"></a><h4>[RPC|RAP] FILE CLOSE <em class="replaceable"><code>fileid</code></em></h4><p>Close file with specified <em class="replaceable"><code>fileid</code></em> on
     93remote server.</p></div><div class="refsect3" lang="en"><a name="id2481916"></a><h4>[RPC|RAP] FILE INFO <em class="replaceable"><code>fileid</code></em></h4><p>
    9494Print information on specified <em class="replaceable"><code>fileid</code></em>.
    9595Currently listed are: file-id, username, locks, path, permissions.
    96 </p></div><div class="refsect3" title="[RAP|RPC] FILE USER user"><a name="id2487914"></a><h4>[RAP|RPC] FILE USER <em class="replaceable"><code>user</code></em></h4><p>
     96</p></div><div class="refsect3" lang="en"><a name="id2481933"></a><h4>[RAP|RPC] FILE USER <em class="replaceable"><code>user</code></em></h4><p>
    9797List files opened by specified <em class="replaceable"><code>user</code></em>.
    9898Please note that <code class="literal">net rap file user</code> does not work
    9999against Samba servers.
    100 </p></div></div><div class="refsect2" title="SESSION"><a name="id2487938"></a><h3>SESSION</h3><div class="refsect3" title="RAP SESSION"><a name="id2487944"></a><h4>RAP SESSION</h4><p>Without any other options, SESSION enumerates all active SMB/CIFS
    101 sessions on the target server.</p></div><div class="refsect3" title="RAP SESSION DELETE|CLOSE CLIENT_NAME"><a name="id2487955"></a><h4>RAP SESSION DELETE|CLOSE <em class="replaceable"><code>CLIENT_NAME</code></em></h4><p>Close the specified sessions.</p></div><div class="refsect3" title="RAP SESSION INFO CLIENT_NAME"><a name="id2487967"></a><h4>RAP SESSION INFO <em class="replaceable"><code>CLIENT_NAME</code></em></h4><p>Give a list with all the open files in specified session.</p></div></div><div class="refsect2" title="RAP SERVER DOMAIN"><a name="id2487982"></a><h3>RAP SERVER <em class="replaceable"><code>DOMAIN</code></em></h3><p>List all servers in specified domain or workgroup. Defaults
    102 to local domain.</p></div><div class="refsect2" title="RAP DOMAIN"><a name="id2487995"></a><h3>RAP DOMAIN</h3><p>Lists all domains and workgroups visible on the
    103 current network.</p></div><div class="refsect2" title="RAP PRINTQ"><a name="id2488006"></a><h3>RAP PRINTQ</h3><div class="refsect3" title="RAP PRINTQ INFO QUEUE_NAME"><a name="id2488012"></a><h4>RAP PRINTQ INFO <em class="replaceable"><code>QUEUE_NAME</code></em></h4><p>Lists the specified print queue and print jobs on the server.
     100</p></div></div><div class="refsect2" lang="en"><a name="id2481956"></a><h3>SESSION</h3><div class="refsect3" lang="en"><a name="id2481962"></a><h4>RAP SESSION</h4><p>Without any other options, SESSION enumerates all active SMB/CIFS
     101sessions on the target server.</p></div><div class="refsect3" lang="en"><a name="id2481974"></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="id2481986"></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="id2482000"></a><h3>RAP SERVER <em class="replaceable"><code>DOMAIN</code></em></h3><p>List all servers in specified domain or workgroup. Defaults
     102to local domain.</p></div><div class="refsect2" lang="en"><a name="id2482014"></a><h3>RAP DOMAIN</h3><p>Lists all domains and workgroups visible on the
     103current network.</p></div><div class="refsect2" lang="en"><a name="id2482025"></a><h3>RAP PRINTQ</h3><div class="refsect3" lang="en"><a name="id2482031"></a><h4>RAP PRINTQ INFO <em class="replaceable"><code>QUEUE_NAME</code></em></h4><p>Lists the specified print queue and print jobs on the server.
    104104If the <em class="replaceable"><code>QUEUE_NAME</code></em> is omitted, all
    105 queues are listed.</p></div><div class="refsect3" title="RAP PRINTQ DELETE JOBID"><a name="id2538499"></a><h4>RAP PRINTQ DELETE <em class="replaceable"><code>JOBID</code></em></h4><p>Delete job with specified id.</p></div></div><div class="refsect2" title="RAP VALIDATE user [password]"><a name="id2538512"></a><h3>RAP VALIDATE <em class="replaceable"><code>user</code></em> [<em class="replaceable"><code>password</code></em>]</h3><p>
     105queues are listed.</p></div><div class="refsect3" lang="en"><a name="id2532513"></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="id2532525"></a><h3>RAP VALIDATE <em class="replaceable"><code>user</code></em> [<em class="replaceable"><code>password</code></em>]</h3><p>
    106106Validate whether the specified user can log in to the
    107107remote server. If the password is not specified on the commandline, it
    108108will be prompted.
    109 </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div><div class="refsect2" title="RAP GROUPMEMBER"><a name="id2538534"></a><h3>RAP GROUPMEMBER</h3><div class="refsect3" title="RAP GROUPMEMBER LIST GROUP"><a name="id2538540"></a><h4>RAP GROUPMEMBER LIST <em class="replaceable"><code>GROUP</code></em></h4><p>List all members of the specified group.</p></div><div class="refsect3" title="RAP GROUPMEMBER DELETE GROUP USER"><a name="id2538552"></a><h4>RAP GROUPMEMBER DELETE <em class="replaceable"><code>GROUP</code></em> <em class="replaceable"><code>USER</code></em></h4><p>Delete member from group.</p></div><div class="refsect3" title="RAP GROUPMEMBER ADD GROUP USER"><a name="id2538567"></a><h4>RAP GROUPMEMBER ADD <em class="replaceable"><code>GROUP</code></em> <em class="replaceable"><code>USER</code></em></h4><p>Add member to group.</p></div></div><div class="refsect2" title="RAP ADMIN command"><a name="id2538583"></a><h3>RAP ADMIN <em class="replaceable"><code>command</code></em></h3><p>Execute the specified <em class="replaceable"><code>command</code></em> on
     109</p><div class="note" 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="id2532548"></a><h3>RAP GROUPMEMBER</h3><div class="refsect3" lang="en"><a name="id2532554"></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="id2532566"></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="id2532581"></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="id2532597"></a><h3>RAP ADMIN <em class="replaceable"><code>command</code></em></h3><p>Execute the specified <em class="replaceable"><code>command</code></em> on
    110110the remote server. Only works with OS/2 servers.
    111 </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div><div class="refsect2" title="RAP SERVICE"><a name="id2538604"></a><h3>RAP SERVICE</h3><div class="refsect3" title="RAP SERVICE START NAME [arguments...]"><a name="id2538609"></a><h4>RAP SERVICE START <em class="replaceable"><code>NAME</code></em> [arguments...]</h4><p>Start the specified service on the remote server. Not implemented yet.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div><div class="refsect3" title="RAP SERVICE STOP"><a name="id2538627"></a><h4>RAP SERVICE STOP</h4><p>Stop the specified service on the remote server.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div></div><div class="refsect2" title="RAP PASSWORD USER OLDPASS NEWPASS"><a name="id2538643"></a><h3>RAP PASSWORD <em class="replaceable"><code>USER</code></em> <em class="replaceable"><code>OLDPASS</code></em> <em class="replaceable"><code>NEWPASS</code></em></h3><p>
     111</p><div class="note" 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="id2532617"></a><h3>RAP SERVICE</h3><div class="refsect3" lang="en"><a name="id2532623"></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="id2532641"></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="id2532657"></a><h3>RAP PASSWORD <em class="replaceable"><code>USER</code></em> <em class="replaceable"><code>OLDPASS</code></em> <em class="replaceable"><code>NEWPASS</code></em></h3><p>
    112112Change password of <em class="replaceable"><code>USER</code></em> from <em class="replaceable"><code>OLDPASS</code></em> to <em class="replaceable"><code>NEWPASS</code></em>.
    113 </p></div><div class="refsect2" title="LOOKUP"><a name="id2538671"></a><h3>LOOKUP</h3><div class="refsect3" title="LOOKUP HOST HOSTNAME [TYPE]"><a name="id2538676"></a><h4>LOOKUP HOST <em class="replaceable"><code>HOSTNAME</code></em> [<em class="replaceable"><code>TYPE</code></em>]</h4><p>
     113</p></div><div class="refsect2" lang="en"><a name="id2532685"></a><h3>LOOKUP</h3><div class="refsect3" lang="en"><a name="id2532690"></a><h4>LOOKUP HOST <em class="replaceable"><code>HOSTNAME</code></em> [<em class="replaceable"><code>TYPE</code></em>]</h4><p>
    114114Lookup the IP address of the given host with the specified type (netbios suffix).
    115115The type defaults to 0x20 (workstation).
    116 </p></div><div class="refsect3" title="LOOKUP LDAP [DOMAIN]"><a name="id2538694"></a><h4>LOOKUP LDAP [<em class="replaceable"><code>DOMAIN</code></em>]</h4><p>Give IP address of LDAP server of specified <em class="replaceable"><code>DOMAIN</code></em>. Defaults to local domain.</p></div><div class="refsect3" title="LOOKUP KDC [REALM]"><a name="id2538711"></a><h4>LOOKUP KDC [<em class="replaceable"><code>REALM</code></em>]</h4><p>Give IP address of KDC for the specified <em class="replaceable"><code>REALM</code></em>.
    117 Defaults to local realm.</p></div><div class="refsect3" title="LOOKUP DC [DOMAIN]"><a name="id2538728"></a><h4>LOOKUP DC [<em class="replaceable"><code>DOMAIN</code></em>]</h4><p>Give IP's of Domain Controllers for specified <em class="replaceable"><code>
    118 DOMAIN</code></em>. Defaults to local domain.</p></div><div class="refsect3" title="LOOKUP MASTER DOMAIN"><a name="id2538745"></a><h4>LOOKUP MASTER <em class="replaceable"><code>DOMAIN</code></em></h4><p>Give IP of master browser for specified <em class="replaceable"><code>DOMAIN</code></em>
    119 or workgroup. Defaults to local domain.</p></div></div><div class="refsect2" title="CACHE"><a name="id2538763"></a><h3>CACHE</h3><p>Samba uses a general caching interface called 'gencache'. It
     116</p></div><div class="refsect3" lang="en"><a name="id2532708"></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="id2532725"></a><h4>LOOKUP KDC [<em class="replaceable"><code>REALM</code></em>]</h4><p>Give IP address of KDC for the specified <em class="replaceable"><code>REALM</code></em>.
     117Defaults to local realm.</p></div><div class="refsect3" lang="en"><a name="id2532742"></a><h4>LOOKUP DC [<em class="replaceable"><code>DOMAIN</code></em>]</h4><p>Give IP's of Domain Controllers for specified <em class="replaceable"><code>
     118DOMAIN</code></em>. Defaults to local domain.</p></div><div class="refsect3" lang="en"><a name="id2532759"></a><h4>LOOKUP MASTER <em class="replaceable"><code>DOMAIN</code></em></h4><p>Give IP of master browser for specified <em class="replaceable"><code>DOMAIN</code></em>
     119or workgroup. Defaults to local domain.</p></div></div><div class="refsect2" lang="en"><a name="id2532776"></a><h3>CACHE</h3><p>Samba uses a general caching interface called 'gencache'. It
    120120can be controlled using 'NET CACHE'.</p><p>All the timeout parameters support the suffixes:
    121121
    122 </p><table border="0" summary="Simple list" class="simplelist"><tr><td>s - Seconds</td></tr><tr><td>m - Minutes</td></tr><tr><td>h - Hours</td></tr><tr><td>d - Days</td></tr><tr><td>w - Weeks</td></tr></table><p>
    123 
    124 </p><div class="refsect3" title="CACHE ADD key data time-out"><a name="id2538798"></a><h4>CACHE ADD <em class="replaceable"><code>key</code></em> <em class="replaceable"><code>data</code></em> <em class="replaceable"><code>time-out</code></em></h4><p>Add specified key+data to the cache with the given timeout.</p></div><div class="refsect3" title="CACHE DEL key"><a name="id2538818"></a><h4>CACHE DEL <em class="replaceable"><code>key</code></em></h4><p>Delete key from the cache.</p></div><div class="refsect3" title="CACHE SET key data time-out"><a name="id2538829"></a><h4>CACHE SET <em class="replaceable"><code>key</code></em> <em class="replaceable"><code>data</code></em> <em class="replaceable"><code>time-out</code></em></h4><p>Update data of existing cache entry.</p></div><div class="refsect3" title="CACHE SEARCH PATTERN"><a name="id2538848"></a><h4>CACHE SEARCH <em class="replaceable"><code>PATTERN</code></em></h4><p>Search for the specified pattern in the cache data.</p></div><div class="refsect3" title="CACHE LIST"><a name="id2538861"></a><h4>CACHE LIST</h4><p>
     122</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>
     123
     124</p><div class="refsect3" lang="en"><a name="id2532812"></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="id2532831"></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="id2532843"></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="id2532862"></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="id2532875"></a><h4>CACHE LIST</h4><p>
    125125List all current items in the cache.
    126 </p></div><div class="refsect3" title="CACHE FLUSH"><a name="id2538871"></a><h4>CACHE FLUSH</h4><p>Remove all the current items from the cache.</p></div></div><div class="refsect2" title="GETLOCALSID [DOMAIN]"><a name="id2538883"></a><h3>GETLOCALSID [DOMAIN]</h3><p>Prints the SID of the specified domain, or if the parameter is
    127 omitted, the SID of the local server.</p></div><div class="refsect2" title="SETLOCALSID S-1-5-21-x-y-z"><a name="id2538894"></a><h3>SETLOCALSID S-1-5-21-x-y-z</h3><p>Sets SID for the local server to the specified SID.</p></div><div class="refsect2" title="GETDOMAINSID"><a name="id2538905"></a><h3>GETDOMAINSID</h3><p>Prints the local machine SID and the SID of the current
    128 domain.</p></div><div class="refsect2" title="SETDOMAINSID"><a name="id2538916"></a><h3>SETDOMAINSID</h3><p>Sets the SID of the current domain.</p></div><div class="refsect2" title="GROUPMAP"><a name="id2538925"></a><h3>GROUPMAP</h3><p>Manage the mappings between Windows group SIDs and UNIX groups.
    129 Common options include:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>unixgroup - Name of the UNIX group</p></li><li class="listitem"><p>ntgroup - Name of the Windows NT group (must be
    130   resolvable to a SID</p></li><li class="listitem"><p>rid - Unsigned 32-bit integer</p></li><li class="listitem"><p>sid - Full SID in the form of "S-1-..."</p></li><li class="listitem"><p>type - Type of the group; either 'domain', 'local',
    131   or 'builtin'</p></li><li class="listitem"><p>comment - Freeform text description of the group</p></li></ul></div><div class="refsect3" title="GROUPMAP ADD"><a name="id2538968"></a><h4>GROUPMAP ADD</h4><p>
     126</p></div><div class="refsect3" lang="en"><a name="id2532885"></a><h4>CACHE FLUSH</h4><p>Remove all the current items from the cache.</p></div></div><div class="refsect2" lang="en"><a name="id2532897"></a><h3>GETLOCALSID [DOMAIN]</h3><p>Prints the SID of the specified domain, or if the parameter is
     127omitted, the SID of the local server.</p></div><div class="refsect2" lang="en"><a name="id2532908"></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="id2532919"></a><h3>GETDOMAINSID</h3><p>Prints the local machine SID and the SID of the current
     128domain.</p></div><div class="refsect2" lang="en"><a name="id2532929"></a><h3>SETDOMAINSID</h3><p>Sets the SID of the current domain.</p></div><div class="refsect2" lang="en"><a name="id2532939"></a><h3>GROUPMAP</h3><p>Manage the mappings between Windows group SIDs and UNIX groups.
     129Common 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
     130  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',
     131  or 'builtin'</p></li><li><p>comment - Freeform text description of the group</p></li></ul></div><div class="refsect3" lang="en"><a name="id2532982"></a><h4>GROUPMAP ADD</h4><p>
    132132Add a new group mapping entry:
    133133</p><pre class="programlisting">
    … …  
    135135        [type={domain|local}] [ntgroup=string] [comment=string]
    136136</pre><p>
    137 </p></div><div class="refsect3" title="GROUPMAP DELETE"><a name="id2538985"></a><h4>GROUPMAP DELETE</h4><p>Delete a group mapping entry. If more than one group name matches, the first entry found is deleted.</p><p>net groupmap delete {ntgroup=string|sid=SID}</p></div><div class="refsect3" title="GROUPMAP MODIFY"><a name="id2539001"></a><h4>GROUPMAP MODIFY</h4><p>Update en existing group entry.</p><p>
     137</p></div><div class="refsect3" lang="en"><a name="id2532999"></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="id2533015"></a><h4>GROUPMAP MODIFY</h4><p>Update en existing group entry.</p><p>
    138138</p><pre class="programlisting">
    139139net groupmap modify {ntgroup=string|sid=SID} [unixgroup=string] \
    140140       [comment=string] [type={domain|local}]
    141141</pre><p>
    142 </p></div><div class="refsect3" title="GROUPMAP LIST"><a name="id2539021"></a><h4>GROUPMAP LIST</h4><p>List existing group mapping entries.</p><p>net groupmap list [verbose] [ntgroup=string] [sid=SID]</p></div></div><div class="refsect2" title="MAXRID"><a name="id2539037"></a><h3>MAXRID</h3><p>Prints out the highest RID currently in use on the local
     142</p></div><div class="refsect3" lang="en"><a name="id2533035"></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="id2533050"></a><h3>MAXRID</h3><p>Prints out the highest RID currently in use on the local
    143143server (by the active 'passdb backend').
    144 </p></div><div class="refsect2" title="RPC INFO"><a name="id2539048"></a><h3>RPC INFO</h3><p>Print information about the domain of the remote server,
     144</p></div><div class="refsect2" lang="en"><a name="id2533062"></a><h3>RPC INFO</h3><p>Print information about the domain of the remote server,
    145145such as domain name, domain sid and number of users and groups.
    146 </p></div><div class="refsect2" title="[RPC|ADS] TESTJOIN"><a name="id2539060"></a><h3>[RPC|ADS] TESTJOIN</h3><p>Check whether participation in a domain is still valid.</p></div><div class="refsect2" title="[RPC|ADS] CHANGETRUSTPW"><a name="id2539070"></a><h3>[RPC|ADS] CHANGETRUSTPW</h3><p>Force change of domain trust password.</p></div><div class="refsect2" title="RPC TRUSTDOM"><a name="id2539081"></a><h3>RPC TRUSTDOM</h3><div class="refsect3" title="RPC TRUSTDOM ADD DOMAIN"><a name="id2539086"></a><h4>RPC TRUSTDOM ADD <em class="replaceable"><code>DOMAIN</code></em></h4><p>Add a interdomain trust account for <em class="replaceable"><code>DOMAIN</code></em>.
     146</p></div><div class="refsect2" lang="en"><a name="id2533073"></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="id2533084"></a><h3>[RPC|ADS] CHANGETRUSTPW</h3><p>Force change of domain trust password.</p></div><div class="refsect2" lang="en"><a name="id2533094"></a><h3>RPC TRUSTDOM</h3><div class="refsect3" lang="en"><a name="id2533100"></a><h4>RPC TRUSTDOM ADD <em class="replaceable"><code>DOMAIN</code></em></h4><p>Add a interdomain trust account for <em class="replaceable"><code>DOMAIN</code></em>.
    147147This is in fact a Samba account named <em class="replaceable"><code>DOMAIN$</code></em>
    148148with the account flag <code class="constant">'I'</code> (interdomain trust account).
    … …  
    150150<code class="literal">smbpasswd -a -i DOMAIN</code>. Please note that both commands
    151151expect a appropriate UNIX account.
    152 </p></div><div class="refsect3" title="RPC TRUSTDOM DEL DOMAIN"><a name="id2539117"></a><h4>RPC TRUSTDOM DEL <em class="replaceable"><code>DOMAIN</code></em></h4><p>Remove interdomain trust account for
     152</p></div><div class="refsect3" lang="en"><a name="id2533131"></a><h4>RPC TRUSTDOM DEL <em class="replaceable"><code>DOMAIN</code></em></h4><p>Remove interdomain trust account for
    153153<em class="replaceable"><code>DOMAIN</code></em>. If it is used against localhost
    154154it has the same effect as <code class="literal">smbpasswd -x DOMAIN$</code>.
    155 </p></div><div class="refsect3" title="RPC TRUSTDOM ESTABLISH DOMAIN"><a name="id2539139"></a><h4>RPC TRUSTDOM ESTABLISH <em class="replaceable"><code>DOMAIN</code></em></h4><p>
     155</p></div><div class="refsect3" lang="en"><a name="id2533153"></a><h4>RPC TRUSTDOM ESTABLISH <em class="replaceable"><code>DOMAIN</code></em></h4><p>
    156156Establish a trust relationship to a trusting domain.
    157157Interdomain account must already be created on the remote PDC.
    158 </p></div><div class="refsect3" title="RPC TRUSTDOM REVOKE DOMAIN"><a name="id2539153"></a><h4>RPC TRUSTDOM REVOKE <em class="replaceable"><code>DOMAIN</code></em></h4><p>Abandon relationship to trusted domain</p></div><div class="refsect3" title="RPC TRUSTDOM LIST"><a name="id2539166"></a><h4>RPC TRUSTDOM LIST</h4><p>List all current interdomain trust relationships.</p></div><div class="refsect3" title="RPC RIGHTS"><a name="id2539176"></a><h4>RPC RIGHTS</h4><p>This subcommand is used to view and manage Samba's rights assignments (also
     158</p></div><div class="refsect3" lang="en"><a name="id2533167"></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="id2533180"></a><h4>RPC TRUSTDOM LIST</h4><p>List all current interdomain trust relationships.</p></div><div class="refsect3" lang="en"><a name="id2533190"></a><h4>RPC RIGHTS</h4><p>This subcommand is used to view and manage Samba's rights assignments (also
    159159referred to as privileges).  There are three options currently available:
    160160<em class="parameter"><code>list</code></em>, <em class="parameter"><code>grant</code></em>, and
    161161<em class="parameter"><code>revoke</code></em>.  More details on Samba's privilege model and its use
    162 can be found in the Samba-HOWTO-Collection.</p></div></div><div class="refsect2" title="RPC ABORTSHUTDOWN"><a name="id2539207"></a><h3>RPC ABORTSHUTDOWN</h3><p>Abort the shutdown of a remote server.</p></div><div class="refsect2" title="RPC SHUTDOWN [-t timeout] [-r] [-f] [-C message]"><a name="id2539217"></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>
     162can be found in the Samba-HOWTO-Collection.</p></div></div><div class="refsect2" lang="en"><a name="id2533221"></a><h3>RPC ABORTSHUTDOWN</h3><p>Abort the shutdown of a remote server.</p></div><div class="refsect2" lang="en"><a name="id2533231"></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>
    163163Reboot after shutdown.
    164164</p></dd><dt><span class="term">-f</span></dt><dd><p>
    … …  
    168168user of the system can use this time to cancel the shutdown.
    169169</p></dd><dt><span class="term">-C message</span></dt><dd><p>Display the specified message on the screen to
    170 announce the shutdown.</p></dd></dl></div></div><div class="refsect2" title="RPC SAMDUMP"><a name="id2539278"></a><h3>RPC SAMDUMP</h3><p>Print out sam database of remote server. You need
    171 to run this against the PDC, from a Samba machine joined as a BDC. </p></div><div class="refsect2" title="RPC VAMPIRE"><a name="id2539290"></a><h3>RPC VAMPIRE</h3><p>Export users, aliases and groups from remote server to
     170announce the shutdown.</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2533292"></a><h3>RPC SAMDUMP</h3><p>Print out sam database of remote server. You need
     171to run this against the PDC, from a Samba machine joined as a BDC. </p></div><div class="refsect2" lang="en"><a name="id2533304"></a><h3>RPC VAMPIRE</h3><p>Export users, aliases and groups from remote server to
    172172local server.  You need to run this against the PDC, from a Samba machine joined as a BDC.
    173 </p></div><div class="refsect2" title="RPC VAMPIRE KEYTAB"><a name="id2539302"></a><h3>RPC VAMPIRE KEYTAB</h3><p>Dump remote SAM database to local Kerberos keytab file.
    174 </p></div><div class="refsect2" title="RPC VAMPIRE LDIF"><a name="id2539313"></a><h3>RPC VAMPIRE LDIF</h3><p>Dump remote SAM database to local LDIF file or standard output.
    175 </p></div><div class="refsect2" title="RPC GETSID"><a name="id2539324"></a><h3>RPC GETSID</h3><p>Fetch domain SID and store it in the local <code class="filename">secrets.tdb</code>. </p></div><div class="refsect2" title="ADS LEAVE"><a name="id2539339"></a><h3>ADS LEAVE</h3><p>Make the remote host leave the domain it is part of. </p></div><div class="refsect2" title="ADS STATUS"><a name="id2539350"></a><h3>ADS STATUS</h3><p>Print out status of machine account of the local machine in ADS.
     173</p></div><div class="refsect2" lang="en"><a name="id2533316"></a><h3>RPC VAMPIRE KEYTAB</h3><p>Dump remote SAM database to local Kerberos keytab file.
     174</p></div><div class="refsect2" lang="en"><a name="id2533327"></a><h3>RPC VAMPIRE LDIF</h3><p>Dump remote SAM database to local LDIF file or standard output.
     175</p></div><div class="refsect2" lang="en"><a name="id2533338"></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="id2533354"></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="id2533364"></a><h3>ADS STATUS</h3><p>Print out status of machine account of the local machine in ADS.
    176176Prints out quite some debug info. Aimed at developers, regular
    177 users should use <code class="literal">NET ADS TESTJOIN</code>.</p></div><div class="refsect2" title="ADS PRINTER"><a name="id2539367"></a><h3>ADS PRINTER</h3><div class="refsect3" title="ADS PRINTER INFO [PRINTER] [SERVER]"><a name="id2539372"></a><h4>ADS PRINTER INFO [<em class="replaceable"><code>PRINTER</code></em>] [<em class="replaceable"><code>SERVER</code></em>]</h4><p>
     177users should use <code class="literal">NET ADS TESTJOIN</code>.</p></div><div class="refsect2" lang="en"><a name="id2533382"></a><h3>ADS PRINTER</h3><div class="refsect3" lang="en"><a name="id2533387"></a><h4>ADS PRINTER INFO [<em class="replaceable"><code>PRINTER</code></em>] [<em class="replaceable"><code>SERVER</code></em>]</h4><p>
    178178Lookup info for <em class="replaceable"><code>PRINTER</code></em> on <em class="replaceable"><code>SERVER</code></em>. The printer name defaults to "*", the
    179 server name defaults to the local host.</p></div><div class="refsect3" title="ADS PRINTER PUBLISH PRINTER"><a name="id2539396"></a><h4>ADS PRINTER PUBLISH <em class="replaceable"><code>PRINTER</code></em></h4><p>Publish specified printer using ADS.</p></div><div class="refsect3" title="ADS PRINTER REMOVE PRINTER"><a name="id2539409"></a><h4>ADS PRINTER REMOVE <em class="replaceable"><code>PRINTER</code></em></h4><p>Remove specified printer from ADS directory.</p></div></div><div class="refsect2" title="ADS SEARCH EXPRESSION ATTRIBUTES..."><a name="id2539423"></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
     179server name defaults to the local host.</p></div><div class="refsect3" lang="en"><a name="id2533411"></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="id2533423"></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="id2533437"></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
    180180expression is a standard LDAP search expression, and the
    181181attributes 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>
    182 </p></div><div class="refsect2" title="ADS DN DN (attributes)"><a name="id2539450"></a><h3>ADS DN <em class="replaceable"><code>DN</code></em> <em class="replaceable"><code>(attributes)</code></em></h3><p>
     182</p></div><div class="refsect2" lang="en"><a name="id2533465"></a><h3>ADS DN <em class="replaceable"><code>DN</code></em> <em class="replaceable"><code>(attributes)</code></em></h3><p>
    183183Perform a raw LDAP search on a ADS server and dump the results. The
    184184DN standard LDAP DN, and the attributes are a list of LDAP fields
    185185to show in the result.
    186 </p><p>Example: <strong class="userinput"><code>net ads dn 'CN=administrator,CN=Users,DC=my,DC=domain' SAMAccountName</code></strong></p></div><div class="refsect2" title="ADS WORKGROUP"><a name="id2539477"></a><h3>ADS WORKGROUP</h3><p>Print out workgroup name for specified kerberos realm.</p></div><div class="refsect2" title="SAM CREATEBUILTINGROUP &lt;NAME&gt;"><a name="id2539487"></a><h3>SAM CREATEBUILTINGROUP &lt;NAME&gt;</h3><p>
     186</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="id2533491"></a><h3>ADS WORKGROUP</h3><p>Print out workgroup name for specified kerberos realm.</p></div><div class="refsect2" lang="en"><a name="id2533502"></a><h3>SAM CREATEBUILTINGROUP &lt;NAME&gt;</h3><p>
    187187(Re)Create a BUILTIN group.
    188188Only a wellknown set of BUILTIN groups can be created with this command.
    … …  
    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" title="SAM CREATELOCALGROUP &lt;NAME&gt;"><a name="id2539506"></a><h3>SAM CREATELOCALGROUP &lt;NAME&gt;</h3><p>
     196</p></div><div class="refsect2" lang="en"><a name="id2533520"></a><h3>SAM CREATELOCALGROUP &lt;NAME&gt;</h3><p>
    197197Create a LOCAL group (also known as Alias).
    198198
    199199This command requires a running Winbindd with idmap allocation properly
    200200configured. The group gid will be allocated out of the winbindd range.
    201 </p></div><div class="refsect2" title="SAM DELETELOCALGROUP &lt;NAME&gt;"><a name="id2539520"></a><h3>SAM DELETELOCALGROUP &lt;NAME&gt;</h3><p>
     201</p></div><div class="refsect2" lang="en"><a name="id2533534"></a><h3>SAM DELETELOCALGROUP &lt;NAME&gt;</h3><p>
    202202Delete an existing LOCAL group (also known as Alias).
    203203
    204 </p></div><div class="refsect2" title="SAM MAPUNIXGROUP &lt;NAME&gt;"><a name="id2539531"></a><h3>SAM MAPUNIXGROUP &lt;NAME&gt;</h3><p>
     204</p></div><div class="refsect2" lang="en"><a name="id2533546"></a><h3>SAM MAPUNIXGROUP &lt;NAME&gt;</h3><p>
    205205Map an existing Unix group and make it a Domain Group, the domain group
    206206will have the same name.
    207 </p></div><div class="refsect2" title="SAM UNMAPUNIXGROUP &lt;NAME&gt;"><a name="id2539544"></a><h3>SAM UNMAPUNIXGROUP &lt;NAME&gt;</h3><p>
     207</p></div><div class="refsect2" lang="en"><a name="id2533558"></a><h3>SAM UNMAPUNIXGROUP &lt;NAME&gt;</h3><p>
    208208Remove an existing group mapping entry.
    209 </p></div><div class="refsect2" title="SAM ADDMEM &lt;GROUP&gt; &lt;MEMBER&gt;"><a name="id2539555"></a><h3>SAM ADDMEM &lt;GROUP&gt; &lt;MEMBER&gt;</h3><p>
     209</p></div><div class="refsect2" lang="en"><a name="id2533569"></a><h3>SAM ADDMEM &lt;GROUP&gt; &lt;MEMBER&gt;</h3><p>
    210210Add a member to a Local group. The group can be specified only by name,
    211211the member can be specified by name or SID.
    212 </p></div><div class="refsect2" title="SAM DELMEM &lt;GROUP&gt; &lt;MEMBER&gt;"><a name="id2539568"></a><h3>SAM DELMEM  &lt;GROUP&gt; &lt;MEMBER&gt;</h3><p>
     212</p></div><div class="refsect2" lang="en"><a name="id2533582"></a><h3>SAM DELMEM  &lt;GROUP&gt; &lt;MEMBER&gt;</h3><p>
    213213Remove a member from a Local group. The group and the member must be
    214214specified by name.
    215 </p></div><div class="refsect2" title="SAM LISTMEM &lt;GROUP&gt;"><a name="id2539580"></a><h3>SAM LISTMEM &lt;GROUP&gt;</h3><p>
     215</p></div><div class="refsect2" lang="en"><a name="id2533594"></a><h3>SAM LISTMEM &lt;GROUP&gt;</h3><p>
    216216List Local group members. The group must be specified by name.
    217 </p></div><div class="refsect2" title="SAM LIST &lt;users|groups|localgroups|builtin|workstations&gt; [verbose]"><a name="id2539591"></a><h3>SAM LIST &lt;users|groups|localgroups|builtin|workstations&gt; [verbose]</h3><p>
     217</p></div><div class="refsect2" lang="en"><a name="id2533605"></a><h3>SAM LIST &lt;users|groups|localgroups|builtin|workstations&gt; [verbose]</h3><p>
    218218List the specified set of accounts by name. If verbose is specified,
    219219the rid and description is also provided for each account.
    220 </p></div><div class="refsect2" title="SAM RIGHTS LIST"><a name="id2539605"></a><h3>SAM RIGHTS LIST</h3><p>
     220</p></div><div class="refsect2" lang="en"><a name="id2533619"></a><h3>SAM RIGHTS LIST</h3><p>
    221221List all available privileges.
    222 </p></div><div class="refsect2" title="SAM RIGHTS GRANT &lt;NAME&gt; &lt;PRIVILEGE&gt;"><a name="id2539615"></a><h3>SAM RIGHTS GRANT &lt;NAME&gt; &lt;PRIVILEGE&gt;</h3><p>
     222</p></div><div class="refsect2" lang="en"><a name="id2533630"></a><h3>SAM RIGHTS GRANT &lt;NAME&gt; &lt;PRIVILEGE&gt;</h3><p>
    223223Grant a certain privilege to a user.
    224 </p></div><div class="refsect2" title="SAM RIGHTS REVOKE &lt;NAME&gt; &lt;PRIVILEGE&gt;"><a name="id2539626"></a><h3>SAM RIGHTS REVOKE &lt;NAME&gt; &lt;PRIVILEGE&gt;</h3><p>
     224</p></div><div class="refsect2" lang="en"><a name="id2533641"></a><h3>SAM RIGHTS REVOKE &lt;NAME&gt; &lt;PRIVILEGE&gt;</h3><p>
    225225Revoke a certain privilege from a user.
    226 </p></div><div class="refsect2" title="SAM SHOW &lt;NAME&gt;"><a name="id2539638"></a><h3>SAM SHOW &lt;NAME&gt;</h3><p>
     226</p></div><div class="refsect2" lang="en"><a name="id2533652"></a><h3>SAM SHOW &lt;NAME&gt;</h3><p>
    227227Show the full DOMAIN\\NAME the SID and the type for the corresponding
    228228account.
    229 </p></div><div class="refsect2" title="SAM SET HOMEDIR &lt;NAME&gt; &lt;DIRECTORY&gt;"><a name="id2539649"></a><h3>SAM SET HOMEDIR &lt;NAME&gt; &lt;DIRECTORY&gt;</h3><p>
     229</p></div><div class="refsect2" lang="en"><a name="id2533663"></a><h3>SAM SET HOMEDIR &lt;NAME&gt; &lt;DIRECTORY&gt;</h3><p>
    230230Set the home directory for a user account.
    231 </p></div><div class="refsect2" title="SAM SET PROFILEPATH &lt;NAME&gt; &lt;PATH&gt;"><a name="id2539660"></a><h3>SAM SET PROFILEPATH &lt;NAME&gt; &lt;PATH&gt;</h3><p>
     231</p></div><div class="refsect2" lang="en"><a name="id2533674"></a><h3>SAM SET PROFILEPATH &lt;NAME&gt; &lt;PATH&gt;</h3><p>
    232232Set the profile path for a user account.
    233 </p></div><div class="refsect2" title="SAM SET COMMENT &lt;NAME&gt; &lt;COMMENT&gt;"><a name="id2539671"></a><h3>SAM SET COMMENT &lt;NAME&gt; &lt;COMMENT&gt;</h3><p>
     233</p></div><div class="refsect2" lang="en"><a name="id2533686"></a><h3>SAM SET COMMENT &lt;NAME&gt; &lt;COMMENT&gt;</h3><p>
    234234Set the comment for a user or group account.
    235 </p></div><div class="refsect2" title="SAM SET FULLNAME &lt;NAME&gt; &lt;FULL NAME&gt;"><a name="id2539682"></a><h3>SAM SET FULLNAME &lt;NAME&gt; &lt;FULL NAME&gt;</h3><p>
     235</p></div><div class="refsect2" lang="en"><a name="id2533697"></a><h3>SAM SET FULLNAME &lt;NAME&gt; &lt;FULL NAME&gt;</h3><p>
    236236Set the full name for a user account.
    237 </p></div><div class="refsect2" title="SAM SET LOGONSCRIPT &lt;NAME&gt; &lt;SCRIPT&gt;"><a name="id2539694"></a><h3>SAM SET LOGONSCRIPT &lt;NAME&gt; &lt;SCRIPT&gt;</h3><p>
     237</p></div><div class="refsect2" lang="en"><a name="id2533708"></a><h3>SAM SET LOGONSCRIPT &lt;NAME&gt; &lt;SCRIPT&gt;</h3><p>
    238238Set the logon script for a user account.
    239 </p></div><div class="refsect2" title="SAM SET HOMEDRIVE &lt;NAME&gt; &lt;DRIVE&gt;"><a name="id2539705"></a><h3>SAM SET HOMEDRIVE &lt;NAME&gt; &lt;DRIVE&gt;</h3><p>
     239</p></div><div class="refsect2" lang="en"><a name="id2533719"></a><h3>SAM SET HOMEDRIVE &lt;NAME&gt; &lt;DRIVE&gt;</h3><p>
    240240Set the home drive for a user account.
    241 </p></div><div class="refsect2" title="SAM SET WORKSTATIONS &lt;NAME&gt; &lt;WORKSTATIONS&gt;"><a name="id2539716"></a><h3>SAM SET WORKSTATIONS &lt;NAME&gt; &lt;WORKSTATIONS&gt;</h3><p>
     241</p></div><div class="refsect2" lang="en"><a name="id2533730"></a><h3>SAM SET WORKSTATIONS &lt;NAME&gt; &lt;WORKSTATIONS&gt;</h3><p>
    242242Set the workstations a user account is allowed to log in from.
    243 </p></div><div class="refsect2" title="SAM SET DISABLE &lt;NAME&gt;"><a name="id2539728"></a><h3>SAM SET DISABLE &lt;NAME&gt;</h3><p>
     243</p></div><div class="refsect2" lang="en"><a name="id2533742"></a><h3>SAM SET DISABLE &lt;NAME&gt;</h3><p>
    244244Set the "disabled" flag for a user account.
    245 </p></div><div class="refsect2" title="SAM SET PWNOTREQ &lt;NAME&gt;"><a name="id2539739"></a><h3>SAM SET PWNOTREQ &lt;NAME&gt;</h3><p>
     245</p></div><div class="refsect2" lang="en"><a name="id2533753"></a><h3>SAM SET PWNOTREQ &lt;NAME&gt;</h3><p>
    246246Set the "password not required" flag for a user account.
    247 </p></div><div class="refsect2" title="SAM SET AUTOLOCK &lt;NAME&gt;"><a name="id2539750"></a><h3>SAM SET AUTOLOCK &lt;NAME&gt;</h3><p>
     247</p></div><div class="refsect2" lang="en"><a name="id2533765"></a><h3>SAM SET AUTOLOCK &lt;NAME&gt;</h3><p>
    248248Set the "autolock" flag for a user account.
    249 </p></div><div class="refsect2" title="SAM SET PWNOEXP &lt;NAME&gt;"><a name="id2539762"></a><h3>SAM SET PWNOEXP &lt;NAME&gt;</h3><p>
     249</p></div><div class="refsect2" lang="en"><a name="id2533776"></a><h3>SAM SET PWNOEXP &lt;NAME&gt;</h3><p>
    250250Set the "password do not expire" flag for a user account.
    251 </p></div><div class="refsect2" title="SAM SET PWDMUSTCHANGENOW &lt;NAME&gt; [yes|no]"><a name="id2539773"></a><h3>SAM SET PWDMUSTCHANGENOW &lt;NAME&gt; [yes|no]</h3><p>
     251</p></div><div class="refsect2" lang="en"><a name="id2533787"></a><h3>SAM SET PWDMUSTCHANGENOW &lt;NAME&gt; [yes|no]</h3><p>
    252252Set or unset the "password must change" flag for a user account.
    253 </p></div><div class="refsect2" title="SAM POLICY LIST"><a name="id2539785"></a><h3>SAM POLICY LIST</h3><p>
     253</p></div><div class="refsect2" lang="en"><a name="id2533799"></a><h3>SAM POLICY LIST</h3><p>
    254254List the available account policies.
    255 </p></div><div class="refsect2" title="SAM POLICY SHOW &lt;account policy&gt;"><a name="id2539795"></a><h3>SAM POLICY SHOW &lt;account policy&gt;</h3><p>
     255</p></div><div class="refsect2" lang="en"><a name="id2533810"></a><h3>SAM POLICY SHOW &lt;account policy&gt;</h3><p>
    256256Show the account policy value.
    257 </p></div><div class="refsect2" title="SAM POLICY SET &lt;account policy&gt; &lt;value&gt;"><a name="id2539806"></a><h3>SAM POLICY SET &lt;account policy&gt; &lt;value&gt;</h3><p>
     257</p></div><div class="refsect2" lang="en"><a name="id2533821"></a><h3>SAM POLICY SET &lt;account policy&gt; &lt;value&gt;</h3><p>
    258258Set a value for the account policy.
    259259Valid values can be: "forever", "never", "off", or a number.
    260 </p></div><div class="refsect2" title="SAM PROVISION"><a name="id2539819"></a><h3>SAM PROVISION</h3><p>
     260</p></div><div class="refsect2" lang="en"><a name="id2533833"></a><h3>SAM PROVISION</h3><p>
    261261Only available if ldapsam:editposix is set and winbindd is running.
    262262Properly populates the ldap tree with the basic accounts (Administrator)
    263263and groups (Domain Users, Domain Admins, Domain Guests) on the ldap tree.
    264 </p></div><div class="refsect2" title="IDMAP DUMP &lt;local tdb file name&gt;"><a name="id2539832"></a><h3>IDMAP DUMP &lt;local tdb file name&gt;</h3><p>
     264</p></div><div class="refsect2" lang="en"><a name="id2533847"></a><h3>IDMAP DUMP &lt;local tdb file name&gt;</h3><p>
    265265Dumps the mappings contained in the local tdb file specified.
    266266This command is useful to dump only the mappings produced by the idmap_tdb backend.
    267 </p></div><div class="refsect2" title="IDMAP RESTORE [input file]"><a name="id2539846"></a><h3>IDMAP RESTORE [input file]</h3><p>
     267</p></div><div class="refsect2" lang="en"><a name="id2533860"></a><h3>IDMAP RESTORE [input file]</h3><p>
    268268Restore the mappings from the specified file or stdin.
    269 </p></div><div class="refsect2" title="IDMAP SECRET &lt;DOMAIN&gt;|ALLOC &lt;secret&gt;"><a name="id2539857"></a><h3>IDMAP SECRET &lt;DOMAIN&gt;|ALLOC &lt;secret&gt;</h3><p>
     269</p></div><div class="refsect2" lang="en"><a name="id2533871"></a><h3>IDMAP SECRET &lt;DOMAIN&gt;|ALLOC &lt;secret&gt;</h3><p>
    270270Store a secret for the specified domain, used primarily for domains
    271271that use idmap_ldap as a backend. In this case the secret is used
    272272as the password for the user DN used to bind to the ldap server.
    273 </p></div><div class="refsect2" title="USERSHARE"><a name="id2539871"></a><h3>USERSHARE</h3><p>Starting with version 3.0.23, a Samba server now supports the ability for
     273</p></div><div class="refsect2" lang="en"><a name="id2533886"></a><h3>USERSHARE</h3><p>Starting with version 3.0.23, a Samba server now supports the ability for
    274274non-root users to add user defined shares to be exported using the "net usershare"
    275275commands.
    … …  
    298298</p><p>The usershare commands are:
    299299
    300 </p><table border="0" summary="Simple list" class="simplelist"><tr><td>net usershare add sharename path [comment] [acl] [guest_ok=[y|n]] - to add or change a user defined share.</td></tr><tr><td>net usershare delete sharename - to delete a user defined share.</td></tr><tr><td>net usershare info [-l|--long] [wildcard sharename] - to print info about a user defined share.</td></tr><tr><td>net usershare list [-l|--long] [wildcard sharename] - to list user defined shares.</td></tr></table><p>
    301 
    302 </p><div class="refsect3" title="USERSHARE ADD sharename path [comment] [acl] [guest_ok=[y|n]]"><a name="id2539943"></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>
     300</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>
     301
     302</p><div class="refsect3" lang="en"><a name="id2533958"></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>
    303303Add or replace a new user defined share, with name "sharename".
    304304</p><p>
    … …  
    337337at connect time so will see the change immediately, there is no need
    338338to restart smbd on adding, deleting or changing a user defined share.
    339 </div><div class="refsect3" title="USERSHARE DELETE sharename"><a name="id2540016"></a><h4>USERSHARE DELETE <em class="replaceable"><code>sharename</code></em></h4><p>
     339</div><div class="refsect3" lang="en"><a name="id2534030"></a><h4>USERSHARE DELETE <em class="replaceable"><code>sharename</code></em></h4><p>
    340340Deletes the user defined share by name. The Samba smbd daemon
    341341immediately notices this change, although it will not disconnect
    342342any users currently connected to the deleted share.
    343 </p></div><div class="refsect3" title="USERSHARE INFO [-l|--long] [wildcard sharename]"><a name="id2540031"></a><h4>USERSHARE INFO <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>[wildcard sharename]</code></em></h4><p>
     343</p></div><div class="refsect3" lang="en"><a name="id2534045"></a><h4>USERSHARE INFO <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>[wildcard sharename]</code></em></h4><p>
    344344Get info on user defined shares owned by the current user matching the given pattern, or all users.
    345345</p><p>
    … …  
    360360And is a list of the current settings of the user defined share that can be
    361361modified by the "net usershare add" command.
    362 </p></div><div class="refsect3" title="USERSHARE LIST [-l|--long] wildcard sharename"><a name="id2540070"></a><h4>USERSHARE LIST <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>wildcard sharename</code></em></h4><p>
     362</p></div><div class="refsect3" lang="en"><a name="id2534085"></a><h4>USERSHARE LIST <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>wildcard sharename</code></em></h4><p>
    363363List all the user defined shares owned by the current user matching the given pattern, or all users.
    364364</p><p>
    … …  
    368368If the '-l' or '--long' option is also given, it includes the names of user defined
    369369shares created by other users.
    370 </p></div></div><div class="refsect2" title="CONF"><a name="id2540098"></a><h3>CONF</h3><p>Starting with version 3.2.0, a Samba server can be configured by data
     370</p></div></div><div class="refsect2" lang="en"><a name="id2534112"></a><h3>CONF</h3><p>Starting with version 3.2.0, a Samba server can be configured by data
    371371stored in registry. This configuration data can be edited with the new "net
    372372conf" commands.
    … …  
    375375<span class="emphasis"><em>smb.conf</em></span> file: Share definitions from registry are
    376376activated by setting <em class="parameter"><code>registry shares</code></em> to
    377 <span class="quote">&#8220;<span class="quote">yes</span>&#8221;</span> in the [global] section and global configuration options are
     377&#8220;<span class="quote">yes</span>&#8221; in the [global] section and global configuration options are
    378378activated by setting <a class="link" href="smb.conf.5.html#INCLUDE" target="_top">include = registry</a> in
    379379the [global] section for a mixed configuration or by setting
    … …  
    382382See the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> manpage for details.
    383383</p><p>The conf commands are:
    384 </p><table border="0" summary="Simple list" class="simplelist"><tr><td>net conf list - Dump the complete configuration in smb.conf like
     384</p><table class="simplelist" border="0" summary="Simple list"><tr><td>net conf list - Dump the complete configuration in smb.conf like
    385385format.</td></tr><tr><td>net conf import - Import configuration from file in smb.conf
    386386format.</td></tr><tr><td>net conf listshares - List the registry shares.</td></tr><tr><td>net conf drop - Delete the complete configuration from
    387387registry.</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>
    388 </p><div class="refsect3" title="CONF LIST"><a name="id2540218"></a><h4>CONF LIST</h4><p>
     388</p><div class="refsect3" lang="en"><a name="id2534233"></a><h4>CONF LIST</h4><p>
    389389Print the configuration data stored in the registry in a smb.conf-like format to
    390390standard output.
    391 </p></div><div class="refsect3" title="CONF IMPORT [--test|-T] filename [section]"><a name="id2540230"></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>
     391</p></div><div class="refsect3" lang="en"><a name="id2534244"></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>
    392392This command imports configuration from a file in smb.conf format.
    393393If a section encountered in the input file is present in registry,
    … …  
    399399the parameter "-T" on the commandline. In test mode, no changes are made to the
    400400registry, and the resulting configuration is printed to standard output instead.
    401 </p></div><div class="refsect3" title="CONF LISTSHARES"><a name="id2540270"></a><h4>CONF LISTSHARES</h4><p>
     401</p></div><div class="refsect3" lang="en"><a name="id2534285"></a><h4>CONF LISTSHARES</h4><p>
    402402List the names of the shares defined in registry.
    403 </p></div><div class="refsect3" title="CONF DROP"><a name="id2540281"></a><h4>CONF DROP</h4><p>
     403</p></div><div class="refsect3" lang="en"><a name="id2534295"></a><h4>CONF DROP</h4><p>
    404404Delete the complete configuration data from registry.
    405 </p></div><div class="refsect3" title="CONF SHOWSHARE sharename"><a name="id2540292"></a><h4>CONF SHOWSHARE <em class="replaceable"><code>sharename</code></em></h4><p>
     405</p></div><div class="refsect3" lang="en"><a name="id2534306"></a><h4>CONF SHOWSHARE <em class="replaceable"><code>sharename</code></em></h4><p>
    406406Show the definition of the share or section specified. It is valid to specify
    407407"global" as sharename to retrieve the global configuration options from
    408408registry.
    409 </p></div><div class="refsect3" title="CONF ADDSHARE sharename path [writeable={y|N} [guest_ok={y|N} [comment]]]"><a name="id2540306"></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.
     409</p></div><div class="refsect3" lang="en"><a name="id2534320"></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.
    410410The sharename and path have to be given. The share name may
    411411<span class="emphasis"><em>not</em></span> be "global". Optionally, values for the very
    … …  
    413413The same result may be obtained by a sequence of "net conf setparm"
    414414commands.
    415 </p></div><div class="refsect3" title="CONF DELSHARE sharename"><a name="id2540340"></a><h4>CONF DELSHARE <em class="replaceable"><code>sharename</code></em></h4><p>
     415</p></div><div class="refsect3" lang="en"><a name="id2534355"></a><h4>CONF DELSHARE <em class="replaceable"><code>sharename</code></em></h4><p>
    416416Delete a share definition from registry.
    417 </p></div><div class="refsect3" title="CONF SETPARM section parameter value"><a name="id2540353"></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>
     417</p></div><div class="refsect3" lang="en"><a name="id2534367"></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>
    418418Store a parameter in registry. The section may be global or a sharename.
    419419The section is created if it does not exist yet.
    420 </p></div><div class="refsect3" title="CONF GETPARM section parameter"><a name="id2540373"></a><h4>CONF GETPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em></h4><p>
     420</p></div><div class="refsect3" lang="en"><a name="id2534387"></a><h4>CONF GETPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em></h4><p>
    421421Show a parameter stored in registry.
    422 </p></div><div class="refsect3" title="CONF DELPARM section parameter"><a name="id2540389"></a><h4>CONF DELPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em></h4><p>
     422</p></div><div class="refsect3" lang="en"><a name="id2534403"></a><h4>CONF DELPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em></h4><p>
    423423Delete a parameter stored in registry.
    424 </p></div><div class="refsect3" title="CONF GETINCLUDES section"><a name="id2540404"></a><h4>CONF GETINCLUDES <em class="replaceable"><code>section</code></em></h4><p>
     424</p></div><div class="refsect3" lang="en"><a name="id2534419"></a><h4>CONF GETINCLUDES <em class="replaceable"><code>section</code></em></h4><p>
    425425Get the list of includes for the provided section (global or share).
    426426</p><p>
    … …  
    438438configuration. In the future, there will be the ability to include configuration
    439439data from other registry keys.
    440 </p></div><div class="refsect3" title="CONF SETINCLUDES section [filename]+"><a name="id2540439"></a><h4>CONF SETINCLUDES <em class="replaceable"><code>section</code></em> [<em class="replaceable"><code>filename</code></em>]+</h4><p>
     440</p></div><div class="refsect3" lang="en"><a name="id2534454"></a><h4>CONF SETINCLUDES <em class="replaceable"><code>section</code></em> [<em class="replaceable"><code>filename</code></em>]+</h4><p>
    441441Set the list of includes for the provided section (global or share) to the given
    442442list of one or more filenames. The filenames may contain the usual smb.conf
    443443macros like %I.
    444 </p></div><div class="refsect3" title="CONF DELINCLUDES section"><a name="id2540458"></a><h4>CONF DELINCLUDES <em class="replaceable"><code>section</code></em></h4><p>
     444</p></div><div class="refsect3" lang="en"><a name="id2534473"></a><h4>CONF DELINCLUDES <em class="replaceable"><code>section</code></em></h4><p>
    445445Delete the list of includes from the provided section (global or share).
    446 </p></div></div><div class="refsect2" title="DOM"><a name="id2540473"></a><h3>DOM</h3><p>Starting with version 3.2.0 Samba has support for remote join and unjoin APIs, both client and server-side. Windows supports remote join capabilities since Windows 2000.
     446</p></div></div><div class="refsect2" lang="en"><a name="id2534487"></a><h3>DOM</h3><p>Starting with version 3.2.0 Samba has support for remote join and unjoin APIs, both client and server-side. Windows supports remote join capabilities since Windows 2000.
    447447</p><p>In order for Samba to be joined or unjoined remotely an account must be used that is either member of the Domain Admins group, a member of the local Administrators group or a user that is granted the SeMachineAccountPrivilege privilege.
    448448</p><p>The client side support for remote join is implemented in the net dom commands which are:
    449 </p><table border="0" summary="Simple list" class="simplelist"><tr><td>net dom join - Join a remote computer into a domain.</td></tr><tr><td>net dom unjoin - Unjoin a remote computer from a domain.</td></tr></table><p>
    450 </p><div class="refsect3" title="DOM JOIN domain=DOMAIN ou=OU account=ACCOUNT password=PASSWORD reboot"><a name="id2540510"></a><h4>DOM JOIN    <em class="replaceable"><code>domain=DOMAIN</code></em> <em class="replaceable"><code>ou=OU</code></em> <em class="replaceable"><code>account=ACCOUNT</code></em> <em class="replaceable"><code>password=PASSWORD</code></em> <em class="replaceable"><code>reboot</code></em></h4><p>
     449</p><table class="simplelist" border="0" summary="Simple list"><tr><td>net dom join - Join a remote computer into a domain.</td></tr><tr><td>net dom unjoin - Unjoin a remote computer from a domain.</td></tr></table><p>
     450</p><div class="refsect3" lang="en"><a name="id2534524"></a><h4>DOM JOIN        <em class="replaceable"><code>domain=DOMAIN</code></em> <em class="replaceable"><code>ou=OU</code></em> <em class="replaceable"><code>account=ACCOUNT</code></em> <em class="replaceable"><code>password=PASSWORD</code></em> <em class="replaceable"><code>reboot</code></em></h4><p>
    451451Joins a computer into a domain. This command supports the following additional parameters:
    452 </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="replaceable"><code>DOMAIN</code></em> can be a NetBIOS domain name (also known as short domain name) or a DNS domain name for Active Directory Domains. As in Windows, it is also possible to control which Domain Controller to use. This can be achieved by appending the DC name using the \ separator character. Example: MYDOM\MYDC. The <em class="replaceable"><code>DOMAIN</code></em> parameter cannot be NULL.</p></li><li class="listitem"><p><em class="replaceable"><code>OU</code></em> can be set to a RFC 1779 LDAP DN, like <span class="emphasis"><em>ou=mymachines,cn=Users,dc=example,dc=com</em></span> in order to create the machine account in a non-default LDAP containter. This optional parameter is only supported when joining Active Directory Domains.</p></li><li class="listitem"><p><em class="replaceable"><code>ACCOUNT</code></em> defines a domain account that will be used to join the machine to the domain. This domain account needs to have sufficient privileges to join machines.</p></li><li class="listitem"><p><em class="replaceable"><code>PASSWORD</code></em> defines the password for the domain account defined with <em class="replaceable"><code>ACCOUNT</code></em>.</p></li><li class="listitem"><p><em class="replaceable"><code>REBOOT</code></em> is an optional parameter that can be set to reboot the remote machine after successful join to the domain.</p></li></ul></div><p>
     452</p><div class="itemizedlist"><ul type="disc"><li><p><em class="replaceable"><code>DOMAIN</code></em> can be a NetBIOS domain name (also known as short domain name) or a DNS domain name for Active Directory Domains. As in Windows, it is also possible to control which Domain Controller to use. This can be achieved by appending the DC name using the \ separator character. Example: MYDOM\MYDC. The <em class="replaceable"><code>DOMAIN</code></em> parameter cannot be NULL.</p></li><li><p><em class="replaceable"><code>OU</code></em> can be set to a RFC 1779 LDAP DN, like <span class="emphasis"><em>ou=mymachines,cn=Users,dc=example,dc=com</em></span> in order to create the machine account in a non-default LDAP containter. This optional parameter is only supported when joining Active Directory Domains.</p></li><li><p><em class="replaceable"><code>ACCOUNT</code></em> defines a domain account that will be used to join the machine to the domain. This domain account needs to have sufficient privileges to join machines.</p></li><li><p><em class="replaceable"><code>PASSWORD</code></em> defines the password for the domain account defined with <em class="replaceable"><code>ACCOUNT</code></em>.</p></li><li><p><em class="replaceable"><code>REBOOT</code></em> is an optional parameter that can be set to reboot the remote machine after successful join to the domain.</p></li></ul></div><p>
    453453Note that you also need to use standard net parameters to connect and authenticate to the remote machine that you want to join. These additional parameters include: -S computer and -U user.
    454454</p><p>
    … …  
    457457</p><p>
    458458This example would connect to a computer named XP as the local administrator using password secret, and join the computer into a domain called MYDOM using the MYDOM domain administrator account and password topsecret. After successful join, the computer would reboot.
    459 </p></div><div class="refsect3" title="DOM UNJOIN account=ACCOUNT password=PASSWORD reboot"><a name="id2540616"></a><h4>DOM UNJOIN <em class="replaceable"><code>account=ACCOUNT</code></em> <em class="replaceable"><code>password=PASSWORD</code></em> <em class="replaceable"><code>reboot</code></em></h4><p>
     459</p></div><div class="refsect3" lang="en"><a name="id2534630"></a><h4>DOM UNJOIN <em class="replaceable"><code>account=ACCOUNT</code></em> <em class="replaceable"><code>password=PASSWORD</code></em> <em class="replaceable"><code>reboot</code></em></h4><p>
    460460Unjoins a computer from a domain. This command supports the following additional parameters:
    461 </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="replaceable"><code>ACCOUNT</code></em> defines a domain account that will be used to unjoin the machine from the domain. This domain account needs to have sufficient privileges to unjoin machines.</p></li><li class="listitem"><p><em class="replaceable"><code>PASSWORD</code></em> defines the password for the domain account defined with <em class="replaceable"><code>ACCOUNT</code></em>.</p></li><li class="listitem"><p><em class="replaceable"><code>REBOOT</code></em> is an optional parameter that can be set to reboot the remote machine after successful unjoin from the domain.</p></li></ul></div><p>
     461</p><div class="itemizedlist"><ul type="disc"><li><p><em class="replaceable"><code>ACCOUNT</code></em> defines a domain account that will be used to unjoin the machine from the domain. This domain account needs to have sufficient privileges to unjoin machines.</p></li><li><p><em class="replaceable"><code>PASSWORD</code></em> defines the password for the domain account defined with <em class="replaceable"><code>ACCOUNT</code></em>.</p></li><li><p><em class="replaceable"><code>REBOOT</code></em> is an optional parameter that can be set to reboot the remote machine after successful unjoin from the domain.</p></li></ul></div><p>
    462462Note that you also need to use standard net parameters to connect and authenticate to the remote machine that you want to unjoin. These additional parameters include: -S computer and -U user.
    463463</p><p>
    … …  
    466466</p><p>
    467467This example would connect to a computer named XP as the local administrator using password secret, and unjoin the computer from the domain using the MYDOM domain administrator account and password topsecret. After successful unjoin, the computer would reboot.
    468 </p></div></div><div class="refsect2" title="HELP [COMMAND]"><a name="id2540688"></a><h3>HELP [COMMAND]</h3><p>Gives usage information for the specified command.</p></div></div><div class="refsect1" title="VERSION"><a name="id2540699"></a><h2>VERSION</h2><p>This man page is complete for version 3 of the Samba
    469         suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id2540710"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     468</p></div></div><div class="refsect2" lang="en"><a name="id2534702"></a><h3>HELP [COMMAND]</h3><p>Gives usage information for the specified command.</p></div></div><div class="refsect1" lang="en"><a name="id2534714"></a><h2>VERSION</h2><p>This man page is complete for version 3 of the Samba
     469        suite.</p></div><div class="refsect1" lang="en"><a name="id2534725"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    470470        were created by Andrew Tridgell. Samba is now developed
    471471        by the Samba Team as an Open Source project similar

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

    r368 r411  
    1 <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.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="nmbd"><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" title="Synopsis"><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" title="DESCRIPTION"><a name="id2489652"></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
     1<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.74.0"></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="id2483383"></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" title="OPTIONS"><a name="id2489868"></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="id2483721"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-D</span></dt><dd><p>If specified, this parameter causes
    2626                <code class="literal">nmbd</code> to operate as a daemon. That is,
    2727                it detaches itself and runs in the background, fielding
    … …  
    8989                that <code class="literal">nmbd</code> responds to name queries on. Don't
    9090                use this option unless you are an expert, in which case you
    91                 won't need help!</p></dd></dl></div></div><div class="refsect1" title="FILES"><a name="id2487728"></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="id2481745"></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" title="SIGNALS"><a name="id2487934"></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="id2481952"></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" title="VERSION"><a name="id2538489"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    133         the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2538500"></a><h2>SEE ALSO</h2><p>
     132        at a normally low log level.</p></div><div class="refsect1" lang="en"><a name="id2482037"></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="id2532512"></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" title="AUTHOR"><a name="id2538574"></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="id2532586"></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.3.x/docs/htmldocs/manpages/nmblookup.1.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>nmblookup</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="nmblookup"><a name="nmblookup"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>nmblookup &#8212; NetBIOS over TCP/IP client used to lookup NetBIOS
    2         names</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">nmblookup</code> [-M] [-R] [-S] [-r] [-A] [-h] [-B &lt;broadcast address&gt;] [-U &lt;unicast address&gt;] [-d &lt;debug level&gt;] [-s &lt;smb config file&gt;] [-i &lt;NetBIOS scope&gt;] [-T] [-f] {name}</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2489377"></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
     1<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.74.0"></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="id2483394"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">nmblookup</code> is used to query NetBIOS names
    33        and map them to IP addresses in a network using NetBIOS over TCP/IP
    44        queries. The options allow the name queries to be directed at a
    55        particular IP broadcast area or to a particular machine. All queries
    6         are done over UDP.</p></div><div class="refsect1" title="OPTIONS"><a name="id2489529"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-M</span></dt><dd><p>Searches for a master browser by looking
     6        are done over UDP.</p></div><div class="refsect1" lang="en"><a name="id2483546"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-M</span></dt><dd><p>Searches for a master browser by looking
    77                up the  NetBIOS name <em class="replaceable"><code>name</code></em> with a
    88                type of <code class="constant">0x1d</code>. If <em class="replaceable"><code>
    … …  
    8989                by appending '#&lt;type&gt;' to the name. This name may also be
    9090                '*', which will return all registered names within a broadcast
    91                 area.</p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id2487742"></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="id2481762"></a><h2>EXAMPLES</h2><p><code class="literal">nmblookup</code> can be used to query
    9292                a WINS server (in the same way <code class="literal">nslookup</code> is
    9393                used to query DNS servers). To query a WINS server, <code class="literal">nmblookup</code>
    9494                must be called like this:</p><p><code class="literal">nmblookup -U server -R 'name'</code></p><p>For example, running :</p><p><code class="literal">nmblookup -U samba.org -R 'IRIX#1B'</code></p><p>would query the WINS server samba.org for the domain
    95                 master browser (1B name type) for the IRIX workgroup.</p></div><div class="refsect1" title="VERSION"><a name="id2487792"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    96         the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2487803"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>, <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>, and <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id2487836"></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="id2481812"></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="id2481823"></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="id2481856"></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.3.x/docs/htmldocs/manpages/ntlm_auth.1.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ntlm_auth</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="ntlm_auth"><a name="ntlm-auth.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ntlm_auth &#8212; tool to allow external access to Winbind's NTLM authentication function</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">ntlm_auth</code> [-d debuglevel] [-l logdir] [-s &lt;smb config file&gt;]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528921"></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.74.0"></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="id2522940"></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
    44        the user and authentication data for a domain.  This utility
    5         is only indended to be used by other programs (currently
     5        is only intended to be used by other programs (currently
    66        <a class="ulink" href="http://www.squid-cache.org/" target="_top">Squid</a>
    77        and <a class="ulink" href="http://download.samba.org/ftp/unpacked/lorikeet/trunk/mod_ntlm_winbind/" target="_top">mod_ntlm_winbind</a>)
    8         </p></div><div class="refsect1" title="OPERATIONAL REQUIREMENTS"><a name="id2489334"></a><h2>OPERATIONAL REQUIREMENTS</h2><p>
     8        </p></div><div class="refsect1" lang="en"><a name="id2483351"></a><h2>OPERATIONAL REQUIREMENTS</h2><p>
    99    The <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon must be operational
    1010    for many of these commands to function.</p><p>Some of these commands also require access to the directory
    … …  
    1313    this command as root or providing group access
    1414    to the <code class="filename">winbindd_privileged</code> directory.  For
    15     security reasons, this directory should not be world-accessable. </p></div><div class="refsect1" title="OPTIONS"><a name="id2489379"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">--helper-protocol=PROTO</span></dt><dd><p>
     15    security reasons, this directory should not be world-accessable. </p></div><div class="refsect1" lang="en"><a name="id2483396"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">--helper-protocol=PROTO</span></dt><dd><p>
    1616        Operate as a stdio-based helper.  Valid helper protocols are:
    1717        </p><div class="variablelist"><dl><dt><span class="term">squid-2.4-basic</span></dt><dd><p>
    … …  
    6161                could cause the helper to authenticate the
    6262                user). </p><p>Curently implemented parameters from the
    63                 external program to the helper are:</p><div class="variablelist"><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3>Implementors should take care to base64 encode
     63                external program to the helper are:</p><div class="variablelist"><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3>Implementors should take care to base64 encode
    6464                any data (such as usernames/passwords) that may contain malicous user data, such as
    6565                a newline.  They may also need to decode strings from
    6666                the helper, which likewise may have been base64 encoded.</div><dl><dt><span class="term">Username</span></dt><dd><p>The username, expected to be in
    6767                Samba's <a class="link" href="smb.conf.5.html#UNIXCHARSET" target="_top">unix charset</a>.
    68                 </p><div class="example"><a name="id2489753"></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="id2489758"></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="id2483768"></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="id2483773"></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" target="_top">unix charset</a>.
    70                 </p><div class="example"><a name="id2487555"></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="id2487560"></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="id2481575"></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="id2481579"></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" target="_top">unix charset</a> and qualified with the
    7272                <a class="link" href="smb.conf.5.html#WINBINDSEPARATOR" target="_top">winbind separator</a>.
    73                 </p><div class="example"><a name="id2487597"></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="id2487601"></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="id2481616"></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="id2481620"></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="id2487626"></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="id2481645"></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="id2487657"></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="id2481676"></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="id2487690"></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="id2481709"></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="id2487710"></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="id2487715"></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="id2481729"></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="id2481734"></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="id2487732"></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="id2481751"></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="id2487749"></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="id2481768"></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" title="EXAMPLE SETUP"><a name="id2538506"></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="id2532521"></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.
    … …  
    138138auth_param basic realm Squid proxy-caching web server
    139139auth_param basic credentialsttl 2 hours
    140 </pre><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This example assumes that ntlm_auth has been installed into your
     140</pre><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This example assumes that ntlm_auth has been installed into your
    141141      path, and that the group permissions on
    142142      <code class="filename">winbindd_privileged</code> are as described above.</p></div><p>To setup ntlm_auth for use by squid 2.5 with group limitation in addition to the above
    … …  
    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" title="TROUBLESHOOTING"><a name="id2538562"></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="id2532578"></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" title="VERSION"><a name="id2538584"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
    153         suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id2538594"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     152        </p></div><div class="refsect1" lang="en"><a name="id2532599"></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="id2532610"></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.3.x/docs/htmldocs/manpages/pam_winbind.8.html

    r374 r411  
    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.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="pam_winbind"><a name="pam_winbind.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>pam_winbind &#8212; PAM module for Winbind</p></div><div class="refsect1" title="DESCRIPTION"><a name="id2528891"></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.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="pam_winbind.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>pam_winbind &#8212; PAM module for Winbind</p></div><div class="refsect1" lang="en"><a name="id2522902"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>
    22        pam_winbind is a PAM module that can authenticate users against the local domain by talking to the Winbind daemon.
    3         </p></div><div class="refsect1" title="SYNOPSIS"><a name="id2528914"></a><h2>SYNOPSIS</h2><p>
     3        </p></div><div class="refsect1" lang="en"><a name="id2522925"></a><h2>SYNOPSIS</h2><p>
    44                Edit the PAM system config /etc/pam.d/service and modify it as the following example shows:
    55                </p><pre class="programlisting">
    … …  
    2020                Make sure that pam_winbind is one of the first modules in the session part. It may retrieve
    2121                kerberos tickets which are needed by other modules.
    22         </p></div><div class="refsect1" title="OPTIONS"><a name="id2528943"></a><h2>OPTIONS</h2><p>
     22        </p></div><div class="refsect1" lang="en"><a name="id2522954"></a><h2>OPTIONS</h2><p>
    2323       
    2424                pam_winbind supports several options which can either be set in
    … …  
    8383                </p></dd></dl></div><p>
    8484
    85         </p></div><div class="refsect1" title="PAM DATA EXPORTS"><a name="id2489670"></a><h2>PAM DATA EXPORTS</h2><p>This section describes the data exported in the PAM stack which could be used in other PAM modules.</p><dt><span class="term">PAM_WINBIND_HOMEDIR</span></dt><dd><p>
     85        </p></div><div class="refsect1" lang="en"><a name="id2483686"></a><h2>PAM DATA EXPORTS</h2><p>This section describes the data exported in the PAM stack which could be used in other PAM modules.</p><dt><span class="term">PAM_WINBIND_HOMEDIR</span></dt><dd><p>
    8686                                This is the Windows Home Directory set in the profile tab in the user settings
    8787                                on the Active Directory Server. This could be a local path or a directory on a
    … …  
    9696                                This is the profile path set in the profile tab in the user settings. Noramlly
    9797                                the home directory is synced with this directory on a share.
    98                         </p></dd></div><div class="refsect1" title="SEE ALSO"><a name="id2489745"></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" title="VERSION"><a name="id2489780"></a><h2>VERSION</h2><p>This man page is correct for version 3 of Samba.</p></div><div class="refsect1" title="AUTHOR"><a name="id2487454"></a><h2>AUTHOR</h2><p>
     98                        </p></dd></div><div class="refsect1" lang="en"><a name="id2483761"></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="id2483796"></a><h2>VERSION</h2><p>This man page is correct for version 3 of Samba.</p></div><div class="refsect1" lang="en"><a name="id2481475"></a><h2>AUTHOR</h2><p>
    9999        The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed by
    100100        the Samba Team as an Open Source project similar to the way the Linux kernel is developed.

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>pdbedit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="pdbedit"><a name="pdbedit.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>pdbedit &#8212; manage the SAM database (Database of Samba Users)</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">pdbedit</code> [-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" title="DESCRIPTION"><a name="id2489574"></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.74.0"></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="id2483590"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The pdbedit program is used to manage the users accounts
    22        stored in the sam database and can only be run by root.</p><p>The pdbedit tool uses the passdb modular interface and is
    33        independent from the kind of users database used (currently there
    … …  
    55        without changing the tool).</p><p>There are five main ways to use pdbedit: adding a user account,
    66        removing a user account, modifing a user account, listing user
    7         accounts, importing users accounts.</p></div><div class="refsect1" title="OPTIONS"><a name="id2489611"></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="id2483626"></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
    … …  
    7070                                account. It will specify the users' account control property. Possible flags are listed below.
    7171        </p><p>
    72                 </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>N: No password required</p></li><li class="listitem"><p>D: Account disabled</p></li><li class="listitem"><p>H: Home directory required</p></li><li class="listitem"><p>T: Temporary duplicate of other account</p></li><li class="listitem"><p>U: Regular user account</p></li><li class="listitem"><p>M: MNS logon user account</p></li><li class="listitem"><p>W: Workstation Trust Account</p></li><li class="listitem"><p>S: Server Trust Account</p></li><li class="listitem"><p>L: Automatic Locking</p></li><li class="listitem"><p>X: Password does not expire</p></li><li class="listitem"><p>I: Domain Trust Account</p></li></ul></div><p>
     72                </p><div class="itemizedlist"><ul type="disc"><li><p>N: No password required</p></li><li><p>D: Account disabled</p></li><li><p>H: Home directory required</p></li><li><p>T: Temporary duplicate of other account</p></li><li><p>U: Regular user account</p></li><li><p>M: MNS logon user account</p></li><li><p>W: Workstation Trust Account</p></li><li><p>S: Server Trust Account</p></li><li><p>L: Automatic Locking</p></li><li><p>X: Password does not expire</p></li><li><p>I: Domain Trust Account</p></li></ul></div><p>
    7373        </p><p>Example: <code class="literal">-c "[X          ]"</code></p></dd><dt><span class="term">-a</span></dt><dd><p>This option is used to add a user into the
    7474                database. This command needs a user name specified with
    … …  
    7878retype new password
    7979</pre><p>
    80 </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>pdbedit does not call the unix password syncronisation
     80</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>pdbedit does not call the unix password syncronisation
    8181                                script if <a class="link" href="smb.conf.5.html#UNIXPASSWORDSYNC" target="_top">unix password sync</a>
    8282                                has been set. It only updates the data in the Samba
    … …  
    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" title="NOTES"><a name="id2538711"></a><h2>NOTES</h2><p>This command may be used only by root.</p></div><div class="refsect1" title="VERSION"><a name="id2538721"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    148         the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2538732"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbpasswd.5.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(5)</span></a>, <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a></p></div><div class="refsect1" title="AUTHOR"><a name="id2538754"></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="id2532729"></a><h2>NOTES</h2><p>This command may be used only by root.</p></div><div class="refsect1" lang="en"><a name="id2532739"></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="id2532749"></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="id2532772"></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.3.x/docs/htmldocs/manpages/profiles.1.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>profiles</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="profiles"><a name="profiles.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>profiles &#8212; A utility to report and change SIDs in registry files
    2         </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">profiles</code> [-v] [-c SID] [-n SID] {file}</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528928"></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
     1<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.74.0"></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="id2522947"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">profiles</code> is a utility that
    33        reports and changes SIDs in windows registry files. It currently only
    44        supports NT.
    5         </p></div><div class="refsect1" title="OPTIONS"><a name="id2489324"></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="id2483341"></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" title="VERSION"><a name="id2489510"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
    9         suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id2489521"></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="id2483526"></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="id2483537"></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.3.x/docs/htmldocs/manpages/rpcclient.1.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>rpcclient</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="rpcclient"><a name="rpcclient.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>rpcclient &#8212; tool for executing client side
    2         MS-RPC functions</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">rpcclient</code> [-A authfile] [-c &lt;command string&gt;] [-d debuglevel] [-h] [-l logdir] [-N] [-s &lt;smb config file&gt;] [-U username[%password]] [-W workgroup] [-N] [-I destinationIP] {server}</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2489358"></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
     1<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.74.0"></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="id2483375"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">rpcclient</code> is a utility initially developed
    33        to test MS-RPC functionality in Samba itself.  It has undergone
    44        several stages of development and stability.  Many system administrators
    55        have now written scripts around it to manage Windows NT clients from
    6         their UNIX workstation. </p></div><div class="refsect1" title="OPTIONS"><a name="id2489512"></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="id2483528"></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" target="_top">name resolve order</a> line from <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>.</p></dd><dt><span class="term">-c|--command='command string'</span></dt><dd><p>execute semicolon separated commands (listed
    … …  
    4949Try to authenticate with kerberos. Only useful in
    5050an Active Directory environment.
     51</p></dd><dt><span class="term">-C|--use-ccache</span></dt><dd><p>
     52Try to use the credentials cached by winbind.
    5153</p></dd><dt><span class="term">-A|--authentication-file=filename</span></dt><dd><p>This option allows
    5254you to specify a file from which to read the username and
    … …  
    9092the <code class="filename">smb.conf</code> manual page for the list of valid
    9193options. </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" title="COMMANDS"><a name="id2487714"></a><h2>COMMANDS</h2><div class="refsect2" title="LSARPC"><a name="id2487719"></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
     94</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481745"></a><h2>COMMANDS</h2><div class="refsect2" lang="en"><a name="id2481751"></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
    9395                of SIDs to usernames.
    9496                </p></dd><dt><span class="term">lookupnames</span></dt><dd><p>Resolve a list
    9597                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" title="LSARPC-DS"><a name="id2487845"></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" title="REG"><a name="id2487914"></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" title="SRVSVC"><a name="id2487940"></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" title="SAMR"><a name="id2487982"></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" title="SPOOLSS"><a name="id2538588"></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>
     98                </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="id2481876"></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="id2481945"></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="id2481972"></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="id2482014"></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="id2532616"></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>
    9799                Execute an AddPrinterDriver() RPC to install the printer driver
    98100                information on the server.  Note that the driver files should
    … …  
    179181                <code class="literal">enumdrivers</code> commands for obtaining a list of
    180182                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" title="NETLOGON"><a name="id2538983"></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" title="GENERAL COMMANDS"><a name="id2539040"></a><h3>GENERAL COMMANDS</h3><div class="variablelist"><dl><dt><span class="term">debuglevel</span></dt><dd><p>Set the current
     183                &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="id2533011"></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="id2533069"></a><h3>GENERAL COMMANDS</h3><div class="variablelist"><dl><dt><span class="term">debuglevel</span></dt><dd><p>Set the current
    182184                debug level used to log information.</p></dd><dt><span class="term">help (?)</span></dt><dd><p>Print a listing of all
    183185                known commands or extended help  on a particular command.
    184186                </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" title="BUGS"><a name="id2539081"></a><h2>BUGS</h2><p><code class="literal">rpcclient</code> is designed as a developer testing tool
     187                </code>.</p></dd></dl></div></div></div><div class="refsect1" lang="en"><a name="id2533110"></a><h2>BUGS</h2><p><code class="literal">rpcclient</code> is designed as a developer testing tool
    186188        and may not be robust in certain areas (such as command line parsing). 
    187189        It has been known to  generate a core dump upon failures when invalid
    … …  
    196198        the developers are sending reports to Microsoft,  and problems found
    197199        or reported to Microsoft are fixed in Service Packs,  which may
    198         result in incompatibilities.</p></div><div class="refsect1" title="VERSION"><a name="id2539139"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
    199         suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id2539150"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     200        result in incompatibilities.</p></div><div class="refsect1" lang="en"><a name="id2533168"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
     201        suite.</p></div><div class="refsect1" lang="en"><a name="id2533179"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    200202        were created by Andrew Tridgell. Samba is now developed
    201203        by the Samba Team as an Open Source project similar

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

    r368 r411  
    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.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="samba"><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" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">samba</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528858"></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.74.0"></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="id2522912"></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" title="COMPONENTS"><a name="id2487779"></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="id2481796"></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" title="AVAILABILITY"><a name="id2487811"></a><h2>AVAILABILITY</h2><p>The Samba software suite is licensed under the
     75        </p></div><div class="refsect1" lang="en"><a name="id2481829"></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" title="VERSION"><a name="id2487856"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the
    90         Samba suite. </p></div><div class="refsect1" title="CONTRIBUTIONS"><a name="id2487867"></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="id2481874"></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="id2481885"></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" title="CONTRIBUTORS"><a name="id2487901"></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="id2481918"></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" title="AUTHOR"><a name="id2487929"></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="id2481946"></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.3.x/docs/htmldocs/manpages/sharesec.1.html

    r374 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>sharesec</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="sharesec"><a name="sharesec.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sharesec &#8212; Set or get share ACLs</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">sharesec</code> {sharename} [-r, --remove=ACL] [-m, --modify=ACL] [-a, --add=ACL] [-R, --replace=ACLs] [-D, --delete] [-v, --view] [-M, --machine-sid] [-F, --force] [-d, --debuglevel=DEBUGLEVEL] [-s, --configfile=CONFIGFILE] [-l, --log-basename=LOGFILEBASE] [-V, --version] [-?, --help] [--usage]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2489503"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">sharesec</code> program manipulates share permissions
    2         on SMB file shares.</p></div><div class="refsect1" title="OPTIONS"><a name="id2489531"></a><h2>OPTIONS</h2><p>The following options are available to the <code class="literal">sharesec</code> program.
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>sharesec</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="sharesec.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sharesec &#8212; Set or get share ACLs</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">sharesec</code> {sharename} [-r, --remove=ACL] [-m, --modify=ACL] [-a, --add=ACL] [-R, --replace=ACLs] [-D, --delete] [-v, --view] [-M, --machine-sid] [-F, --force] [-d, --debuglevel=DEBUGLEVEL] [-s, --configfile=CONFIGFILE] [-l, --log-basename=LOGFILEBASE] [-V, --version] [-?, --help] [--usage]</p></div></div><div class="refsect1" lang="en"><a name="id2483520"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">sharesec</code> program manipulates share permissions
     2        on SMB file shares.</p></div><div class="refsect1" lang="en"><a name="id2483548"></a><h2>OPTIONS</h2><p>The following options are available to the <code class="literal">sharesec</code> program.
    33        The format of ACLs is described in the section ACL FORMAT </p><div class="variablelist"><dl><dt><span class="term">-a|--add=ACL</span></dt><dd><p>Add the ACEs specified to the ACL list.
    44                </p></dd><dt><span class="term">-D|--delete</span></dt><dd><p>Delete the entire security descriptor.
    … …  
    3434<code class="constant">".progname"</code> will be appended (e.g. log.smbclient,
    3535log.smbd, etc...). The log file is never removed by the client.
    36 </p></dd></dl></div></div><div class="refsect1" title="ACL FORMAT"><a name="id2489748"></a><h2>ACL FORMAT</h2><p>The format of an ACL is one or more ACL entries separated by
     36</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483764"></a><h2>ACL FORMAT</h2><p>The format of an ACL is one or more ACL entries separated by
    3737        either commas or newlines.  An ACL entry is one of the following: </p><pre class="programlisting">
    3838        REVISION:&lt;revision number&gt;
    … …  
    5555        granted to the SID. It can be given as a decimal or hexadecimal value,
    5656        or by using one of the following text strings which map to the NT
    57         file permissions of the same name.</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><span class="emphasis"><em>R</em></span> - Allow read access </p></li><li class="listitem"><p><span class="emphasis"><em>W</em></span> - Allow write access</p></li><li class="listitem"><p><span class="emphasis"><em>X</em></span> - Execute permission on the object</p></li><li class="listitem"><p><span class="emphasis"><em>D</em></span> - Delete the object</p></li><li class="listitem"><p><span class="emphasis"><em>P</em></span> - Change permissions</p></li><li class="listitem"><p><span class="emphasis"><em>O</em></span> - Take ownership</p></li></ul></div><p>The following combined permissions can be specified:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><span class="emphasis"><em>READ</em></span> -  Equivalent to 'RX'
    58                 permissions</p></li><li class="listitem"><p><span class="emphasis"><em>CHANGE</em></span> - Equivalent to 'RXWD' permissions
    59                 </p></li><li class="listitem"><p><span class="emphasis"><em>FULL</em></span> - Equivalent to 'RWXDPO'
    60                 permissions</p></li></ul></div></div><div class="refsect1" title="EXIT STATUS"><a name="id2487647"></a><h2>EXIT STATUS</h2><p>The <code class="literal">sharesec</code> program sets the exit status
     57        file permissions of the same name.</p><div class="itemizedlist"><ul type="disc"><li><p><span class="emphasis"><em>R</em></span> - Allow read access </p></li><li><p><span class="emphasis"><em>W</em></span> - Allow write access</p></li><li><p><span class="emphasis"><em>X</em></span> - Execute permission on the object</p></li><li><p><span class="emphasis"><em>D</em></span> - Delete the object</p></li><li><p><span class="emphasis"><em>P</em></span> - Change permissions</p></li><li><p><span class="emphasis"><em>O</em></span> - Take ownership</p></li></ul></div><p>The following combined permissions can be specified:</p><div class="itemizedlist"><ul type="disc"><li><p><span class="emphasis"><em>READ</em></span> -  Equivalent to 'RX'
     58                permissions</p></li><li><p><span class="emphasis"><em>CHANGE</em></span> - Equivalent to 'RXWD' permissions
     59                </p></li><li><p><span class="emphasis"><em>FULL</em></span> - Equivalent to 'RWXDPO'
     60                permissions</p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2481668"></a><h2>EXIT STATUS</h2><p>The <code class="literal">sharesec</code> program sets the exit status
    6161        depending on the success or otherwise of the operations performed.
    6262        The exit status may be one of the following values. </p><p>If the operation succeeded, sharesec returns and exit
    … …  
    6464        or there was an error getting or setting the ACLs, an exit status
    6565        of 1 is returned.  If there was an error parsing any command line
    66         arguments, an exit status of 2 is returned. </p></div><div class="refsect1" title="EXAMPLES"><a name="id2487680"></a><h2>EXAMPLES</h2><p>Add full access for SID
     66        arguments, an exit status of 2 is returned. </p></div><div class="refsect1" lang="en"><a name="id2481700"></a><h2>EXAMPLES</h2><p>Add full access for SID
    6767        <em class="parameter"><code>S-1-5-21-1866488690-1365729215-3963860297-17724</code></em> on
    6868        <em class="parameter"><code>share</code></em>:
    … …  
    7777        ACL:S-1-1-0:ALLOWED/0/0x101f01ff
    7878        ACL:S-1-5-21-1866488690-1365729215-3963860297-17724:ALLOWED/0/FULL
    79         </pre></div><div class="refsect1" title="VERSION"><a name="id2487728"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id2487739"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     79        </pre></div><div class="refsect1" lang="en"><a name="id2481749"></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="id2481760"></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.3.x/docs/htmldocs/manpages/smb.conf.5.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smb.conf</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smb.conf"><a name="smb.conf.5"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smb.conf &#8212; The configuration file for the Samba suite</p></div><div class="refsect1" title="SYNOPSIS"><a name="id2528887"></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.74.0"></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="id2522906"></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
    44         <a class="citerefentry" href="swat.8.html"><span class="citerefentry"><span class="refentrytitle">swat</span>(8)</span></a> program. The
    55        complete description of the file format and possible parameters held within are here for reference purposes.
    6         </p></div><div class="refsect1" title="FILE FORMAT"><a name="FILEFORMATSECT"></a><h2>FILE FORMAT</h2><p>
     6        </p></div><div class="refsect1" lang="en"><a name="FILEFORMATSECT"></a><h2>FILE FORMAT</h2><p>
    77        The file consists of sections and parameters. A section begins with the name of the section in square brackets
    88        and continues until the next section begins. Sections contain parameters of the form:
    … …  
    1919        retained verbatim.
    2020        </p><p>
    21         Any line beginning with a semicolon (<span class="quote">&#8220;<span class="quote">;</span>&#8221;</span>) or a hash (<span class="quote">&#8220;<span class="quote">#</span>&#8221;</span>)
     21        Any line beginning with a semicolon (&#8220;<span class="quote">;</span>&#8221;) or a hash (&#8220;<span class="quote">#</span>&#8221;)
    2222        character is ignored, as are lines containing only whitespace.
    2323        </p><p>
    24         Any line ending in a <span class="quote">&#8220;<span class="quote"><code class="literal">\</code></span>&#8221;</span> is continued on the next line in the customary UNIX fashion.
     24        Any line ending in a &#8220;<span class="quote"><code class="literal">\</code></span>&#8221; is continued on the next line in the customary UNIX fashion.
    2525        </p><p>
    2626        The values following the equals sign in parameters are all either a string (no quotes needed) or a boolean,
    2727        which may be given as yes/no, 1/0 or true/false. Case is not significant in boolean values, but is preserved
    2828        in string values. Some items such as create masks are numeric.
    29         </p></div><div class="refsect1" title="SECTION DESCRIPTIONS"><a name="id2489374"></a><h2>SECTION DESCRIPTIONS</h2><p>
     29        </p></div><div class="refsect1" lang="en"><a name="id2483390"></a><h2>SECTION DESCRIPTIONS</h2><p>
    3030        Each section in the configuration file (except for the [global] section) describes a shared resource (known as
    31         a <span class="quote">&#8220;<span class="quote">share</span>&#8221;</span>). The section name is the name of the shared resource and the parameters within the
     31        a &#8220;<span class="quote">share</span>&#8221;). The section name is the name of the shared resource and the parameters within the
    3232        section define the shares attributes.
    3333        </p><p>
    … …  
    7070        <a class="link" href="smb.conf.5.html#GUESTOK" target="_top">guest ok = yes</a>
    7171</pre><p>
    72         </p></div><div class="refsect1" title="SPECIAL SECTIONS"><a name="id2487452"></a><h2>SPECIAL SECTIONS</h2><div class="refsect2" title="The [global] section"><a name="id2487457"></a><h3>The [global] section</h3><p>
     72        </p></div><div class="refsect1" lang="en"><a name="id2481471"></a><h2>SPECIAL SECTIONS</h2><div class="refsect2" lang="en"><a name="id2481477"></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.
    75                 </p></div><div class="refsect2" title="The [homes] section"><a name="HOMESECT"></a><h3>The [homes] section</h3><p>
     75                </p></div><div class="refsect2" lang="en"><a name="HOMESECT"></a><h3>The [homes] section</h3><p>
    7676                If a section called [homes] is included in the configuration file, services connecting clients
    7777                to their home directories can be created on the fly by the server.
    … …  
    8383                </p><p>
    8484                Some modifications are then made to the newly created share:
    85                 </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     85                </p><div class="itemizedlist"><ul type="disc"><li><p>
    8686                        The share name is changed from homes to the located username.
    87                         </p></li><li class="listitem"><p>
     87                        </p></li><li><p>
    8888                        If no path was given, the path is set to the user's home directory.
    8989                        </p></li></ul></div><p>
    … …  
    9898                of fuss.
    9999                </p><p>
    100                 A similar process occurs if the requested section name is <span class="quote">&#8220;<span class="quote">homes</span>&#8221;</span>, except that the share
     100                A similar process occurs if the requested section name is &#8220;<span class="quote">homes</span>&#8221;, except that the share
    101101                name is not changed to that of the requesting user. This method of using the [homes] section works well if
    102102                different users share a client PC.
    … …  
    116116                flag, not the [homes] browseable flag. This is useful as it means setting <span class="emphasis"><em>browseable = no</em></span> in
    117117                the [homes] section will hide the [homes] share but make any auto home directories visible.
    118                 </p></div><div class="refsect2" title="The [printers] section"><a name="PRINTERSSECT"></a><h3>The [printers] section</h3><p>
     118                </p></div><div class="refsect2" lang="en"><a name="PRINTERSSECT"></a><h3>The [printers] section</h3><p>
    119119                This section works like [homes], but for printers.
    120120                </p><p>
    … …  
    129129                </p><p>
    130130                A few modifications are then made to the newly created share:
    131                 </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>The share name is set to the located printer name</p></li><li class="listitem"><p>If no printer name was given, the printer name is set to the located printer name</p></li><li class="listitem"><p>If the share does not permit guest access and no username was given, the username is set
     131                </p><div class="itemizedlist"><ul type="disc"><li><p>The share name is set to the located printer name</p></li><li><p>If no printer name was given, the printer name is set to the located printer name</p></li><li><p>If the share does not permit guest access and no username was given, the username is set
    132132                                to the located printer name.</p></li></ul></div><p>
    133133                The [printers] service MUST be printable - if you specify otherwise, the server will refuse
    … …  
    157157                An alias, by the way, is defined as any component of the first entry of a printcap record. Records are separated by newlines,
    158158                components (if there are more than one) are separated by vertical bar symbols (<code class="literal">|</code>).
    159                 </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
     159                </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
    160160                On SYSV systems which use lpstat to determine what printers are defined on the system you may be able to use
    161161                <code class="literal">printcap name = lpstat</code> to automatically obtain a list of printers. See the
    162162                <code class="literal">printcap name</code> option for more details.
    163                 </p></div></div></div><div class="refsect1" title="USERSHARES"><a name="id2487774"></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="id2481792"></a><h2>USERSHARES</h2><p>Starting with Samba version 3.0.23 the capability for non-root users to add, modify, and delete
    164164        their own share definitions has been added. This capability is called <span class="emphasis"><em>usershares</em></span> and
    165165        is controlled by a set of parameters in the [global] section of the smb.conf.
    … …  
    185185        to the global
    186186        section of your <code class="filename">smb.conf</code>. Members of the group foo may then manipulate the user defined shares
    187         using the following commands.</p><div class="variablelist"><dl><dt><span class="term">net usershare add sharename path [comment] [acl] [guest_ok=[y|n]]</span></dt><dd><p>To create or modify (overwrite) a user defined share.</p></dd><dt><span class="term">net usershare delete sharename</span></dt><dd><p>To delete a user defined share.</p></dd><dt><span class="term">net usershare list wildcard-sharename</span></dt><dd><p>To list user defined shares.</p></dd><dt><span class="term">net usershare info wildcard-sharename</span></dt><dd><p>To print information about user defined shares.</p></dd></dl></div></div><div class="refsect1" title="PARAMETERS"><a name="id2488001"></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="id2482019"></a><h2>PARAMETERS</h2><p>Parameters define the specific attributes of sections.</p><p>
    188188        Some parameters are specific to the [global] section (e.g., <span class="emphasis"><em>security</em></span>).  Some parameters
    189189        are usable in all sections (e.g., <span class="emphasis"><em>create mask</em></span>). All others are permissible only in normal
    … …  
    197197        find them! Where there are synonyms, the preferred synonym is described, others refer to the preferred
    198198        synonym.
    199         </p></div><div class="refsect1" title="VARIABLE SUBSTITUTIONS"><a name="id2538515"></a><h2>VARIABLE SUBSTITUTIONS</h2><p>
     199        </p></div><div class="refsect1" lang="en"><a name="id2532531"></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
    201         <span class="quote">&#8220;<span class="quote">path = /tmp/%u</span>&#8221;</span> is interpreted as <span class="quote">&#8220;<span class="quote">path = /tmp/john</span>&#8221;</span> if the user connected with the
     201        &#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
    202202        username john.
    203203        </p><p>
    … …  
    211211                        functionality to function as it did with Samba 2.x.
    212212                        </p></dd><dt><span class="term">%L</span></dt><dd><p>the NetBIOS name of the server. This allows you to change your config based on what
    213                         the client calls you. Your server can have a <span class="quote">&#8220;<span class="quote">dual personality</span>&#8221;</span>.
     213                        the client calls you. Your server can have a &#8220;<span class="quote">dual personality</span>&#8221;.
    214214                </p></dd><dt><span class="term">%M</span></dt><dd><p>the Internet name of the client machine.
    215215                </p></dd><dt><span class="term">%R</span></dt><dd><p>the selected protocol level after protocol negotiation. It can be one of CORE, COREPLUS,
    … …  
    239239        There are some quite creative things that can be done with these substitutions and other
    240240        <code class="filename">smb.conf</code> options.
    241         </p></div><div class="refsect1" title="NAME MANGLING"><a name="NAMEMANGLINGSECT"></a><h2>NAME MANGLING</h2><p>
     241        </p></div><div class="refsect1" lang="en"><a name="NAMEMANGLINGSECT"></a><h2>NAME MANGLING</h2><p>
    242242        Samba supports <code class="literal">name mangling</code> so that DOS and Windows clients can use files that don't
    243243        conform to the 8.3 format. It can also be set to adjust the case of 8.3 format filenames.
    … …  
    277277        then the "default case" option will be applied and will modify all filenames sent from the client
    278278        when accessing this share.
    279         </p></div><div class="refsect1" title="NOTE ABOUT USERNAME/PASSWORD VALIDATION"><a name="VALIDATIONSECT"></a><h2>NOTE ABOUT USERNAME/PASSWORD VALIDATION</h2><p>
     279        </p></div><div class="refsect1" lang="en"><a name="VALIDATIONSECT"></a><h2>NOTE ABOUT USERNAME/PASSWORD VALIDATION</h2><p>
    280280        There are a number of ways in which a user can connect to a service. The server uses the following steps
    281281        in determining if it will allow a connection to a specified service. If all the steps fail, the connection
    282282        request is rejected.  However, if one of the steps succeeds, the following steps are not checked.
    283283        </p><p>
    284         If the service is marked <span class="quote">&#8220;<span class="quote">guest only = yes</span>&#8221;</span> and the server is running with share-level
    285         security (<span class="quote">&#8220;<span class="quote">security = share</span>&#8221;</span>, steps 1 to 5 are skipped.
    286         </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
     284        If the service is marked &#8220;<span class="quote">guest only = yes</span>&#8221; and the server is running with share-level
     285        security (&#8220;<span class="quote">security = share</span>&#8221;, steps 1 to 5 are skipped.
     286        </p><div class="orderedlist"><ol type="1"><li><p>
    287287                If the client has passed a username/password pair and that username/password pair is validated by the UNIX
    288288                system's password programs, the connection is made as that username. This includes the
    289289                <code class="literal">\\server\service</code>%<em class="replaceable"><code>username</code></em> method of passing a username.
    290                 </p></li><li class="listitem"><p>
     290                </p></li><li><p>
    291291                If the client has previously registered a username with the system and now supplies a correct password for that
    292292                username, the connection is allowed.
    293                 </p></li><li class="listitem"><p>
     293                </p></li><li><p>
    294294                The client's NetBIOS name and any previously used usernames are checked against the supplied password. If
    295295                they match, the connection is allowed as the corresponding user.
    296                 </p></li><li class="listitem"><p>
     296                </p></li><li><p>
    297297                If the client has previously validated a username/password pair with the server and the client has passed
    298298                the validation token, that username is used.
    299                 </p></li><li class="listitem"><p>
     299                </p></li><li><p>
    300300                If a <code class="literal">user = </code> field is given in the <code class="filename">smb.conf</code> file for the
    301301                service and the client has supplied a password, and that password matches (according to the UNIX system's
    … …  
    303303                the username in the <code class="literal">user =</code> line. If one of the usernames in the <code class="literal">user =</code> list
    304304                begins with a <code class="literal">@</code>, that name expands to a list of names in the group of the same name.
    305                 </p></li><li class="listitem"><p>
     305                </p></li><li><p>
    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" title="REGISTRY-BASED CONFIGURATION"><a name="id2539216"></a><h2>REGISTRY-BASED CONFIGURATION</h2><p>
     308                </p></li></ol></div></div><div class="refsect1" lang="en"><a name="id2533232"></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.
    … …  
    312312                 <span class="emphasis"><em><code class="literal">HKLM\Software\Samba\smbconf</code></em></span>.
    313313                There are two levels of registry configuration:
    314         </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Share definitions stored in registry are used.
     314        </p><div class="orderedlist"><ol type="1"><li><p>Share definitions stored in registry are used.
    315315                This is triggered by setting the global
    316316                parameter <em class="parameter"><code>registry shares</code></em>
    317                 to <span class="quote">&#8220;<span class="quote">yes</span>&#8221;</span> in <span class="emphasis"><em>smb.conf</em></span>.
     317                to &#8220;<span class="quote">yes</span>&#8221; in <span class="emphasis"><em>smb.conf</em></span>.
    318318                </p><p>The registry shares are loaded not at startup but
    319319                on demand at runtime by <span class="emphasis"><em>smbd</em></span>.
    320320                Shares defined in <span class="emphasis"><em>smb.conf</em></span> take
    321321                priority over shares of the same name defined in
    322                 registry.</p></li><li class="listitem"><p>Global <span class="emphasis"><em>smb.conf</em></span>
     322                registry.</p></li><li><p>Global <span class="emphasis"><em>smb.conf</em></span>
    323323                options stored in registry are used. This can be activated
    324324                in two different ways:</p><p>Firstly, a registry only configuration is triggered
    … …  
    361361                accessing the database file, circumventing the
    362362                server.
    363         </p></div><div class="refsect1" title="EXPLANATION OF EACH PARAMETER"><a name="id2539391"></a><h2>EXPLANATION OF EACH PARAMETER</h2><div class="section"><div class="titlepage"></div><div class="section" title="abort shutdown script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2539402"></a>
     363        </p></div><div class="refsect1" lang="en"><a name="id2533407"></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="id2533418"></a>
    364364
    365365abort shutdown script (G)
    366 </h3></div></div></div><a class="indexterm" name="id2539403"></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="id2533419"></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" target="_top">shutdown script</a>.</p><p>If the connected user posseses the <code class="constant">SeRemoteShutdownPrivilege</code>,
    368368        right, this command will be run as root.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>abort shutdown script</code></em> = <code class="literal">""</code>
    … …  
    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" title="acl check permissions (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2539481"></a>
     372</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533498"></a>
    373373
    374374acl check permissions (S)
    375 </h3></div></div></div><a class="indexterm" name="id2539482"></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="id2533499"></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" title="acl compatibility (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2487333"></a>
     395</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2481353"></a>
    396396
    397397acl compatibility (G)
    398 </h3></div></div></div><a class="indexterm" name="id2487334"></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="id2481354"></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>.
    … …  
    405405</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>acl compatibility</code></em> = <code class="literal">win2k</code>
    406406</em></span>
    407 </p></dd></dl></div></div><div class="section" title="acl group control (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2487409"></a>
     407</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2481430"></a>
    408408
    409409acl group control (S)
    410 </h3></div></div></div><a class="indexterm" name="id2487410"></a><a name="ACLGROUPCONTROL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     410</h3></div></div></div><a class="indexterm" name="id2481431"></a><a name="ACLGROUPCONTROL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    411411        In a POSIX filesystem, only the owner of a file or directory and the superuser can modify the permissions
    412412        and ACLs on a file. If this parameter is set, then Samba overrides this restriction, and also allows the
    … …  
    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" title="acl map full control (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2539872"></a>
     437</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533889"></a>
    438438
    439439acl map full control (S)
    440 </h3></div></div></div><a class="indexterm" name="id2539873"></a><a name="ACLMAPFULLCONTROL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     440</h3></div></div></div><a class="indexterm" name="id2533890"></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" title="add group script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2539923"></a>
     448</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533940"></a>
    449449
    450450add group script (G)
    451 </h3></div></div></div><a class="indexterm" name="id2539924"></a><a name="ADDGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     451</h3></div></div></div><a class="indexterm" name="id2533941"></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" title="add machine script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2539998"></a>
     461</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534015"></a>
    462462
    463463add machine script (G)
    464 </h3></div></div></div><a class="indexterm" name="id2539999"></a><a name="ADDMACHINESCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     464</h3></div></div></div><a class="indexterm" name="id2534016"></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" title="add port command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2540077"></a>
     475</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534094"></a>
    476476
    477477add port command (G)
    478 </h3></div></div></div><a class="indexterm" name="id2540078"></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="id2534095"></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
    481481        smbd receives a request to add a new Port to the system.
    482         The script is passed two parameters:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="parameter"><code>port name</code></em></p></li><li class="listitem"><p><em class="parameter"><code>device URI</code></em></p></li></ul></div><p>The deviceURI is in the for of socket://&lt;hostname&gt;[:&lt;portnumber&gt;]
     482        The script is passed two parameters:</p><div class="itemizedlist"><ul type="disc"><li><p><em class="parameter"><code>port name</code></em></p></li><li><p><em class="parameter"><code>device URI</code></em></p></li></ul></div><p>The deviceURI is in the for of socket://&lt;hostname&gt;[:&lt;portnumber&gt;]
    483483        or lpd://&lt;hostname&gt;/&lt;queuename&gt;.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>add port command</code></em> = <code class="literal"></code>
    484484</em></span>
    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" title="addprinter command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2540161"></a>
     487</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534176"></a>
    488488
    489489addprinter command (G)
    490 </h3></div></div></div><a class="indexterm" name="id2540162"></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="id2534177"></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
    … …  
    502502    shared by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>.</p><p>The <em class="parameter"><code>addprinter command</code></em> is
    503503    automatically invoked with the following parameter (in
    504     order):</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="parameter"><code>printer name</code></em></p></li><li class="listitem"><p><em class="parameter"><code>share name</code></em></p></li><li class="listitem"><p><em class="parameter"><code>port name</code></em></p></li><li class="listitem"><p><em class="parameter"><code>driver name</code></em></p></li><li class="listitem"><p><em class="parameter"><code>location</code></em></p></li><li class="listitem"><p><em class="parameter"><code>Windows 9x driver location</code></em></p></li></ul></div><p>All parameters are filled in from the PRINTER_INFO_2 structure sent
     504    order):</p><div class="itemizedlist"><ul type="disc"><li><p><em class="parameter"><code>printer name</code></em></p></li><li><p><em class="parameter"><code>share name</code></em></p></li><li><p><em class="parameter"><code>port name</code></em></p></li><li><p><em class="parameter"><code>driver name</code></em></p></li><li><p><em class="parameter"><code>location</code></em></p></li><li><p><em class="parameter"><code>Windows 9x driver location</code></em></p></li></ul></div><p>All parameters are filled in from the PRINTER_INFO_2 structure sent
    505505    by the Windows NT/2000 client with one exception.  The "Windows 9x
    506506    driver location" parameter is included for backwards compatibility
    … …  
    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" title="add share command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2540350"></a>
     521</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534364"></a>
    522522
    523523add share command (G)
    524 </h3></div></div></div><a class="indexterm" name="id2540351"></a><a name="ADDSHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     524</h3></div></div></div><a class="indexterm" name="id2534365"></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
    … …  
    538538        When executed, <code class="literal">smbd</code> will automatically invoke the
    539539        <em class="parameter"><code>add share command</code></em> with five parameters.
    540         </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="parameter"><code>configFile</code></em> - the location of the global <code class="filename">smb.conf</code> file.
    541                         </p></li><li class="listitem"><p><em class="parameter"><code>shareName</code></em> - the name of the new share.
    542                         </p></li><li class="listitem"><p><em class="parameter"><code>pathName</code></em> - path to an **existing**
     540        </p><div class="itemizedlist"><ul type="disc"><li><p><em class="parameter"><code>configFile</code></em> - the location of the global <code class="filename">smb.conf</code> file.
     541                        </p></li><li><p><em class="parameter"><code>shareName</code></em> - the name of the new share.
     542                        </p></li><li><p><em class="parameter"><code>pathName</code></em> - path to an **existing**
    543543                        directory on disk.
    544                         </p></li><li class="listitem"><p><em class="parameter"><code>comment</code></em> - comment string to associate with the new
     544                        </p></li><li><p><em class="parameter"><code>comment</code></em> - comment string to associate with the new
    545545                        share.
    546                         </p></li><li class="listitem"><p><em class="parameter"><code>max
     546                        </p></li><li><p><em class="parameter"><code>max
    547547                        connections</code></em>
    548548                        Number of maximum simultaneous connections to this
    … …  
    554554</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>add share command</code></em> = <code class="literal">/usr/local/bin/addshare</code>
    555555</em></span>
    556 </p></dd></dl></div></div><div class="section" title="add user script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2540535"></a>
     556</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534551"></a>
    557557
    558558add user script (G)
    559 </h3></div></div></div><a class="indexterm" name="id2540536"></a><a name="ADDUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     559</h3></div></div></div><a class="indexterm" name="id2534552"></a><a name="ADDUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    560560        This is the full pathname to a script that will be run <span class="emphasis"><em>AS ROOT</em></span> by
    561561        <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>
    … …  
    592592</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>
    593593</em></span>
    594 </p></dd></dl></div></div><div class="section" title="add user to group script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2540746"></a>
     594</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534762"></a>
    595595
    596596add user to group script (G)
    597 </h3></div></div></div><a class="indexterm" name="id2540747"></a><a name="ADDUSERTOGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     597</h3></div></div></div><a class="indexterm" name="id2534763"></a><a name="ADDUSERTOGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    598598        Full path to the script that will be called when a user is added to a group using the Windows NT domain administration
    599599        tools. It will be run by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>
    … …  
    607607</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>
    608608</em></span>
    609 </p></dd></dl></div></div><div class="section" title="administrative share (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2540833"></a>
     609</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534849"></a>
    610610
    611611administrative share (S)
    612 </h3></div></div></div><a class="indexterm" name="id2540834"></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
     612</h3></div></div></div><a class="indexterm" name="id2534850"></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
    613613      a share, then the share will be an administrative share. The Administrative
    614614      Shares are the default network shares created by all Windows NT-based
    … …  
    617617      information about this option.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>administrative share</code></em> = <code class="literal">no</code>
    618618</em></span>
    619 </p></dd></dl></div></div><div class="section" title="admin users (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2540891"></a>
     619</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534907"></a>
    620620
    621621admin users (S)
    622 </h3></div></div></div><a class="indexterm" name="id2540892"></a><a name="ADMINUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of users who will be granted
     622</h3></div></div></div><a class="indexterm" name="id2534908"></a><a name="ADMINUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of users who will be granted
    623623    administrative privileges on the share. This means that they
    624624    will do all file operations as the super-user (root).</p><p>You should use this option very carefully, as any user in
    … …  
    629629</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>admin users</code></em> = <code class="literal">jason</code>
    630630</em></span>
    631 </p></dd></dl></div></div><div class="section" title="afs share (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2540963"></a>
     631</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534980"></a>
    632632
    633633afs share (S)
    634 </h3></div></div></div><a class="indexterm" name="id2540964"></a><a name="AFSSHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether special AFS features are enabled
     634</h3></div></div></div><a class="indexterm" name="id2534981"></a><a name="AFSSHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether special AFS features are enabled
    635635        for this share. If enabled, it assumes that the directory exported via
    636636        the <em class="parameter"><code>path</code></em> parameter is a local AFS import. The
    … …  
    639639        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>afs share</code></em> = <code class="literal">no</code>
    640640</em></span>
    641 </p></dd></dl></div></div><div class="section" title="afs username map (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2541011"></a>
     641</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535027"></a>
    642642
    643643afs username map (G)
    644 </h3></div></div></div><a class="indexterm" name="id2541012"></a><a name="AFSUSERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>If you are using the fake kaserver AFS feature, you might
     644</h3></div></div></div><a class="indexterm" name="id2535028"></a><a name="AFSUSERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>If you are using the fake kaserver AFS feature, you might
    645645        want to hand-craft the usernames you are creating tokens for.
    646646        For example this is necessary if you have users from several domain
    … …  
    652652</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>afs username map</code></em> = <code class="literal">%u@afs.samba.org</code>
    653653</em></span>
    654 </p></dd></dl></div></div><div class="section" title="aio read size (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2541073"></a>
     654</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535089"></a>
    655655
    656656aio read size (S)
    657 </h3></div></div></div><a class="indexterm" name="id2541074"></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
     657</h3></div></div></div><a class="indexterm" name="id2535090"></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
    658658    integer parameter is set to non-zero value,
    659659    Samba will read from file asynchronously when size of request is bigger
    … …  
    666666    request size</code>
    667667</em></span>
    668 </p></dd></dl></div></div><div class="section" title="aio write behind (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2541160"></a>
     668</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535176"></a>
    669669
    670670aio write behind (S)
    671 </h3></div></div></div><a class="indexterm" name="id2541161"></a><a name="AIOWRITEBEHIND"></a><div class="variablelist"><dl><dt></dt><dd><p>If Samba has been built with asynchronous I/O support,
     671</h3></div></div></div><a class="indexterm" name="id2535177"></a><a name="AIOWRITEBEHIND"></a><div class="variablelist"><dl><dt></dt><dd><p>If Samba has been built with asynchronous I/O support,
    672672        Samba will not wait until write requests are finished before returning
    673673        the result to the client for files listed in this parameter.
    … …  
    684684</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>aio write behind</code></em> = <code class="literal">/*.tmp/</code>
    685685</em></span>
    686 </p></dd></dl></div></div><div class="section" title="aio write size (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2541231"></a>
     686</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535247"></a>
    687687
    688688aio write size (S)
    689 </h3></div></div></div><a class="indexterm" name="id2541232"></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
     689</h3></div></div></div><a class="indexterm" name="id2535248"></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
    690690    integer parameter is set to non-zero value,
    691691    Samba will write to file asynchronously when size of request is bigger
    … …  
    698698    request size</code>
    699699</em></span>
    700 </p></dd></dl></div></div><div class="section" title="algorithmic rid base (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2541317"></a>
     700</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535333"></a>
    701701
    702702algorithmic rid base (G)
    703 </h3></div></div></div><a class="indexterm" name="id2541318"></a><a name="ALGORITHMICRIDBASE"></a><div class="variablelist"><dl><dt></dt><dd><p>This determines how Samba will use its
     703</h3></div></div></div><a class="indexterm" name="id2535334"></a><a name="ALGORITHMICRIDBASE"></a><div class="variablelist"><dl><dt></dt><dd><p>This determines how Samba will use its
    704704    algorithmic mapping from uids/gid to the RIDs needed to construct
    705705    NT Security Identifiers.
    … …  
    716716</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>algorithmic rid base</code></em> = <code class="literal">100000</code>
    717717</em></span>
    718 </p></dd></dl></div></div><div class="section" title="allocation roundup size (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2541387"></a>
     718</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535403"></a>
    719719
    720720allocation roundup size (S)
    721 </h3></div></div></div><a class="indexterm" name="id2541388"></a><a name="ALLOCATIONROUNDUPSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows an administrator to tune the
     721</h3></div></div></div><a class="indexterm" name="id2535404"></a><a name="ALLOCATIONROUNDUPSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows an administrator to tune the
    722722    allocation size reported to Windows clients.  The default
    723723    size of 1Mb generally results in improved Windows client
    … …  
    731731# (to disable roundups)</code>
    732732</em></span>
    733 </p></dd></dl></div></div><div class="section" title="allow trusted domains (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2541452"></a>
     733</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535468"></a>
    734734
    735735allow trusted domains (G)
    736 </h3></div></div></div><a class="indexterm" name="id2541453"></a><a name="ALLOWTRUSTEDDOMAINS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     736</h3></div></div></div><a class="indexterm" name="id2535469"></a><a name="ALLOWTRUSTEDDOMAINS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    737737    This option only takes effect when the <a class="link" href="smb.conf.5.html#SECURITY" target="_top">security</a> option is set to
    738738    <code class="constant">server</code>, <code class="constant">domain</code> or <code class="constant">ads</code>. 
    … …  
    749749    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>
    750750</em></span>
    751 </p></dd></dl></div></div><div class="section" title="announce as (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2541524"></a>
     751</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535540"></a>
    752752
    753753announce as (G)
    754 </h3></div></div></div><a class="indexterm" name="id2541525"></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
     754</h3></div></div></div><a class="indexterm" name="id2535541"></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
    755755    list. By default this is set to Windows NT. The valid options
    756756    are : "NT Server" (which can also be written as "NT"),
    … …  
    764764</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>announce as</code></em> = <code class="literal">Win95</code>
    765765</em></span>
    766 </p></dd></dl></div></div><div class="section" title="announce version (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2541593"></a>
     766</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535609"></a>
    767767
    768768announce version (G)
    769 </h3></div></div></div><a class="indexterm" name="id2541594"></a><a name="ANNOUNCEVERSION"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the major and minor version numbers
     769</h3></div></div></div><a class="indexterm" name="id2535610"></a><a name="ANNOUNCEVERSION"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the major and minor version numbers
    770770    that nmbd will use when announcing itself as a server. The default
    771771    is 4.9.  Do not change this parameter unless you have a specific
    … …  
    774774</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>announce version</code></em> = <code class="literal">2.0</code>
    775775</em></span>
    776 </p></dd></dl></div></div><div class="section" title="auth methods (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2541650"></a>
     776</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535666"></a>
    777777
    778778auth methods (G)
    779 </h3></div></div></div><a class="indexterm" name="id2541651"></a><a name="AUTHMETHODS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     779</h3></div></div></div><a class="indexterm" name="id2535667"></a><a name="AUTHMETHODS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    780780    This option allows the administrator to chose what authentication methods <code class="literal">smbd</code>
    781781    will use when authenticating a user. This option defaults to sensible values based on <a class="link" href="smb.conf.5.html#SECURITY" target="_top">security</a>. 
    … …  
    798798</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>auth methods</code></em> = <code class="literal">guest sam winbind</code>
    799799</em></span>
    800 </p></dd></dl></div></div><div class="section" title="available (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2541755"></a>
     800</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535772"></a>
    801801
    802802available (S)
    803 </h3></div></div></div><a class="indexterm" name="id2541756"></a><a name="AVAILABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter lets you "turn off" a service. If
     803</h3></div></div></div><a class="indexterm" name="id2535773"></a><a name="AVAILABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter lets you "turn off" a service. If
    804804        <em class="parameter"><code>available = no</code></em>, then <span class="emphasis"><em>ALL</em></span>
    805805        attempts to connect to the service will fail. Such failures are
    806806        logged.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>available</code></em> = <code class="literal">yes</code>
    807807</em></span>
    808 </p></dd></dl></div></div><div class="section" title="bind interfaces only (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2541803"></a>
     808</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535819"></a>
    809809
    810810bind interfaces only (G)
    811 </h3></div></div></div><a class="indexterm" name="id2541804"></a><a name="BINDINTERFACESONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This global parameter allows the Samba admin
     811</h3></div></div></div><a class="indexterm" name="id2535820"></a><a name="BINDINTERFACESONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This global parameter allows the Samba admin
    812812        to limit what interfaces on a machine will serve SMB requests. It
    813813        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>
    … …  
    850850        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>bind interfaces only</code></em> = <code class="literal">no</code>
    851851</em></span>
    852 </p></dd></dl></div></div><div class="section" title="blocking locks (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2542130"></a>
     852</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536146"></a>
    853853
    854854blocking locks (S)
    855 </h3></div></div></div><a class="indexterm" name="id2542131"></a><a name="BLOCKINGLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls the behavior
     855</h3></div></div></div><a class="indexterm" name="id2536148"></a><a name="BLOCKINGLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls the behavior
    856856        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
    857857        to obtain a byte range lock on a region of an open file, and the
    … …  
    864864        cannot be obtained.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>blocking locks</code></em> = <code class="literal">yes</code>
    865865</em></span>
    866 </p></dd></dl></div></div><div class="section" title="block size (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2542194"></a>
     866</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536211"></a>
    867867
    868868block size (S)
    869 </h3></div></div></div><a class="indexterm" name="id2542195"></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
     869</h3></div></div></div><a class="indexterm" name="id2536212"></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
    870870    sizes. By default, this reports a disk block size of 1024 bytes.
    871871    </p><p>Changing this parameter may have some effect on the
    … …  
    881881</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>block size</code></em> = <code class="literal">4096</code>
    882882</em></span>
    883 </p></dd></dl></div></div><div class="section" title="browsable"><div class="titlepage"><div><div><h3 class="title"><a name="id2542279"></a>
     883</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536295"></a>
    884884
    885885<a name="BROWSABLE"></a>browsable
    886 </h3></div></div></div><a class="indexterm" name="id2542280"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#BROWSEABLE">browseable</a>.</p></dd></dl></div></div><div class="section" title="browseable (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2542306"></a>
     886</h3></div></div></div><a class="indexterm" name="id2536296"></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="id2536322"></a>
    887887
    888888browseable (S)
    889 </h3></div></div></div><a class="indexterm" name="id2542307"></a><a name="BROWSEABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether this share is seen in
     889</h3></div></div></div><a class="indexterm" name="id2536323"></a><a name="BROWSEABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether this share is seen in
    890890        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>
    891891</em></span>
    892 </p></dd></dl></div></div><div class="section" title="browse list (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2542345"></a>
     892</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536361"></a>
    893893
    894894browse list (G)
    895 </h3></div></div></div><a class="indexterm" name="id2542346"></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
     895</h3></div></div></div><a class="indexterm" name="id2536362"></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
    896896        a client doing a <code class="literal">NetServerEnum</code> call. Normally
    897897        set to <code class="constant">yes</code>. You should never need to change
    898898        this.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>browse list</code></em> = <code class="literal">yes</code>
    899899</em></span>
    900 </p></dd></dl></div></div><div class="section" title="casesignames"><div class="titlepage"><div><div><h3 class="title"><a name="id2542399"></a>
     900</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536415"></a>
    901901
    902902<a name="CASESIGNAMES"></a>casesignames
    903 </h3></div></div></div><a class="indexterm" name="id2542400"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#CASESENSITIVE">case sensitive</a>.</p></dd></dl></div></div><div class="section" title="case sensitive (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2542426"></a>
     903</h3></div></div></div><a class="indexterm" name="id2536416"></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="id2536442"></a>
    904904
    905905case sensitive (S)
    906 </h3></div></div></div><a class="indexterm" name="id2542427"></a><a name="CASESENSITIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>See the discussion in the section <a class="link" href="smb.conf.5.html#NAMEMANGLING" target="_top">name mangling</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>case sensitive</code></em> = <code class="literal">no</code>
    907 </em></span>
    908 </p></dd></dl></div></div><div class="section" title="change notify (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2542473"></a>
     906</h3></div></div></div><a class="indexterm" name="id2536443"></a><a name="CASESENSITIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>See the discussion in the section <a class="link" href="smb.conf.5.html#NAMEMANGLING" target="_top">name mangling</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>case sensitive</code></em> = <code class="literal">no</code>
     907</em></span>
     908</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536489"></a>
    909909
    910910change notify (S)
    911 </h3></div></div></div><a class="indexterm" name="id2542474"></a><a name="CHANGENOTIFY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should reply
     911</h3></div></div></div><a class="indexterm" name="id2536490"></a><a name="CHANGENOTIFY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should reply
    912912        to a client's file change notify requests.
    913913        </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>
    914914</em></span>
    915 </p></dd></dl></div></div><div class="section" title="change share command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2542515"></a>
     915</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536532"></a>
    916916
    917917change share command (G)
    918 </h3></div></div></div><a class="indexterm" name="id2542516"></a><a name="CHANGESHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     918</h3></div></div></div><a class="indexterm" name="id2536533"></a><a name="CHANGESHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    919919        Samba 2.2.0 introduced the ability to dynamically add and delete shares via the Windows NT 4.0 Server
    920920Manager.  The <em class="parameter"><code>change share command</code></em> is used to define an external
    … …  
    931931        When executed, <code class="literal">smbd</code> will automatically invoke the
    932932        <em class="parameter"><code>change share command</code></em> with five parameters.
    933         </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="parameter"><code>configFile</code></em> - the location
     933        </p><div class="itemizedlist"><ul type="disc"><li><p><em class="parameter"><code>configFile</code></em> - the location
    934934                        of the global <code class="filename">smb.conf</code> file.
    935                         </p></li><li class="listitem"><p><em class="parameter"><code>shareName</code></em> - the name of the new
     935                        </p></li><li><p><em class="parameter"><code>shareName</code></em> - the name of the new
    936936                        share.
    937                         </p></li><li class="listitem"><p><em class="parameter"><code>pathName</code></em> - path to an **existing**
     937                        </p></li><li><p><em class="parameter"><code>pathName</code></em> - path to an **existing**
    938938                        directory on disk.
    939                         </p></li><li class="listitem"><p><em class="parameter"><code>comment</code></em> - comment string to associate
     939                        </p></li><li><p><em class="parameter"><code>comment</code></em> - comment string to associate
    940940                        with the new share.
    941                         </p></li><li class="listitem"><p><em class="parameter"><code>max
     941                        </p></li><li><p><em class="parameter"><code>max
    942942                        connections</code></em>
    943943                        Number of maximum simultaneous connections to this
    … …  
    951951</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>change share command</code></em> = <code class="literal">/usr/local/bin/changeshare</code>
    952952</em></span>
    953 </p></dd></dl></div></div><div class="section" title="check password script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2542694"></a>
     953</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536710"></a>
    954954
    955955check password script (G)
    956 </h3></div></div></div><a class="indexterm" name="id2542695"></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
     956</h3></div></div></div><a class="indexterm" name="id2536711"></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
    957957    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
    958958    if the password is bad.
    … …  
    963963</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>check password script</code></em> = <code class="literal">/usr/local/sbin/crackcheck</code>
    964964</em></span>
    965 </p></dd></dl></div></div><div class="section" title="client lanman auth (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2542767"></a>
     965</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536784"></a>
    966966
    967967client lanman auth (G)
    968 </h3></div></div></div><a class="indexterm" name="id2542768"></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
     968</h3></div></div></div><a class="indexterm" name="id2536785"></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
    969969    tools will attempt to authenticate itself to servers using the
    970970    weaker LANMAN password hash. If disabled, only server which support NT
    … …  
    977977    attempted.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client lanman auth</code></em> = <code class="literal">no</code>
    978978</em></span>
    979 </p></dd></dl></div></div><div class="section" title="client ldap sasl wrapping (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2542843"></a>
     979</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536860"></a>
    980980
    981981client ldap sasl wrapping (G)
    982 </h3></div></div></div><a class="indexterm" name="id2542844"></a><a name="CLIENTLDAPSASLWRAPPING"></a><div class="variablelist"><dl><dt></dt><dd><p>
     982</h3></div></div></div><a class="indexterm" name="id2536861"></a><a name="CLIENTLDAPSASLWRAPPING"></a><div class="variablelist"><dl><dt></dt><dd><p>
    983983        The <a class="link" href="smb.conf.5.html#CLIENTLDAPSASLWRAPPING" target="_top">client ldap sasl wrapping</a> defines whether
    984984        ldap traffic will be signed or signed and encrypted (sealed).
    … …  
    10081008        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client ldap sasl wrapping</code></em> = <code class="literal">plain</code>
    10091009</em></span>
    1010 </p></dd></dl></div></div><div class="section" title="client ntlmv2 auth (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2542959"></a>
     1010</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536975"></a>
    10111011
    10121012client ntlmv2 auth (G)
    1013 </h3></div></div></div><a class="indexterm" name="id2542960"></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
     1013</h3></div></div></div><a class="indexterm" name="id2536976"></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
    10141014    authenticate itself to servers using the NTLMv2 encrypted password
    10151015    response.</p><p>If enabled, only an NTLMv2 and LMv2 response (both much more
    … …  
    10231023        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>
    10241024</em></span>
    1025 </p></dd></dl></div></div><div class="section" title="client plaintext auth (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2543046"></a>
     1025</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537063"></a>
    10261026
    10271027client plaintext auth (G)
    1028 </h3></div></div></div><a class="indexterm" name="id2543047"></a><a name="CLIENTPLAINTEXTAUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies whether a client should send a plaintext
     1028</h3></div></div></div><a class="indexterm" name="id2537064"></a><a name="CLIENTPLAINTEXTAUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies whether a client should send a plaintext
    10291029                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>
    10301030</em></span>
    1031 </p></dd></dl></div></div><div class="section" title="client schannel (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2543086"></a>
     1031</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537102"></a>
    10321032
    10331033client schannel (G)
    1034 </h3></div></div></div><a class="indexterm" name="id2543087"></a><a name="CLIENTSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1034</h3></div></div></div><a class="indexterm" name="id2537103"></a><a name="CLIENTSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    10351035    This controls whether the client offers or even demands the use of the netlogon schannel.
    10361036    <a class="link" href="smb.conf.5.html#CLIENTSCHANNEL" target="_top">client schannel = no</a> does not offer the schannel,
    … …  
    10421042</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>client schannel</code></em> = <code class="literal">yes</code>
    10431043</em></span>
    1044 </p></dd></dl></div></div><div class="section" title="client signing (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2543170"></a>
     1044</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537186"></a>
    10451045
    10461046client signing (G)
    1047 </h3></div></div></div><a class="indexterm" name="id2543171"></a><a name="CLIENTSIGNING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether the client is allowed or required to use SMB signing. Possible values
     1047</h3></div></div></div><a class="indexterm" name="id2537187"></a><a name="CLIENTSIGNING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether the client is allowed or required to use SMB signing. Possible values
    10481048    are <span class="emphasis"><em>auto</em></span>, <span class="emphasis"><em>mandatory</em></span>
    10491049    and <span class="emphasis"><em>disabled</em></span>.
    … …  
    10531053</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client signing</code></em> = <code class="literal">auto</code>
    10541054</em></span>
    1055 </p></dd></dl></div></div><div class="section" title="client use spnego (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2543224"></a>
     1055</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537240"></a>
    10561056
    10571057client use spnego (G)
    1058 </h3></div></div></div><a class="indexterm" name="id2543225"></a><a name="CLIENTUSESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p> This variable controls whether Samba clients will try
     1058</h3></div></div></div><a class="indexterm" name="id2537242"></a><a name="CLIENTUSESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p> This variable controls whether Samba clients will try
    10591059    to use Simple and Protected NEGOciation (as specified by rfc2478) with
    10601060    supporting servers (including WindowsXP, Windows2000 and Samba
    … …  
    10621062    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>
    10631063</em></span>
    1064 </p></dd></dl></div></div><div class="section" title="cluster addresses (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2543266"></a>
     1064</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537282"></a>
    10651065
    10661066cluster addresses (G)
    1067 </h3></div></div></div><a class="indexterm" name="id2543267"></a><a name="CLUSTERADDRESSES"></a><div class="variablelist"><dl><dt></dt><dd><p>With this parameter you can add additional addresses
     1067</h3></div></div></div><a class="indexterm" name="id2537284"></a><a name="CLUSTERADDRESSES"></a><div class="variablelist"><dl><dt></dt><dd><p>With this parameter you can add additional addresses
    10681068        nmbd will register with a WINS server. These addresses are not
    10691069        necessarily present on all nodes simultaneously, but they will
    … …  
    10741074</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>
    10751075</em></span>
    1076 </p></dd></dl></div></div><div class="section" title="clustering (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2543322"></a>
     1076</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537338"></a>
    10771077
    10781078clustering (G)
    1079 </h3></div></div></div><a class="indexterm" name="id2543323"></a><a name="CLUSTERING"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should contact
     1079</h3></div></div></div><a class="indexterm" name="id2537340"></a><a name="CLUSTERING"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should contact
    10801080        ctdb for accessing its tdb files and use ctdb as a backend
    10811081        for its messaging backend.
    … …  
    10841084        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>clustering</code></em> = <code class="literal">no</code>
    10851085</em></span>
    1086 </p></dd></dl></div></div><div class="section" title="comment (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2543371"></a>
     1086</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537387"></a>
    10871087
    10881088comment (S)
    1089 </h3></div></div></div><a class="indexterm" name="id2543372"></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
     1089</h3></div></div></div><a class="indexterm" name="id2537388"></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
    10901090        when a client does a queries the server, either via the network
    10911091        neighborhood or via <code class="literal">net view</code> to list what shares
    … …  
    10961096</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>comment</code></em> = <code class="literal">Fred's Files</code>
    10971097</em></span>
    1098 </p></dd></dl></div></div><div class="section" title="config backend (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2543445"></a>
     1098</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537462"></a>
    10991099
    11001100config backend (G)
    1101 </h3></div></div></div><a class="indexterm" name="id2543446"></a><a name="CONFIGBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1101</h3></div></div></div><a class="indexterm" name="id2537463"></a><a name="CONFIGBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    11021102                This controls the backend for storing the configuration.
    11031103                Possible values are <span class="emphasis"><em>file</em></span> (the default)
    … …  
    11171117</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>config backend</code></em> = <code class="literal">registry</code>
    11181118</em></span>
    1119 </p></dd></dl></div></div><div class="section" title="config file (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2543534"></a>
     1119</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537551"></a>
    11201120
    11211121config file (G)
    1122 </h3></div></div></div><a class="indexterm" name="id2543535"></a><a name="CONFIGFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the config file
     1122</h3></div></div></div><a class="indexterm" name="id2537552"></a><a name="CONFIGFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the config file
    11231123        to use, instead of the default (usually <code class="filename">smb.conf</code>).
    11241124        There is a chicken and egg problem here as this option is set
    … …  
    11301130        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>
    11311131</em></span>
    1132 </p></dd></dl></div></div><div class="section" title="copy (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2543600"></a>
     1132</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537616"></a>
    11331133
    11341134copy (S)
    1135 </h3></div></div></div><a class="indexterm" name="id2543601"></a><a name="COPY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows you to "clone" service
     1135</h3></div></div></div><a class="indexterm" name="id2537617"></a><a name="COPY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows you to "clone" service
    11361136        entries. The specified service is simply duplicated under the
    11371137        current service's name. Any parameters specified in the current
    … …  
    11431143</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>copy</code></em> = <code class="literal">otherservice</code>
    11441144</em></span>
    1145 </p></dd></dl></div></div><div class="section" title="create mode"><div class="titlepage"><div><div><h3 class="title"><a name="id2543662"></a>
     1145</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537678"></a>
    11461146
    11471147<a name="CREATEMODE"></a>create mode
    1148 </h3></div></div></div><a class="indexterm" name="id2543663"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#CREATEMASK">create mask</a>.</p></dd></dl></div></div><div class="section" title="create mask (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2543689"></a>
     1148</h3></div></div></div><a class="indexterm" name="id2537680"></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="id2537705"></a>
    11491149
    11501150create mask (S)
    1151 </h3></div></div></div><a class="indexterm" name="id2543690"></a><a name="CREATEMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1151</h3></div></div></div><a class="indexterm" name="id2537706"></a><a name="CREATEMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
    11521152        When a file is created, the necessary permissions are calculated according to the mapping from DOS modes to
    11531153        UNIX permissions, and the resulting UNIX mode is then bit-wise 'AND'ed with this parameter. This parameter may
    … …  
    11701170</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>create mask</code></em> = <code class="literal">0775</code>
    11711171</em></span>
    1172 </p></dd></dl></div></div><div class="section" title="csc policy (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2543810"></a>
     1172</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537827"></a>
    11731173
    11741174csc policy (S)
    1175 </h3></div></div></div><a class="indexterm" name="id2543811"></a><a name="CSCPOLICY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1175</h3></div></div></div><a class="indexterm" name="id2537828"></a><a name="CSCPOLICY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    11761176        This stands for <span class="emphasis"><em>client-side caching policy</em></span>, and specifies how clients capable of offline
    11771177        caching will cache the files in the share. The valid values are: manual, documents, programs, disable.
    … …  
    11851185</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>csc policy</code></em> = <code class="literal">programs</code>
    11861186</em></span>
    1187 </p></dd></dl></div></div><div class="section" title="ctdbd socket (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2543886"></a>
     1187</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537902"></a>
    11881188
    11891189ctdbd socket (G)
    1190 </h3></div></div></div><a class="indexterm" name="id2543887"></a><a name="CTDBDSOCKET"></a><div class="variablelist"><dl><dt></dt><dd><p>If you set <code class="literal">clustering=yes</code>,
     1190</h3></div></div></div><a class="indexterm" name="id2537903"></a><a name="CTDBDSOCKET"></a><div class="variablelist"><dl><dt></dt><dd><p>If you set <code class="literal">clustering=yes</code>,
    11911191        you need to tell Samba where ctdbd listens on its unix domain
    11921192        socket. The default path as of ctdb 1.0 is /tmp/ctdb.socket which
    … …  
    11961196</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ctdbd socket</code></em> = <code class="literal">/tmp/ctdb.socket</code>
    11971197</em></span>
    1198 </p></dd></dl></div></div><div class="section" title="cups connection timeout (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2543946"></a>
     1198</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537962"></a>
    11991199
    12001200cups connection timeout (G)
    1201 </h3></div></div></div><a class="indexterm" name="id2543947"></a><a name="CUPSCONNECTIONTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1201</h3></div></div></div><a class="indexterm" name="id2537963"></a><a name="CUPSCONNECTIONTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12021202    This parameter is only applicable if <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing</a> is set to <code class="constant">cups</code>.
    12031203    </p><p>
    … …  
    12091209</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>cups connection timeout</code></em> = <code class="literal">60</code>
    12101210</em></span>
    1211 </p></dd></dl></div></div><div class="section" title="cups options (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2544018"></a>
     1211</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538034"></a>
    12121212
    12131213cups options (S)
    1214 </h3></div></div></div><a class="indexterm" name="id2544019"></a><a name="CUPSOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1214</h3></div></div></div><a class="indexterm" name="id2538035"></a><a name="CUPSOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12151215    This parameter is only applicable if <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing</a> is
    12161216    set to <code class="constant">cups</code>.  Its value is a free form string of options
    … …  
    12341234</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>cups options</code></em> = <code class="literal">"raw media=a4"</code>
    12351235</em></span>
    1236 </p></dd></dl></div></div><div class="section" title="cups server (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2544116"></a>
     1236</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538132"></a>
    12371237
    12381238cups server (G)
    1239 </h3></div></div></div><a class="indexterm" name="id2544117"></a><a name="CUPSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1239</h3></div></div></div><a class="indexterm" name="id2538133"></a><a name="CUPSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12401240    This parameter is only applicable if <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing</a> is set to <code class="constant">cups</code>.
    12411241    </p><p>
    … …  
    12511251</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>cups server</code></em> = <code class="literal">mycupsserver:1631</code>
    12521252</em></span>
    1253 </p></dd></dl></div></div><div class="section" title="deadtime (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2544214"></a>
     1253</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538230"></a>
    12541254
    12551255deadtime (G)
    1256 </h3></div></div></div><a class="indexterm" name="id2544215"></a><a name="DEADTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a decimal integer)
     1256</h3></div></div></div><a class="indexterm" name="id2538231"></a><a name="DEADTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a decimal integer)
    12571257    represents the number of minutes of inactivity before a connection
    12581258    is considered dead, and it is disconnected. The deadtime only takes
    … …  
    12661266</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>deadtime</code></em> = <code class="literal">15</code>
    12671267</em></span>
    1268 </p></dd></dl></div></div><div class="section" title="debug class (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2544290"></a>
     1268</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538307"></a>
    12691269
    12701270debug class (G)
    1271 </h3></div></div></div><a class="indexterm" name="id2544292"></a><a name="DEBUGCLASS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1271</h3></div></div></div><a class="indexterm" name="id2538308"></a><a name="DEBUGCLASS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12721272    With this boolean parameter enabled, the debug class (DBGC_CLASS)
    12731273    will be displayed in the debug header.
    … …  
    12771277    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug class</code></em> = <code class="literal">no</code>
    12781278</em></span>
    1279 </p></dd></dl></div></div><div class="section" title="debug hires timestamp (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2544342"></a>
     1279</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538358"></a>
    12801280
    12811281debug hires timestamp (G)
    1282 </h3></div></div></div><a class="indexterm" name="id2544343"></a><a name="DEBUGHIRESTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1282</h3></div></div></div><a class="indexterm" name="id2538359"></a><a name="DEBUGHIRESTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12831283    Sometimes the timestamps in the log messages are needed with a resolution of higher that seconds, this
    12841284    boolean parameter adds microsecond resolution to the timestamp  message header when turned on.
    … …  
    12871287    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug hires timestamp</code></em> = <code class="literal">no</code>
    12881288</em></span>
    1289 </p></dd></dl></div></div><div class="section" title="debug pid (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2544397"></a>
     1289</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538413"></a>
    12901290
    12911291debug pid (G)
    1292 </h3></div></div></div><a class="indexterm" name="id2544398"></a><a name="DEBUGPID"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1292</h3></div></div></div><a class="indexterm" name="id2538414"></a><a name="DEBUGPID"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12931293    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
    12941294    message. This boolean parameter is adds the process-id to the timestamp message headers in the
    … …  
    12981298    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug pid</code></em> = <code class="literal">no</code>
    12991299</em></span>
    1300 </p></dd></dl></div></div><div class="section" title="debug prefix timestamp (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2544459"></a>
     1300</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538475"></a>
    13011301
    13021302debug prefix timestamp (G)
    1303 </h3></div></div></div><a class="indexterm" name="id2544460"></a><a name="DEBUGPREFIXTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1303</h3></div></div></div><a class="indexterm" name="id2538476"></a><a name="DEBUGPREFIXTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    13041304    With this option enabled, the timestamp message header is prefixed to the debug message without the
    13051305    filename and function information that is included with the <a class="link" href="smb.conf.5.html#DEBUGTIMESTAMP" target="_top">debug timestamp</a>
    … …  
    13091309    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug prefix timestamp</code></em> = <code class="literal">no</code>
    13101310</em></span>
    1311 </p></dd></dl></div></div><div class="section" title="timestamp logs"><div class="titlepage"><div><div><h3 class="title"><a name="id2544522"></a>
     1311</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538538"></a>
    13121312
    13131313<a name="TIMESTAMPLOGS"></a>timestamp logs
    1314 </h3></div></div></div><a class="indexterm" name="id2544523"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#DEBUGTIMESTAMP">debug timestamp</a>.</p></dd></dl></div></div><div class="section" title="debug timestamp (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2544549"></a>
     1314</h3></div></div></div><a class="indexterm" name="id2538539"></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="id2538565"></a>
    13151315
    13161316debug timestamp (G)
    1317 </h3></div></div></div><a class="indexterm" name="id2544550"></a><a name="DEBUGTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1317</h3></div></div></div><a class="indexterm" name="id2538566"></a><a name="DEBUGTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    13181318    Samba debug log messages are timestamped by default. If you are running at a high
    13191319    <a class="link" href="smb.conf.5.html#DEBUGLEVEL" target="_top">debug level</a> these timestamps can be distracting. This
    … …  
    13211321        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug timestamp</code></em> = <code class="literal">yes</code>
    13221322</em></span>
    1323 </p></dd></dl></div></div><div class="section" title="debug uid (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2544597"></a>
     1323</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538614"></a>
    13241324
    13251325debug uid (G)
    1326 </h3></div></div></div><a class="indexterm" name="id2544598"></a><a name="DEBUGUID"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1326</h3></div></div></div><a class="indexterm" name="id2538615"></a><a name="DEBUGUID"></a><div class="variablelist"><dl><dt></dt><dd><p>
    13271327    Samba is sometimes run as root and sometime run as the connected user, this boolean parameter inserts the
    13281328    current euid, egid, uid and gid to the timestamp message headers in the log file if turned on.
    … …  
    13311331    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug uid</code></em> = <code class="literal">no</code>
    13321332</em></span>
    1333 </p></dd></dl></div></div><div class="section" title="default case (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2544651"></a>
     1333</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538667"></a>
    13341334
    13351335default case (S)
    1336 </h3></div></div></div><a class="indexterm" name="id2544652"></a><a name="DEFAULTCASE"></a><div class="variablelist"><dl><dt></dt><dd><p>See the section on <a class="link" href="smb.conf.5.html#NAMEMANGLING" target="_top">name mangling</a>.
     1336</h3></div></div></div><a class="indexterm" name="id2538668"></a><a name="DEFAULTCASE"></a><div class="variablelist"><dl><dt></dt><dd><p>See the section on <a class="link" href="smb.conf.5.html#NAMEMANGLING" target="_top">name mangling</a>.
    13371337        Also note the <a class="link" href="smb.conf.5.html#SHORTPRESERVECASE" target="_top">short preserve case</a> parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>default case</code></em> = <code class="literal">lower</code>
    13381338</em></span>
    1339 </p></dd></dl></div></div><div class="section" title="default devmode (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2544705"></a>
     1339</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538721"></a>
    13401340
    13411341default devmode (S)
    1342 </h3></div></div></div><a class="indexterm" name="id2544706"></a><a name="DEFAULTDEVMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only applicable to <a class="link" href="smb.conf.5.html#PRINTABLE" target="_top">printable</a> services.
     1342</h3></div></div></div><a class="indexterm" name="id2538722"></a><a name="DEFAULTDEVMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only applicable to <a class="link" href="smb.conf.5.html#PRINTABLE" target="_top">printable</a> services.
    13431343    When smbd is serving Printer Drivers to Windows NT/2k/XP clients, each printer on the Samba
    13441344    server has a Device Mode which defines things such as paper size and
    … …  
    13631363</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>default devmode</code></em> = <code class="literal">yes</code>
    13641364</em></span>
    1365 </p></dd></dl></div></div><div class="section" title="default"><div class="titlepage"><div><div><h3 class="title"><a name="id2544801"></a>
     1365</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538818"></a>
    13661366
    13671367<a name="DEFAULT"></a>default
    1368 </h3></div></div></div><a class="indexterm" name="id2544802"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#DEFAULTSERVICE">default service</a>.</p></dd></dl></div></div><div class="section" title="default service (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2544828"></a>
     1368</h3></div></div></div><a class="indexterm" name="id2538819"></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="id2538845"></a>
    13691369
    13701370default service (G)
    1371 </h3></div></div></div><a class="indexterm" name="id2544829"></a><a name="DEFAULTSERVICE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the name of a service
     1371</h3></div></div></div><a class="indexterm" name="id2538846"></a><a name="DEFAULTSERVICE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the name of a service
    13721372        which will be connected to if the service actually requested cannot
    13731373        be found. Note that the square brackets are <span class="emphasis"><em>NOT</em></span>
    … …  
    13831383</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>default service</code></em> = <code class="literal">pub</code>
    13841384</em></span>
    1385 </p></dd></dl></div></div><div class="section" title="defer sharing violations (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2544930"></a>
     1385</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538946"></a>
    13861386
    13871387defer sharing violations (G)
    1388 </h3></div></div></div><a class="indexterm" name="id2544931"></a><a name="DEFERSHARINGVIOLATIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1388</h3></div></div></div><a class="indexterm" name="id2538947"></a><a name="DEFERSHARINGVIOLATIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    13891389        Windows allows specifying how a file will be shared with
    13901390        other processes when it is opened. Sharing violations occur when
    … …  
    13991399        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>defer sharing violations</code></em> = <code class="literal">True</code>
    14001400</em></span>
    1401 </p></dd></dl></div></div><div class="section" title="delete group script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2544985"></a>
     1401</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539001"></a>
    14021402
    14031403delete group script (G)
    1404 </h3></div></div></div><a class="indexterm" name="id2544986"></a><a name="DELETEGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the full pathname to a script that will
     1404</h3></div></div></div><a class="indexterm" name="id2539002"></a><a name="DELETEGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the full pathname to a script that will
    14051405        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.
    14061406        It will expand any <em class="parameter"><code>%g</code></em> to the group name passed. 
    … …  
    14081408        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>delete group script</code></em> = <code class="literal"></code>
    14091409</em></span>
    1410 </p></dd></dl></div></div><div class="section" title="deleteprinter command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2545041"></a>
     1410</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539057"></a>
    14111411
    14121412deleteprinter command (G)
    1413 </h3></div></div></div><a class="indexterm" name="id2545042"></a><a name="DELETEPRINTERCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printer
     1413</h3></div></div></div><a class="indexterm" name="id2539058"></a><a name="DELETEPRINTERCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printer
    14141414    support for Windows NT/2000 clients in Samba 2.2, it is now
    14151415    possible to delete a printer at run time by issuing the
    … …  
    14291429</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>deleteprinter command</code></em> = <code class="literal">/usr/bin/removeprinter</code>
    14301430</em></span>
    1431 </p></dd></dl></div></div><div class="section" title="delete readonly (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2545168"></a>
     1431</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539185"></a>
    14321432
    14331433delete readonly (S)
    1434 </h3></div></div></div><a class="indexterm" name="id2545169"></a><a name="DELETEREADONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows readonly files to be deleted. 
     1434</h3></div></div></div><a class="indexterm" name="id2539186"></a><a name="DELETEREADONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows readonly files to be deleted. 
    14351435        This is not normal DOS semantics, but is allowed by UNIX.</p><p>This option may be useful for running applications such
    14361436        as rcs, where UNIX file ownership prevents changing file
    14371437        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>
    14381438</em></span>
    1439 </p></dd></dl></div></div><div class="section" title="delete share command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2545214"></a>
     1439</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539230"></a>
    14401440
    14411441delete share command (G)
    1442 </h3></div></div></div><a class="indexterm" name="id2545215"></a><a name="DELETESHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1442</h3></div></div></div><a class="indexterm" name="id2539231"></a><a name="DELETESHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    14431443        Samba 2.2.0 introduced the ability to dynamically add and delete shares via the Windows NT 4.0 Server
    14441444        Manager.  The <em class="parameter"><code>delete share command</code></em> is used to define an external
    … …  
    14551455        When executed, <code class="literal">smbd</code> will automatically invoke the
    14561456        <em class="parameter"><code>delete share command</code></em> with two parameters.
    1457         </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="parameter"><code>configFile</code></em> - the location
     1457        </p><div class="itemizedlist"><ul type="disc"><li><p><em class="parameter"><code>configFile</code></em> - the location
    14581458                        of the global <code class="filename">smb.conf</code> file.
    1459                         </p></li><li class="listitem"><p><em class="parameter"><code>shareName</code></em> - the name of
     1459                        </p></li><li><p><em class="parameter"><code>shareName</code></em> - the name of
    14601460                        the existing service.
    14611461                        </p></li></ul></div><p>
    … …  
    14661466</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>delete share command</code></em> = <code class="literal">/usr/local/bin/delshare</code>
    14671467</em></span>
    1468 </p></dd></dl></div></div><div class="section" title="delete user from group script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2545365"></a>
     1468</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539382"></a>
    14691469
    14701470delete user from group script (G)
    1471 </h3></div></div></div><a class="indexterm" name="id2545366"></a><a name="DELETEUSERFROMGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>Full path to the script that will be called when
     1471</h3></div></div></div><a class="indexterm" name="id2539383"></a><a name="DELETEUSERFROMGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>Full path to the script that will be called when
    14721472        a user is removed from a group using the Windows NT domain administration
    14731473        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>.
    … …  
    14781478</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>
    14791479</em></span>
    1480 </p></dd></dl></div></div><div class="section" title="delete user script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2545445"></a>
     1480</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539461"></a>
    14811481
    14821482delete user script (G)
    1483 </h3></div></div></div><a class="indexterm" name="id2545446"></a><a name="DELETEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the full pathname to a script that will
     1483</h3></div></div></div><a class="indexterm" name="id2539462"></a><a name="DELETEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the full pathname to a script that will
    14841484        be run by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when managing users
    14851485        with remote RPC (NT) tools.
    … …  
    14901490</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>
    14911491</em></span>
    1492 </p></dd></dl></div></div><div class="section" title="delete veto files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2545522"></a>
     1492</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539538"></a>
    14931493
    14941494delete veto files (S)
    1495 </h3></div></div></div><a class="indexterm" name="id2545523"></a><a name="DELETEVETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used when Samba is attempting to
     1495</h3></div></div></div><a class="indexterm" name="id2539539"></a><a name="DELETEVETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used when Samba is attempting to
    14961496        delete a directory that contains one or more vetoed directories
    14971497        (see the <a class="link" href="smb.conf.5.html#VETOFILES" target="_top">veto files</a>
    … …  
    15071507        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>
    15081508</em></span>
    1509 </p></dd></dl></div></div><div class="section" title="dfree cache time (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2545607"></a>
     1509</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539623"></a>
    15101510
    15111511dfree cache time (S)
    1512 </h3></div></div></div><a class="indexterm" name="id2545608"></a><a name="DFREECACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1512</h3></div></div></div><a class="indexterm" name="id2539624"></a><a name="DFREECACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    15131513        The <em class="parameter"><code>dfree cache time</code></em> should only be used on systems where a problem
    15141514        occurs with the internal disk space calculations. This has been known to happen with Ultrix, but may occur
    … …  
    15231523        </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>
    15241524</em></span>
    1525 </p></dd></dl></div></div><div class="section" title="dfree command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2545680"></a>
     1525</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539696"></a>
    15261526
    15271527dfree command (S)
    1528 </h3></div></div></div><a class="indexterm" name="id2545681"></a><a name="DFREECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1528</h3></div></div></div><a class="indexterm" name="id2539697"></a><a name="DFREECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    15291529        The <em class="parameter"><code>dfree command</code></em> setting should only be used on systems where a
    15301530        problem occurs with the internal disk space calculations. This has been known to happen with Ultrix, but may
    … …  
    15641564        </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>
    15651565</em></span>
    1566 </p></dd></dl></div></div><div class="section" title="directory mode"><div class="titlepage"><div><div><h3 class="title"><a name="id2545801"></a>
     1566</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539817"></a>
    15671567
    15681568<a name="DIRECTORYMODE"></a>directory mode
    1569 </h3></div></div></div><a class="indexterm" name="id2545802"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#DIRECTORYMASK">directory mask</a>.</p></dd></dl></div></div><div class="section" title="directory mask (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2545828"></a>
     1569</h3></div></div></div><a class="indexterm" name="id2539818"></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="id2539844"></a>
    15701570
    15711571directory mask (S)
    1572 </h3></div></div></div><a class="indexterm" name="id2545829"></a><a name="DIRECTORYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is the octal modes which are
     1572</h3></div></div></div><a class="indexterm" name="id2539845"></a><a name="DIRECTORYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is the octal modes which are
    15731573    used when converting DOS modes to UNIX modes when creating UNIX
    15741574    directories.</p><p>When a directory is created, the necessary permissions are
    … …  
    15881588</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>directory mask</code></em> = <code class="literal">0775</code>
    15891589</em></span>
    1590 </p></dd></dl></div></div><div class="section" title="directory security mask (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2545933"></a>
     1590</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539950"></a>
    15911591
    15921592directory security mask (S)
    1593 </h3></div></div></div><a class="indexterm" name="id2545934"></a><a name="DIRECTORYSECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls what UNIX permission bits
     1593</h3></div></div></div><a class="indexterm" name="id2539951"></a><a name="DIRECTORYSECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls what UNIX permission bits
    15941594    will be set when a Windows NT client is manipulating the UNIX
    15951595    permission on a directory using the native NT security dialog
    … …  
    16111611</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>directory security mask</code></em> = <code class="literal">0700</code>
    16121612</em></span>
    1613 </p></dd></dl></div></div><div class="section" title="disable netbios (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2546034"></a>
     1613</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540050"></a>
    16141614
    16151615disable netbios (G)
    1616 </h3></div></div></div><a class="indexterm" name="id2546035"></a><a name="DISABLENETBIOS"></a><div class="variablelist"><dl><dt></dt><dd><p>Enabling this parameter will disable netbios support
     1616</h3></div></div></div><a class="indexterm" name="id2540051"></a><a name="DISABLENETBIOS"></a><div class="variablelist"><dl><dt></dt><dd><p>Enabling this parameter will disable netbios support
    16171617    in Samba. Netbios is the only available form of browsing in
    1618     all windows versions except for 2000 and XP. </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Clients that only support netbios won't be able to
     1618    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
    16191619    see your samba server when netbios support is disabled.
    16201620        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>disable netbios</code></em> = <code class="literal">no</code>
    16211621</em></span>
    1622 </p></dd></dl></div></div><div class="section" title="disable spoolss (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2546080"></a>
     1622</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540096"></a>
    16231623
    16241624disable spoolss (G)
    1625 </h3></div></div></div><a class="indexterm" name="id2546081"></a><a name="DISABLESPOOLSS"></a><div class="variablelist"><dl><dt></dt><dd><p>Enabling this parameter will disable Samba's support
     1625</h3></div></div></div><a class="indexterm" name="id2540097"></a><a name="DISABLESPOOLSS"></a><div class="variablelist"><dl><dt></dt><dd><p>Enabling this parameter will disable Samba's support
    16261626    for the SPOOLSS set of MS-RPC's and will yield identical behavior
    16271627    as Samba 2.0.x.  Windows NT/2000 clients will downgrade to using
    … …  
    16351635</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>disable spoolss</code></em> = <code class="literal">no</code>
    16361636</em></span>
    1637 </p></dd></dl></div></div><div class="section" title="display charset (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2546131"></a>
     1637</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540147"></a>
    16381638
    16391639display charset (G)
    1640 </h3></div></div></div><a class="indexterm" name="id2546132"></a><a name="DISPLAYCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1640</h3></div></div></div><a class="indexterm" name="id2540148"></a><a name="DISPLAYCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>
    16411641        Specifies the charset that samba will use to print messages to stdout and stderr.
    16421642        The default value is "LOCALE", which means automatically set, depending on the
    … …  
    16471647</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>display charset</code></em> = <code class="literal">UTF8</code>
    16481648</em></span>
    1649 </p></dd></dl></div></div><div class="section" title="dmapi support (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2546197"></a>
     1649</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540214"></a>
    16501650
    16511651dmapi support (S)
    1652 </h3></div></div></div><a class="indexterm" name="id2546198"></a><a name="DMAPISUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should use DMAPI to
     1652</h3></div></div></div><a class="indexterm" name="id2540215"></a><a name="DMAPISUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should use DMAPI to
    16531653        determine whether a file is offline or not. This would typically
    16541654        be used in conjunction with a hierarchical storage system that
    … …  
    16651665        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dmapi support</code></em> = <code class="literal">no</code>
    16661666</em></span>
    1667 </p></dd></dl></div></div><div class="section" title="dns proxy (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2546256"></a>
     1667</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540272"></a>
    16681668
    16691669dns proxy (G)
    1670 </h3></div></div></div><a class="indexterm" name="id2546257"></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
     1670</h3></div></div></div><a class="indexterm" name="id2540274"></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
    16711671        finding that a NetBIOS name has not been registered, should treat the
    16721672        NetBIOS name word-for-word as a DNS name and do a lookup with the DNS server
    … …  
    16771677        action.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dns proxy</code></em> = <code class="literal">yes</code>
    16781678</em></span>
    1679 </p></dd></dl></div></div><div class="section" title="domain logons (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2546320"></a>
     1679</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540336"></a>
    16801680
    16811681domain logons (G)
    1682 </h3></div></div></div><a class="indexterm" name="id2546321"></a><a name="DOMAINLOGONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1682</h3></div></div></div><a class="indexterm" name="id2540337"></a><a name="DOMAINLOGONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    16831683        If set to <code class="constant">yes</code>, the Samba server will
    16841684        provide the netlogon service for Windows 9X network logons for the
    … …  
    16901690        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>domain logons</code></em> = <code class="literal">no</code>
    16911691</em></span>
    1692 </p></dd></dl></div></div><div class="section" title="domain master (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2546373"></a>
     1692</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540389"></a>
    16931693
    16941694domain master (G)
    1695 </h3></div></div></div><a class="indexterm" name="id2546374"></a><a name="DOMAINMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1695</h3></div></div></div><a class="indexterm" name="id2540390"></a><a name="DOMAINMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    16961696        Tell <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> to enable
    16971697        WAN-wide browse list collation. Setting this option causes <code class="literal">nmbd</code> to claim a
    … …  
    17191719        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>domain master</code></em> = <code class="literal">auto</code>
    17201720</em></span>
    1721 </p></dd></dl></div></div><div class="section" title="dont descend (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2546564"></a>
     1721</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540580"></a>
    17221722
    17231723dont descend (S)
    1724 </h3></div></div></div><a class="indexterm" name="id2546565"></a><a name="DONTDESCEND"></a><div class="variablelist"><dl><dt></dt><dd><p>There are certain directories on some systems
     1724</h3></div></div></div><a class="indexterm" name="id2540582"></a><a name="DONTDESCEND"></a><div class="variablelist"><dl><dt></dt><dd><p>There are certain directories on some systems
    17251725        (e.g., the <code class="filename">/proc</code> tree under Linux) that are either not
    17261726        of interest to clients or are infinitely deep (recursive). This
    … …  
    17331733</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>dont descend</code></em> = <code class="literal">/proc,/dev</code>
    17341734</em></span>
    1735 </p></dd></dl></div></div><div class="section" title="dos charset (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2546642"></a>
     1735</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540659"></a>
    17361736
    17371737dos charset (G)
    1738 </h3></div></div></div><a class="indexterm" name="id2546643"></a><a name="DOSCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>DOS SMB clients assume the server has
     1738</h3></div></div></div><a class="indexterm" name="id2540660"></a><a name="DOSCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>DOS SMB clients assume the server has
    17391739        the same charset as they do. This option specifies which
    17401740        charset Samba should talk to DOS clients.
    17411741        </p><p>The default depends on which charsets you have installed.
    17421742        Samba tries to use charset 850 but falls back to ASCII in
    1743         case it is not available. Run <a class="citerefentry" href="testparm.1.html"><span class="citerefentry"><span class="refentrytitle">testparm</span>(1)</span></a> to check the default on your system.</p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="dos filemode (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2546684"></a>
     1743        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="id2540700"></a>
    17441744
    17451745dos filemode (S)
    1746 </h3></div></div></div><a class="indexterm" name="id2546685"></a><a name="DOSFILEMODE"></a><div class="variablelist"><dl><dt></dt><dd><p> The default behavior in Samba is to provide
     1746</h3></div></div></div><a class="indexterm" name="id2540701"></a><a name="DOSFILEMODE"></a><div class="variablelist"><dl><dt></dt><dd><p> The default behavior in Samba is to provide
    17471747        UNIX-like behavior where only the owner of a file/directory is
    17481748        able to change the permissions on it.  However, this behavior
    … …  
    17551755        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>
    17561756</em></span>
    1757 </p></dd></dl></div></div><div class="section" title="dos filetime resolution (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2546730"></a>
     1757</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540746"></a>
    17581758
    17591759dos filetime resolution (S)
    1760 </h3></div></div></div><a class="indexterm" name="id2546731"></a><a name="DOSFILETIMERESOLUTION"></a><div class="variablelist"><dl><dt></dt><dd><p>Under the DOS and Windows FAT filesystem, the finest
     1760</h3></div></div></div><a class="indexterm" name="id2540748"></a><a name="DOSFILETIMERESOLUTION"></a><div class="variablelist"><dl><dt></dt><dd><p>Under the DOS and Windows FAT filesystem, the finest
    17611761        granularity on time resolution is two seconds. Setting this parameter
    17621762        for a share causes Samba to round the reported time down to the
    … …  
    17731773        happy.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dos filetime resolution</code></em> = <code class="literal">no</code>
    17741774</em></span>
    1775 </p></dd></dl></div></div><div class="section" title="dos filetimes (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2546794"></a>
     1775</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540810"></a>
    17761776
    17771777dos filetimes (S)
    1778 </h3></div></div></div><a class="indexterm" name="id2546795"></a><a name="DOSFILETIMES"></a><div class="variablelist"><dl><dt></dt><dd><p>Under DOS and Windows, if a user can write to a
     1778</h3></div></div></div><a class="indexterm" name="id2540811"></a><a name="DOSFILETIMES"></a><div class="variablelist"><dl><dt></dt><dd><p>Under DOS and Windows, if a user can write to a
    17791779        file they can change the timestamp on it. Under POSIX semantics,
    17801780        only the owner of the file or root may change the timestamp. By
    … …  
    17901790        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dos filetimes</code></em> = <code class="literal">yes</code>
    17911791</em></span>
    1792 </p></dd></dl></div></div><div class="section" title="ea support (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2546859"></a>
     1792</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540876"></a>
    17931793
    17941794ea support (S)
    1795 </h3></div></div></div><a class="indexterm" name="id2546860"></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
     1795</h3></div></div></div><a class="indexterm" name="id2540877"></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
    17961796    attributes on a share. In order to enable this parameter the underlying filesystem exported by
    17971797    the share must support extended attributes (such as provided on XFS and EXT3 on Linux, with the
    … …  
    18001800                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>
    18011801</em></span>
    1802 </p></dd></dl></div></div><div class="section" title="enable asu support (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2546913"></a>
     1802</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540929"></a>
    18031803
    18041804enable asu support (G)
    1805 </h3></div></div></div><a class="indexterm" name="id2546914"></a><a name="ENABLEASUSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>Hosts running the "Advanced Server for Unix (ASU)" product
     1805</h3></div></div></div><a class="indexterm" name="id2540930"></a><a name="ENABLEASUSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>Hosts running the "Advanced Server for Unix (ASU)" product
    18061806    require some special accomodations such as creating a builtin [ADMIN$]
    18071807    share that only supports IPC connections.  The has been the default
    … …  
    18111811    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>
    18121812</em></span>
    1813 </p></dd></dl></div></div><div class="section" title="enable core files (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2546957"></a>
     1813</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540974"></a>
    18141814
    18151815enable core files (G)
    1816 </h3></div></div></div><a class="indexterm" name="id2546958"></a><a name="ENABLECOREFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether core dumps should be written
     1816</h3></div></div></div><a class="indexterm" name="id2540975"></a><a name="ENABLECOREFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether core dumps should be written
    18171817        on internal exits. Normally set to <code class="constant">yes</code>.
    18181818        You should never need to change this.
    … …  
    18211821</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>enable core files</code></em> = <code class="literal">no</code>
    18221822</em></span>
    1823 </p></dd></dl></div></div><div class="section" title="enable privileges (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2547016"></a>
     1823</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541032"></a>
    18241824
    18251825enable privileges (G)
    1826 </h3></div></div></div><a class="indexterm" name="id2547017"></a><a name="ENABLEPRIVILEGES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1826</h3></div></div></div><a class="indexterm" name="id2541033"></a><a name="ENABLEPRIVILEGES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    18271827        This parameter controls whether or not smbd will honor privileges assigned to specific SIDs via either
    18281828         <code class="literal">net rpc rights</code> or one of the Windows user and group manager tools.  This parameter is
    … …  
    18371837        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>enable privileges</code></em> = <code class="literal">yes</code>
    18381838</em></span>
    1839 </p></dd></dl></div></div><div class="section" title="encrypt passwords (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2547076"></a>
     1839</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541092"></a>
    18401840
    18411841encrypt passwords (G)
    1842 </h3></div></div></div><a class="indexterm" name="id2547077"></a><a name="ENCRYPTPASSWORDS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean controls whether encrypted passwords
     1842</h3></div></div></div><a class="indexterm" name="id2541094"></a><a name="ENCRYPTPASSWORDS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean controls whether encrypted passwords
    18431843    will be negotiated with the client. Note that Windows NT 4.0 SP3 and
    18441844    above and also Windows 98 will by default expect encrypted passwords
    … …  
    18631863        server.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>encrypt passwords</code></em> = <code class="literal">yes</code>
    18641864</em></span>
    1865 </p></dd></dl></div></div><div class="section" title="enhanced browsing (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2547180"></a>
     1865</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541197"></a>
    18661866
    18671867enhanced browsing (G)
    1868 </h3></div></div></div><a class="indexterm" name="id2547182"></a><a name="ENHANCEDBROWSING"></a><div class="variablelist"><dl><dt></dt><dd><p>This option enables a couple of enhancements to
     1868</h3></div></div></div><a class="indexterm" name="id2541198"></a><a name="ENHANCEDBROWSING"></a><div class="variablelist"><dl><dt></dt><dd><p>This option enables a couple of enhancements to
    18691869        cross-subnet browse propagation that have been added in Samba
    18701870        but which are not standard in Microsoft implementations. 
    … …  
    18791879        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>
    18801880</em></span>
    1881 </p></dd></dl></div></div><div class="section" title="enumports command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2547242"></a>
     1881</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541258"></a>
    18821882
    18831883enumports command (G)
    1884 </h3></div></div></div><a class="indexterm" name="id2547243"></a><a name="ENUMPORTSCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>The concept of a "port" is fairly foreign
     1884</h3></div></div></div><a class="indexterm" name="id2541259"></a><a name="ENUMPORTSCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>The concept of a "port" is fairly foreign
    18851885    to UNIX hosts.  Under Windows NT/2000 print servers, a port
    18861886    is associated with a port monitor and generally takes the form of
    … …  
    18991899</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>enumports command</code></em> = <code class="literal">/usr/bin/listports</code>
    19001900</em></span>
    1901 </p></dd></dl></div></div><div class="section" title="eventlog list (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2547323"></a>
     1901</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541339"></a>
    19021902
    19031903eventlog list (G)
    1904 </h3></div></div></div><a class="indexterm" name="id2547324"></a><a name="EVENTLOGLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of log names that Samba will
     1904</h3></div></div></div><a class="indexterm" name="id2541340"></a><a name="EVENTLOGLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of log names that Samba will
    19051905    report to the Microsoft EventViewer utility.  The listed
    19061906    eventlogs will be associated with tdb file on disk in the
    … …  
    19151915</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>eventlog list</code></em> = <code class="literal">Security Application Syslog Apache</code>
    19161916</em></span>
    1917 </p></dd></dl></div></div><div class="section" title="fake directory create times (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2547396"></a>
     1917</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541412"></a>
    19181918
    19191919fake directory create times (S)
    1920 </h3></div></div></div><a class="indexterm" name="id2547397"></a><a name="FAKEDIRECTORYCREATETIMES"></a><div class="variablelist"><dl><dt></dt><dd><p>NTFS and Windows VFAT file systems keep a create
     1920</h3></div></div></div><a class="indexterm" name="id2541413"></a><a name="FAKEDIRECTORYCREATETIMES"></a><div class="variablelist"><dl><dt></dt><dd><p>NTFS and Windows VFAT file systems keep a create
    19211921        time for all files and directories. This is not the same as the
    19221922        ctime - status change time - that Unix keeps, so Samba by default
    … …  
    19401940        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>
    19411941</em></span>
    1942 </p></dd></dl></div></div><div class="section" title="fake oplocks (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2547463"></a>
     1942</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541479"></a>
    19431943
    19441944fake oplocks (S)
    1945 </h3></div></div></div><a class="indexterm" name="id2547464"></a><a name="FAKEOPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>Oplocks are the way that SMB clients get permission
     1945</h3></div></div></div><a class="indexterm" name="id2541480"></a><a name="FAKEOPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>Oplocks are the way that SMB clients get permission
    19461946        from a server to locally cache file operations. If a server grants
    19471947        an oplock (opportunistic lock) then the client is free to assume
    … …  
    19591959        this option carefully!</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>fake oplocks</code></em> = <code class="literal">no</code>
    19601960</em></span>
    1961 </p></dd></dl></div></div><div class="section" title="follow symlinks (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2547554"></a>
     1961</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541570"></a>
    19621962
    19631963follow symlinks (S)
    1964 </h3></div></div></div><a class="indexterm" name="id2547555"></a><a name="FOLLOWSYMLINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1964</h3></div></div></div><a class="indexterm" name="id2541571"></a><a name="FOLLOWSYMLINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    19651965        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
    19661966        parameter to <code class="constant">no</code> prevents any file or directory that is a symbolic link from being
    … …  
    19721972        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>follow symlinks</code></em> = <code class="literal">yes</code>
    19731973</em></span>
    1974 </p></dd></dl></div></div><div class="section" title="force create mode (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2547624"></a>
     1974</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541640"></a>
    19751975
    19761976force create mode (S)
    1977 </h3></div></div></div><a class="indexterm" name="id2547625"></a><a name="FORCECREATEMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a set of UNIX mode bit
     1977</h3></div></div></div><a class="indexterm" name="id2541641"></a><a name="FORCECREATEMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a set of UNIX mode bit
    19781978    permissions that will <span class="emphasis"><em>always</em></span> be set on a
    19791979    file created by Samba. This is done by bitwise 'OR'ing these bits onto
    … …  
    19871987</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force create mode</code></em> = <code class="literal">0755</code>
    19881988</em></span>
    1989 </p></dd></dl></div></div><div class="section" title="force directory mode (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2547698"></a>
     1989</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541714"></a>
    19901990
    19911991force directory mode (S)
    1992 </h3></div></div></div><a class="indexterm" name="id2547699"></a><a name="FORCEDIRECTORYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a set of UNIX mode bit
     1992</h3></div></div></div><a class="indexterm" name="id2541715"></a><a name="FORCEDIRECTORYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a set of UNIX mode bit
    19931993    permissions that will <span class="emphasis"><em>always</em></span> be set on a directory
    19941994    created by Samba. This is done by bitwise 'OR'ing these bits onto the
    … …  
    20032003</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force directory mode</code></em> = <code class="literal">0755</code>
    20042004</em></span>
    2005 </p></dd></dl></div></div><div class="section" title="force directory security mode (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2547778"></a>
     2005</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541794"></a>
    20062006
    20072007force directory security mode (S)
    2008 </h3></div></div></div><a class="indexterm" name="id2547779"></a><a name="FORCEDIRECTORYSECURITYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2008</h3></div></div></div><a class="indexterm" name="id2541795"></a><a name="FORCEDIRECTORYSECURITYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    20092009        This parameter controls what UNIX permission bits can be modified when a Windows NT client is manipulating
    20102010        the UNIX permission on a directory using the native NT security dialog box.
    … …  
    20192019        If not set explicitly this parameter is 0000, which allows a user to modify all the user/group/world
    20202020        permissions on a directory without restrictions.
    2021         </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
     2021        </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
    20222022        Users who can access the Samba server through other means can easily bypass this restriction, so it is
    20232023        primarily useful for standalone "appliance" systems.  Administrators of most normal systems will
    … …  
    20272027</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force directory security mode</code></em> = <code class="literal">700</code>
    20282028</em></span>
    2029 </p></dd></dl></div></div><div class="section" title="group"><div class="titlepage"><div><div><h3 class="title"><a name="id2547874"></a>
     2029</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541891"></a>
    20302030
    20312031<a name="GROUP"></a>group
    2032 </h3></div></div></div><a class="indexterm" name="id2547875"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#FORCEGROUP">force group</a>.</p></dd></dl></div></div><div class="section" title="force group (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2547903"></a>
     2032</h3></div></div></div><a class="indexterm" name="id2541892"></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="id2541921"></a>
    20332033
    20342034force group (S)
    2035 </h3></div></div></div><a class="indexterm" name="id2547904"></a><a name="FORCEGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies a UNIX group name that will be
     2035</h3></div></div></div><a class="indexterm" name="id2541922"></a><a name="FORCEGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies a UNIX group name that will be
    20362036    assigned as the default primary group for all users connecting
    20372037    to this service. This is useful for sharing files by ensuring
    … …  
    20572057</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force group</code></em> = <code class="literal">agroup</code>
    20582058</em></span>
    2059 </p></dd></dl></div></div><div class="section" title="force printername (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2548027"></a>
     2059</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542046"></a>
    20602060
    20612061force printername (S)
    2062 </h3></div></div></div><a class="indexterm" name="id2548028"></a><a name="FORCEPRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>When printing from Windows NT (or later),
     2062</h3></div></div></div><a class="indexterm" name="id2542047"></a><a name="FORCEPRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>When printing from Windows NT (or later),
    20632063    each printer in <code class="filename">smb.conf</code> has two
    20642064    associated names which can be used by the client.  The first
    … …  
    20832083    folder.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>force printername</code></em> = <code class="literal">no</code>
    20842084</em></span>
    2085 </p></dd></dl></div></div><div class="section" title="force security mode (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2548119"></a>
     2085</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542137"></a>
    20862086
    20872087force security mode (S)
    2088 </h3></div></div></div><a class="indexterm" name="id2548120"></a><a name="FORCESECURITYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2088</h3></div></div></div><a class="indexterm" name="id2542138"></a><a name="FORCESECURITYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    20892089        This parameter controls what UNIX permission bits can be modified when a Windows NT client is manipulating
    20902090    the UNIX permission on a file using the native NT security dialog box.
    … …  
    21062106</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force security mode</code></em> = <code class="literal">700</code>
    21072107</em></span>
    2108 </p></dd></dl></div></div><div class="section" title="force unknown acl user (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2548221"></a>
     2108</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542239"></a>
    21092109
    21102110force unknown acl user (S)
    2111 </h3></div></div></div><a class="indexterm" name="id2548222"></a><a name="FORCEUNKNOWNACLUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2111</h3></div></div></div><a class="indexterm" name="id2542240"></a><a name="FORCEUNKNOWNACLUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    21122112    If this parameter is set, a Windows NT ACL that contains an unknown SID (security descriptor, or
    21132113    representation of a user or group id) as the owner or group owner of the file will be silently
    … …  
    21232123    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>force unknown acl user</code></em> = <code class="literal">no</code>
    21242124</em></span>
    2125 </p></dd></dl></div></div><div class="section" title="force user (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2548284"></a>
     2125</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542302"></a>
    21262126
    21272127force user (S)
    2128 </h3></div></div></div><a class="indexterm" name="id2548285"></a><a name="FORCEUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies a UNIX user name that will be
     2128</h3></div></div></div><a class="indexterm" name="id2542303"></a><a name="FORCEUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies a UNIX user name that will be
    21292129    assigned as the default user for all users connecting to this service.
    21302130    This is useful for sharing files. You should also use it carefully
    … …  
    21402140</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force user</code></em> = <code class="literal">auser</code>
    21412141</em></span>
    2142 </p></dd></dl></div></div><div class="section" title="fstype (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2548360"></a>
     2142</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542378"></a>
    21432143
    21442144fstype (S)
    2145 </h3></div></div></div><a class="indexterm" name="id2548361"></a><a name="FSTYPE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2145</h3></div></div></div><a class="indexterm" name="id2542379"></a><a name="FSTYPE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    21462146        This parameter allows the administrator to configure the string that specifies the type of filesystem a share
    21472147        is using that is reported by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>
    … …  
    21532153</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>fstype</code></em> = <code class="literal">Samba</code>
    21542154</em></span>
    2155 </p></dd></dl></div></div><div class="section" title="get quota command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2548442"></a>
     2155</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542460"></a>
    21562156
    21572157get quota command (G)
    2158 </h3></div></div></div><a class="indexterm" name="id2548443"></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
     2158</h3></div></div></div><a class="indexterm" name="id2542461"></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
    21592159        whenever there is no operating system API available from the OS that
    21602160        samba can use.</p><p>This option is only available you have compiled Samba with the
    … …  
    21642164        queries the quota information for the specified
    21652165        user/group for the partition that
    2166         the specified directory is on.</p><p>Such a script should take 3 arguments:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>directory</p></li><li class="listitem"><p>type of query</p></li><li class="listitem"><p>uid of user or gid of group</p></li></ul></div><p>The type of query can be one of :</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>1 - user quotas</p></li><li class="listitem"><p>2 - user default quotas (uid = -1)</p></li><li class="listitem"><p>3 - group quotas</p></li><li class="listitem"><p>4 - group default quotas (gid = -1)</p></li></ul></div><p>This script should print one line as output with spaces between the arguments. The arguments are:
    2167               </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Arg 1 - quota flags (0 = no quotas, 1 = quotas enabled, 2 = quotas enabled and enforced)</p></li><li class="listitem"><p>Arg 2 - number of currently used blocks</p></li><li class="listitem"><p>Arg 3 - the softlimit number of blocks</p></li><li class="listitem"><p>Arg 4 - the hardlimit number of blocks</p></li><li class="listitem"><p>Arg 5 - currently used number of inodes</p></li><li class="listitem"><p>Arg 6 - the softlimit number of inodes</p></li><li class="listitem"><p>Arg 7 - the hardlimit number of inodes</p></li><li class="listitem"><p>Arg 8(optional) - the number of bytes in a block(default is 1024)</p></li></ul></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>get quota command</code></em> = <code class="literal"></code>
     2166        the specified directory is on.</p><p>Such a script should take 3 arguments:</p><div class="itemizedlist"><ul type="disc"><li><p>directory</p></li><li><p>type of query</p></li><li><p>uid of user or gid of group</p></li></ul></div><p>The type of query can be one of :</p><div class="itemizedlist"><ul type="disc"><li><p>1 - user quotas</p></li><li><p>2 - user default quotas (uid = -1)</p></li><li><p>3 - group quotas</p></li><li><p>4 - group default quotas (gid = -1)</p></li></ul></div><p>This script should print one line as output with spaces between the arguments. The arguments are:
     2167              </p><div class="itemizedlist"><ul type="disc"><li><p>Arg 1 - quota flags (0 = no quotas, 1 = quotas enabled, 2 = quotas enabled and enforced)</p></li><li><p>Arg 2 - number of currently used blocks</p></li><li><p>Arg 3 - the softlimit number of blocks</p></li><li><p>Arg 4 - the hardlimit number of blocks</p></li><li><p>Arg 5 - currently used number of inodes</p></li><li><p>Arg 6 - the softlimit number of inodes</p></li><li><p>Arg 7 - the hardlimit number of inodes</p></li><li><p>Arg 8(optional) - the number of bytes in a block(default is 1024)</p></li></ul></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>get quota command</code></em> = <code class="literal"></code>
    21682168</em></span>
    21692169</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>
    21702170</em></span>
    2171 </p></dd></dl></div></div><div class="section" title="getwd cache (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2548628"></a>
     2171</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542647"></a>
    21722172
    21732173getwd cache (G)
    2174 </h3></div></div></div><a class="indexterm" name="id2548630"></a><a name="GETWDCACHE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a tuning option. When this is enabled a
     2174</h3></div></div></div><a class="indexterm" name="id2542648"></a><a name="GETWDCACHE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a tuning option. When this is enabled a
    21752175    caching algorithm will be used to reduce the time taken for getwd()
    21762176    calls. This can have a significant impact on performance, especially
    21772177    when the <a class="link" href="smb.conf.5.html#WIDESMBCONFOPTIONS" target="_top">wide smbconfoptions</a> parameter is set to <code class="constant">no</code>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>getwd cache</code></em> = <code class="literal">yes</code>
    21782178</em></span>
    2179 </p></dd></dl></div></div><div class="section" title="guest account (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2548689"></a>
     2179</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542707"></a>
    21802180
    21812181guest account (G)
    2182 </h3></div></div></div><a class="indexterm" name="id2548690"></a><a name="GUESTACCOUNT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a username which will be used for access
     2182</h3></div></div></div><a class="indexterm" name="id2542708"></a><a name="GUESTACCOUNT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a username which will be used for access
    21832183    to services which are specified as <a class="link" href="smb.conf.5.html#GUESTOK" target="_top">guest ok</a> (see below). Whatever privileges this
    21842184    user has will be available to any client connecting to the guest service.
    … …  
    21982198</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>guest account</code></em> = <code class="literal">ftp</code>
    21992199</em></span>
    2200 </p></dd></dl></div></div><div class="section" title="public"><div class="titlepage"><div><div><h3 class="title"><a name="id2548797"></a>
     2200</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542815"></a>
    22012201
    22022202<a name="PUBLIC"></a>public
    2203 </h3></div></div></div><a class="indexterm" name="id2548798"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#GUESTOK">guest ok</a>.</p></dd></dl></div></div><div class="section" title="guest ok (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2548828"></a>
     2203</h3></div></div></div><a class="indexterm" name="id2542816"></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="id2542846"></a>
    22042204
    22052205guest ok (S)
    2206 </h3></div></div></div><a class="indexterm" name="id2548829"></a><a name="GUESTOK"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code> for
     2206</h3></div></div></div><a class="indexterm" name="id2542847"></a><a name="GUESTOK"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code> for
    22072207    a service, then no password is required to connect to the service.
    22082208    Privileges will be those of the <a class="link" href="smb.conf.5.html#GUESTACCOUNT" target="_top">guest account</a>.</p><p>This paramater nullifies the benifits of setting
    … …  
    22112211        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>guest ok</code></em> = <code class="literal">no</code>
    22122212</em></span>
    2213 </p></dd></dl></div></div><div class="section" title="only guest"><div class="titlepage"><div><div><h3 class="title"><a name="id2548916"></a>
     2213</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542934"></a>
    22142214
    22152215<a name="ONLYGUEST"></a>only guest
    2216 </h3></div></div></div><a class="indexterm" name="id2548917"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#GUESTONLY">guest only</a>.</p></dd></dl></div></div><div class="section" title="guest only (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2548949"></a>
     2216</h3></div></div></div><a class="indexterm" name="id2542935"></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="id2542967"></a>
    22172217
    22182218guest only (S)
    2219 </h3></div></div></div><a class="indexterm" name="id2548950"></a><a name="GUESTONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code> for
     2219</h3></div></div></div><a class="indexterm" name="id2542968"></a><a name="GUESTONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code> for
    22202220    a service, then only guest connections to the service are permitted.
    22212221    This parameter will have no effect if <a class="link" href="smb.conf.5.html#GUESTOK" target="_top">guest ok</a> is not set for the service.</p><p>See the section below on <a class="link" href="smb.conf.5.html#SECURITY" target="_top">security</a> for more information about this option.
    22222222        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>guest only</code></em> = <code class="literal">no</code>
    22232223</em></span>
    2224 </p></dd></dl></div></div><div class="section" title="hide dot files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2549021"></a>
     2224</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543040"></a>
    22252225
    22262226hide dot files (S)
    2227 </h3></div></div></div><a class="indexterm" name="id2549022"></a><a name="HIDEDOTFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls whether
     2227</h3></div></div></div><a class="indexterm" name="id2543041"></a><a name="HIDEDOTFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls whether
    22282228        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>
    22292229</em></span>
    2230 </p></dd></dl></div></div><div class="section" title="hide files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2549064"></a>
     2230</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543082"></a>
    22312231
    22322232hide files (S)
    2233 </h3></div></div></div><a class="indexterm" name="id2549065"></a><a name="HIDEFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of files or directories that are not
     2233</h3></div></div></div><a class="indexterm" name="id2543083"></a><a name="HIDEFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of files or directories that are not
    22342234        visible but are accessible.  The DOS 'hidden' attribute is applied
    22352235        to any files or directories that match.</p><p>Each entry in the list must be separated by a '/',
    … …  
    22532253# no file are hidden</code>
    22542254</em></span>
    2255 </p></dd></dl></div></div><div class="section" title="hide special files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2549152"></a>
     2255</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543171"></a>
    22562256
    22572257hide special files (S)
    2258 </h3></div></div></div><a class="indexterm" name="id2549153"></a><a name="HIDESPECIALFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2258</h3></div></div></div><a class="indexterm" name="id2543172"></a><a name="HIDESPECIALFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    22592259        This parameter prevents clients from seeing special files such as sockets, devices and
    22602260        fifo's in directory listings.
    22612261        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>hide special files</code></em> = <code class="literal">no</code>
    22622262</em></span>
    2263 </p></dd></dl></div></div><div class="section" title="hide unreadable (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2549195"></a>
     2263</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543214"></a>
    22642264
    22652265hide unreadable (S)
    2266 </h3></div></div></div><a class="indexterm" name="id2549196"></a><a name="HIDEUNREADABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter prevents clients from seeing the
     2266</h3></div></div></div><a class="indexterm" name="id2543215"></a><a name="HIDEUNREADABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter prevents clients from seeing the
    22672267                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>
    22682268</em></span>
    2269 </p></dd></dl></div></div><div class="section" title="hide unwriteable files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2549238"></a>
     2269</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543256"></a>
    22702270
    22712271hide unwriteable files (S)
    2272 </h3></div></div></div><a class="indexterm" name="id2549239"></a><a name="HIDEUNWRITEABLEFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2272</h3></div></div></div><a class="indexterm" name="id2543257"></a><a name="HIDEUNWRITEABLEFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    22732273    This parameter prevents clients from seeing the existance of files that cannot be written to.
    22742274    Defaults to off. Note that unwriteable directories are shown as usual.
    22752275    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>hide unwriteable files</code></em> = <code class="literal">no</code>
    22762276</em></span>
    2277 </p></dd></dl></div></div><div class="section" title="homedir map (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2549282"></a>
     2277</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543301"></a>
    22782278
    22792279homedir map (G)
    2280 </h3></div></div></div><a class="indexterm" name="id2549284"></a><a name="HOMEDIRMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2280</h3></div></div></div><a class="indexterm" name="id2543302"></a><a name="HOMEDIRMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    22812281        If <a class="link" href="smb.conf.5.html#NISHOMEDIR" target="_top">nis homedir</a> is <code class="constant">yes</code>, and <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> is also acting         as a Win95/98 <em class="parameter"><code>logon server</code></em>
    22822282        then this parameter specifies the NIS (or YP) map from which the server for the user's  home directory should be extracted. 
    … …  
    22872287        and the program will extract the servername from before the first ':'.  There should probably be a better parsing system
    22882288        that copes with different map formats and also Amd (another automounter) maps.
    2289         </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
     2289        </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
    22902290        A working NIS client is required on the system for this option to work.
    22912291        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>homedir map</code></em> = <code class="literal"></code>
    … …  
    22932293</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>homedir map</code></em> = <code class="literal">amd.homedir</code>
    22942294</em></span>
    2295 </p></dd></dl></div></div><div class="section" title="host msdfs (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2549395"></a>
     2295</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543413"></a>
    22962296
    22972297host msdfs (G)
    2298 </h3></div></div></div><a class="indexterm" name="id2549396"></a><a name="HOSTMSDFS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2298</h3></div></div></div><a class="indexterm" name="id2543414"></a><a name="HOSTMSDFS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    22992299        If set to <code class="constant">yes</code>, Samba will act as a Dfs server, and allow Dfs-aware clients to browse
    23002300        Dfs trees hosted on the server.
    … …  
    23042304        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>host msdfs</code></em> = <code class="literal">yes</code>
    23052305</em></span>
    2306 </p></dd></dl></div></div><div class="section" title="hostname lookups (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2549459"></a>
     2306</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543478"></a>
    23072307
    23082308hostname lookups (G)
    2309 </h3></div></div></div><a class="indexterm" name="id2549460"></a><a name="HOSTNAMELOOKUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies whether samba should use (expensive)
     2309</h3></div></div></div><a class="indexterm" name="id2543479"></a><a name="HOSTNAMELOOKUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies whether samba should use (expensive)
    23102310    hostname lookups or use the ip addresses instead. An example place
    23112311    where hostname lookups are currently used is when checking
    … …  
    23152315</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>hostname lookups</code></em> = <code class="literal">yes</code>
    23162316</em></span>
    2317 </p></dd></dl></div></div><div class="section" title="allow hosts"><div class="titlepage"><div><div><h3 class="title"><a name="id2549533"></a>
     2317</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543551"></a>
    23182318
    23192319<a name="ALLOWHOSTS"></a>allow hosts
    2320 </h3></div></div></div><a class="indexterm" name="id2549534"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#HOSTSALLOW">hosts allow</a>.</p></dd></dl></div></div><div class="section" title="hosts allow (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2549565"></a>
     2320</h3></div></div></div><a class="indexterm" name="id2543552"></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="id2543583"></a>
    23212321
    23222322hosts allow (S)
    2323 </h3></div></div></div><a class="indexterm" name="id2549566"></a><a name="HOSTSALLOW"></a><div class="variablelist"><dl><dt></dt><dd><p>A synonym for this parameter is <a class="link" href="smb.conf.5.html#ALLOWHOSTS" target="_top">allow hosts</a>.</p><p>This parameter is a comma, space, or tab delimited
     2323</h3></div></div></div><a class="indexterm" name="id2543584"></a><a name="HOSTSALLOW"></a><div class="variablelist"><dl><dt></dt><dd><p>A synonym for this parameter is <a class="link" href="smb.conf.5.html#ALLOWHOSTS" target="_top">allow hosts</a>.</p><p>This parameter is a comma, space, or tab delimited
    23242324    set of hosts which are permitted to access a service.</p><p>If specified in the [global] section then it will
    23252325    apply to all services, regardless of whether the individual
    … …  
    23352335    <span class="emphasis"><em>EXCEPT</em></span> keyword can also be used to limit a
    23362336    wildcard list. The following examples may provide some help:</p><p>Example 1: allow all IPs in 150.203.*.*; except one</p><p><code class="literal">hosts allow = 150.203. EXCEPT 150.203.6.66</code></p><p>Example 2: allow hosts that match the given network/netmask</p><p><code class="literal">hosts allow = 150.203.15.0/255.255.255.0</code></p><p>Example 3: allow a couple of hosts</p><p><code class="literal">hosts allow = lapland, arvidsjaur</code></p><p>Example 4: allow only hosts in NIS netgroup "foonet", but
    2337     deny access from one particular host</p><p><code class="literal">hosts allow = @foonet</code></p><p><code class="literal">hosts deny = pirate</code></p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Note that access still requires suitable user-level passwords.</p></div><p>See <a class="citerefentry" href="testparm.1.html"><span class="citerefentry"><span class="refentrytitle">testparm</span>(1)</span></a> for a way of testing your host access
     2337    deny access from one particular host</p><p><code class="literal">hosts allow = @foonet</code></p><p><code class="literal">hosts deny = pirate</code></p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Note that access still requires suitable user-level passwords.</p></div><p>See <a class="citerefentry" href="testparm.1.html"><span class="citerefentry"><span class="refentrytitle">testparm</span>(1)</span></a> for a way of testing your host access
    23382338    to see if it does what you expect.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>hosts allow</code></em> = <code class="literal">
    23392339# none (i.e., all hosts permitted access)</code>
    … …  
    23412341</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>
    23422342</em></span>
    2343 </p></dd></dl></div></div><div class="section" title="deny hosts"><div class="titlepage"><div><div><h3 class="title"><a name="id2549767"></a>
     2343</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543786"></a>
    23442344
    23452345<a name="DENYHOSTS"></a>deny hosts
    2346 </h3></div></div></div><a class="indexterm" name="id2549768"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#HOSTSDENY">hosts deny</a>.</p></dd></dl></div></div><div class="section" title="hosts deny (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2549799"></a>
     2346</h3></div></div></div><a class="indexterm" name="id2543787"></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="id2543817"></a>
    23472347
    23482348hosts deny (S)
    2349 </h3></div></div></div><a class="indexterm" name="id2549800"></a><a name="HOSTSDENY"></a><div class="variablelist"><dl><dt></dt><dd><p>The opposite of <em class="parameter"><code>hosts allow</code></em>
     2349</h3></div></div></div><a class="indexterm" name="id2543818"></a><a name="HOSTSDENY"></a><div class="variablelist"><dl><dt></dt><dd><p>The opposite of <em class="parameter"><code>hosts allow</code></em>
    23502350    - hosts listed here are <span class="emphasis"><em>NOT</em></span> permitted access to
    23512351    services unless the specific services have their own lists to override
    … …  
    23612361</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>
    23622362</em></span>
    2363 </p></dd></dl></div></div><div class="section" title="idmap alloc backend (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2549901"></a>
     2363</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543919"></a>
    23642364
    23652365idmap alloc backend (G)
    2366 </h3></div></div></div><a class="indexterm" name="id2549902"></a><a name="IDMAPALLOCBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2366</h3></div></div></div><a class="indexterm" name="id2543920"></a><a name="IDMAPALLOCBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    23672367        The idmap alloc backend provides a plugin interface for Winbind to use
    23682368        when allocating Unix uids/gids for Windows SIDs. This option refers
    … …  
    23812381        </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>
    23822382</em></span>
    2383 </p></dd></dl></div></div><div class="section" title="idmap alloc config (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2550006"></a>
     2383</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544024"></a>
    23842384
    23852385idmap alloc config (G)
    2386 </h3></div></div></div><a class="indexterm" name="id2550007"></a><a name="IDMAPALLOCCONFIG"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2386</h3></div></div></div><a class="indexterm" name="id2544026"></a><a name="IDMAPALLOCCONFIG"></a><div class="variablelist"><dl><dt></dt><dd><p>
    23872387        The idmap alloc config prefix provides a means of managing settings
    23882388        for the backend defined by the <a class="link" href="smb.conf.5.html#IDMAPALLOCBACKEND" target="_top">idmap alloc backend</a>
    23892389        parameter.  Refer to the man page for each idmap plugin regarding
    23902390        specific configuration details.
    2391         </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="idmap backend (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2550051"></a>
     2391        </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="id2544069"></a>
    23922392
    23932393idmap backend (G)
    2394 </h3></div></div></div><a class="indexterm" name="id2550052"></a><a name="IDMAPBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2394</h3></div></div></div><a class="indexterm" name="id2544070"></a><a name="IDMAPBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    23952395        The idmap backend provides a plugin interface for Winbind to use
    23962396        varying backends to store SID/uid/gid mapping tables.
    … …  
    24132413        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>idmap backend</code></em> = <code class="literal">tdb</code>
    24142414</em></span>
    2415 </p></dd></dl></div></div><div class="section" title="idmap cache time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2550222"></a>
     2415</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544241"></a>
    24162416
    24172417idmap cache time (G)
    2418 </h3></div></div></div><a class="indexterm" name="id2550224"></a><a name="IDMAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of seconds that Winbind's
     2418</h3></div></div></div><a class="indexterm" name="id2544242"></a><a name="IDMAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of seconds that Winbind's
    24192419        idmap interface will cache positive SID/uid/gid query results.
    24202420        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>idmap cache time</code></em> = <code class="literal">604800 (one week)</code>
    24212421</em></span>
    2422 </p></dd></dl></div></div><div class="section" title="idmap config (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2550266"></a>
     2422</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544285"></a>
    24232423
    24242424idmap config (G)
    2425 </h3></div></div></div><a class="indexterm" name="id2550267"></a><a name="IDMAPCONFIG"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2425</h3></div></div></div><a class="indexterm" name="id2544286"></a><a name="IDMAPCONFIG"></a><div class="variablelist"><dl><dt></dt><dd><p>
    24262426        The idmap config prefix provides a means of managing each trusted
    24272427        domain separately. The idmap config prefix should be followed by the
    … …  
    24552455        idmap config CORP : backend  = ad
    24562456        idmap config CORP : range = 1000-999999
    2457         </pre><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="winbind gid"><div class="titlepage"><div><div><h3 class="title"><a name="id2550400"></a>
     2457        </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="id2544418"></a>
    24582458
    24592459<a name="WINBINDGID"></a>winbind gid
    2460 </h3></div></div></div><a class="indexterm" name="id2550401"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#IDMAPGID">idmap gid</a>.</p></dd></dl></div></div><div class="section" title="idmap gid (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2550431"></a>
     2460</h3></div></div></div><a class="indexterm" name="id2544419"></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="id2544449"></a>
    24612461
    24622462idmap gid (G)
    2463 </h3></div></div></div><a class="indexterm" name="id2550432"></a><a name="IDMAPGID"></a><div class="variablelist"><dl><dt></dt><dd><p>The idmap gid parameter specifies the range of group ids
     2463</h3></div></div></div><a class="indexterm" name="id2544450"></a><a name="IDMAPGID"></a><div class="variablelist"><dl><dt></dt><dd><p>The idmap gid parameter specifies the range of group ids
    24642464        that are allocated for the purpose of mapping UNX groups to NT group
    24652465        SIDs. This range of group ids should have no
    … …  
    24712471</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>idmap gid</code></em> = <code class="literal">10000-20000</code>
    24722472</em></span>
    2473 </p></dd></dl></div></div><div class="section" title="idmap negative cache time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2550518"></a>
     2473</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544536"></a>
    24742474
    24752475idmap negative cache time (G)
    2476 </h3></div></div></div><a class="indexterm" name="id2550519"></a><a name="IDMAPNEGATIVECACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of seconds that Winbind's
     2476</h3></div></div></div><a class="indexterm" name="id2544537"></a><a name="IDMAPNEGATIVECACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of seconds that Winbind's
    24772477        idmap interface will cache negative SID/uid/gid query results.
    24782478        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>idmap negative cache time</code></em> = <code class="literal">120</code>
    24792479</em></span>
    2480 </p></dd></dl></div></div><div class="section" title="winbind uid"><div class="titlepage"><div><div><h3 class="title"><a name="id2550562"></a>
     2480</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544580"></a>
    24812481
    24822482<a name="WINBINDUID"></a>winbind uid
    2483 </h3></div></div></div><a class="indexterm" name="id2550563"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#IDMAPUID">idmap uid</a>.</p></dd></dl></div></div><div class="section" title="idmap uid (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2550593"></a>
     2483</h3></div></div></div><a class="indexterm" name="id2544581"></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="id2544611"></a>
    24842484
    24852485idmap uid (G)
    2486 </h3></div></div></div><a class="indexterm" name="id2550594"></a><a name="IDMAPUID"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2486</h3></div></div></div><a class="indexterm" name="id2544612"></a><a name="IDMAPUID"></a><div class="variablelist"><dl><dt></dt><dd><p>
    24872487        The idmap uid parameter specifies the range of user ids that are
    24882488        allocated for use in mapping UNIX users to NT user SIDs. This
    … …  
    24942494</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>idmap uid</code></em> = <code class="literal">10000-20000</code>
    24952495</em></span>
    2496 </p></dd></dl></div></div><div class="section" title="include (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2550679"></a>
     2496</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544697"></a>
    24972497
    24982498include (G)
    2499 </h3></div></div></div><a class="indexterm" name="id2550680"></a><a name="INCLUDE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2499</h3></div></div></div><a class="indexterm" name="id2544698"></a><a name="INCLUDE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    25002500        This allows you to include one config file inside another.  The file is included literally, as though typed
    25012501        in place.
    … …  
    25152515</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>
    25162516</em></span>
    2517 </p></dd></dl></div></div><div class="section" title="inherit acls (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2550780"></a>
     2517</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544798"></a>
    25182518
    25192519inherit acls (S)
    2520 </h3></div></div></div><a class="indexterm" name="id2550781"></a><a name="INHERITACLS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter can be used to ensure that if default acls
     2520</h3></div></div></div><a class="indexterm" name="id2544799"></a><a name="INHERITACLS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter can be used to ensure that if default acls
    25212521    exist on parent directories, they are always honored when creating a
    25222522    new file or subdirectory in these parent directories. The default
    … …  
    25262526</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>inherit acls</code></em> = <code class="literal">no</code>
    25272527</em></span>
    2528 </p></dd></dl></div></div><div class="section" title="inherit owner (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2550827"></a>
     2528</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544845"></a>
    25292529
    25302530inherit owner (S)
    2531 </h3></div></div></div><a class="indexterm" name="id2550828"></a><a name="INHERITOWNER"></a><div class="variablelist"><dl><dt></dt><dd><p>The ownership of new files and directories
     2531</h3></div></div></div><a class="indexterm" name="id2544846"></a><a name="INHERITOWNER"></a><div class="variablelist"><dl><dt></dt><dd><p>The ownership of new files and directories
    25322532        is normally governed by effective uid of the connected user.
    25332533        This option allows the Samba administrator to specify that
    … …  
    25382538        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>
    25392539</em></span>
    2540 </p></dd></dl></div></div><div class="section" title="inherit permissions (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2550880"></a>
     2540</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544898"></a>
    25412541
    25422542inherit permissions (S)
    2543 </h3></div></div></div><a class="indexterm" name="id2550881"></a><a name="INHERITPERMISSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2543</h3></div></div></div><a class="indexterm" name="id2544899"></a><a name="INHERITPERMISSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    25442544        The permissions on new files and directories are normally governed by <a class="link" href="smb.conf.5.html#CREATEMASK" target="_top">create mask</a>,
    25452545        <a class="link" href="smb.conf.5.html#DIRECTORYMASK" target="_top">directory mask</a>, <a class="link" href="smb.conf.5.html#FORCECREATEMODE" target="_top">force create mode</a> and <a class="link" href="smb.conf.5.html#FORCEDIRECTORYMODE" target="_top">force directory mode</a> but the boolean inherit permissions parameter overrides this.
    … …  
    25532553    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>
    25542554</em></span>
    2555 </p></dd></dl></div></div><div class="section" title="init logon delayed hosts (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2551029"></a>
     2555</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545047"></a>
    25562556
    25572557init logon delayed hosts (G)
    2558 </h3></div></div></div><a class="indexterm" name="id2551030"></a><a name="INITLOGONDELAYEDHOSTS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2558</h3></div></div></div><a class="indexterm" name="id2545048"></a><a name="INITLOGONDELAYEDHOSTS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    25592559        This parameter takes a list of host names, addresses or networks for
    25602560        which the initial samlogon reply should be delayed (so other DCs get
    … …  
    25672567</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>init logon delayed hosts</code></em> = <code class="literal">150.203.5. myhost.mynet.de</code>
    25682568</em></span>
    2569 </p></dd></dl></div></div><div class="section" title="init logon delay (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2551107"></a>
     2569</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545125"></a>
    25702570
    25712571init logon delay (G)
    2572 </h3></div></div></div><a class="indexterm" name="id2551108"></a><a name="INITLOGONDELAY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2572</h3></div></div></div><a class="indexterm" name="id2545126"></a><a name="INITLOGONDELAY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    25732573        This parameter specifies a delay in milliseconds for the hosts configured
    25742574        for delayed initial samlogon with
    … …  
    25762576        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>init logon delay</code></em> = <code class="literal">100</code>
    25772577</em></span>
    2578 </p></dd></dl></div></div><div class="section" title="interfaces (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2551162"></a>
     2578</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545180"></a>
    25792579
    25802580interfaces (G)
    2581 </h3></div></div></div><a class="indexterm" name="id2551163"></a><a name="INTERFACES"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to override the default
     2581</h3></div></div></div><a class="indexterm" name="id2545181"></a><a name="INTERFACES"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to override the default
    25822582        network interfaces list that Samba will use for browsing, name
    25832583        registration and other NetBIOS over TCP/IP (NBT) traffic. By default Samba will query
    25842584        the kernel for the list of all active interfaces and use any
    25852585        interfaces except 127.0.0.1 that are broadcast capable.</p><p>The option takes a list of interface strings. Each string
    2586         can be in any of the following forms:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>a network interface name (such as eth0).
     2586        can be in any of the following forms:</p><div class="itemizedlist"><ul type="disc"><li><p>a network interface name (such as eth0).
    25872587                This may include shell-like wildcards so eth* will match
    2588                 any interface starting with the substring "eth"</p></li><li class="listitem"><p>an IP address. In this case the netmask is
     2588                any interface starting with the substring "eth"</p></li><li><p>an IP address. In this case the netmask is
    25892589                determined from the list of interfaces obtained from the
    2590                 kernel</p></li><li class="listitem"><p>an IP/mask pair. </p></li><li class="listitem"><p>a broadcast/mask pair.</p></li></ul></div><p>The "mask" parameters can either be a bit length (such
     2590                kernel</p></li><li><p>an IP/mask pair. </p></li><li><p>a broadcast/mask pair.</p></li></ul></div><p>The "mask" parameters can either be a bit length (such
    25912591        as 24 for a C class network) or a full netmask in dotted
    25922592        decimal form.</p><p>The "IP" parameters above can either be a full dotted
    … …  
    26032603</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>
    26042604</em></span>
    2605 </p></dd></dl></div></div><div class="section" title="invalid users (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2551279"></a>
     2605</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545297"></a>
    26062606
    26072607invalid users (S)
    2608 </h3></div></div></div><a class="indexterm" name="id2551280"></a><a name="INVALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of users that should not be allowed
     2608</h3></div></div></div><a class="indexterm" name="id2545298"></a><a name="INVALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of users that should not be allowed
    26092609    to login to this service. This is really a <span class="emphasis"><em>paranoid</em></span>
    26102610    check to absolutely ensure an improper setting does not breach
    … …  
    26262626</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>invalid users</code></em> = <code class="literal">root fred admin @wheel</code>
    26272627</em></span>
    2628 </p></dd></dl></div></div><div class="section" title="iprint server (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2551393"></a>
     2628</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545411"></a>
    26292629
    26302630iprint server (G)
    2631 </h3></div></div></div><a class="indexterm" name="id2551394"></a><a name="IPRINTSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2631</h3></div></div></div><a class="indexterm" name="id2545412"></a><a name="IPRINTSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    26322632    This parameter is only applicable if <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing</a> is set to <code class="constant">iprint</code>.
    26332633    </p><p>
    … …  
    26382638</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>iprint server</code></em> = <code class="literal">MYCUPSSERVER</code>
    26392639</em></span>
    2640 </p></dd></dl></div></div><div class="section" title="keepalive (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2551480"></a>
     2640</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545498"></a>
    26412641
    26422642keepalive (G)
    2643 </h3></div></div></div><a class="indexterm" name="id2551481"></a><a name="KEEPALIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (an integer) represents
     2643</h3></div></div></div><a class="indexterm" name="id2545499"></a><a name="KEEPALIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (an integer) represents
    26442644    the number of seconds between <em class="parameter"><code>keepalive</code></em>
    26452645    packets. If this parameter is zero, no keepalive packets will be
    … …  
    26512651</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>keepalive</code></em> = <code class="literal">600</code>
    26522652</em></span>
    2653 </p></dd></dl></div></div><div class="section" title="kernel change notify (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2551567"></a>
     2653</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545585"></a>
    26542654
    26552655kernel change notify (S)
    2656 </h3></div></div></div><a class="indexterm" name="id2551568"></a><a name="KERNELCHANGENOTIFY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should ask the
     2656</h3></div></div></div><a class="indexterm" name="id2545586"></a><a name="KERNELCHANGENOTIFY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should ask the
    26572657        kernel for change notifications in directories so that
    26582658        SMB clients can refresh whenever the data on the server changes.
    … …  
    26612661        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>kernel change notify</code></em> = <code class="literal">yes</code>
    26622662</em></span>
    2663 </p></dd></dl></div></div><div class="section" title="kernel oplocks (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2551617"></a>
     2663</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545635"></a>
    26642664
    26652665kernel oplocks (G)
    2666 </h3></div></div></div><a class="indexterm" name="id2551618"></a><a name="KERNELOPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>For UNIXes that support kernel based <a class="link" href="smb.conf.5.html#OPLOCKS" target="_top">oplocks</a>
     2666</h3></div></div></div><a class="indexterm" name="id2545636"></a><a name="KERNELOPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>For UNIXes that support kernel based <a class="link" href="smb.conf.5.html#OPLOCKS" target="_top">oplocks</a>
    26672667        (currently only IRIX and the Linux 2.4 kernel), this parameter
    26682668        allows the use of them to be turned on or off.</p><p>Kernel oplocks support allows Samba <em class="parameter"><code>oplocks
    … …  
    26742674        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>
    26752675</em></span>
    2676 </p></dd></dl></div></div><div class="section" title="lanman auth (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2551706"></a>
     2676</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545724"></a>
    26772677
    26782678lanman auth (G)
    2679 </h3></div></div></div><a class="indexterm" name="id2551707"></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
     2679</h3></div></div></div><a class="indexterm" name="id2545725"></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
    26802680    authenticate users or permit password changes
    26812681    using the LANMAN password hash. If disabled, only clients which support NT
    … …  
    26942694    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>
    26952695</em></span>
    2696 </p></dd></dl></div></div><div class="section" title="large readwrite (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2551798"></a>
     2696</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545816"></a>
    26972697
    26982698large readwrite (G)
    2699 </h3></div></div></div><a class="indexterm" name="id2551799"></a><a name="LARGEREADWRITE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not
     2699</h3></div></div></div><a class="indexterm" name="id2545817"></a><a name="LARGEREADWRITE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not
    27002700    <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> supports the new 64k
    2701     streaming read and write varient SMB requests introduced with
     2701    streaming read and write variant SMB requests introduced with
    27022702    Windows 2000. Note that due to Windows 2000 client redirector bugs
    27032703    this requires Samba to be running on a 64-bit capable operating
    … …  
    27062706        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>
    27072707</em></span>
    2708 </p></dd></dl></div></div><div class="section" title="ldap admin dn (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2551855"></a>
     2708</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545873"></a>
    27092709
    27102710ldap admin dn (G)
    2711 </h3></div></div></div><a class="indexterm" name="id2551856"></a><a name="LDAPADMINDN"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2711</h3></div></div></div><a class="indexterm" name="id2545874"></a><a name="LDAPADMINDN"></a><div class="variablelist"><dl><dt></dt><dd><p>
    27122712        The <a class="link" href="smb.conf.5.html#LDAPADMINDN" target="_top">ldap admin dn</a> defines the Distinguished  Name (DN) name used by Samba to contact
    27132713        the ldap server when retreiving  user account information. The <a class="link" href="smb.conf.5.html#LDAPADMINDN" target="_top">ldap admin dn</a> is used
    … …  
    27172717        </p><p>
    27182718        The <a class="link" href="smb.conf.5.html#LDAPADMINDN" target="_top">ldap admin dn</a> requires a fully specified DN. The <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap  suffix</a> is not appended to the <a class="link" href="smb.conf.5.html#LDAPADMINDN" target="_top">ldap admin dn</a>.
    2719         </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="ldap connection timeout (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2551964"></a>
     2719        </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="id2545982"></a>
    27202720
    27212721ldap connection timeout (G)
    2722 </h3></div></div></div><a class="indexterm" name="id2551965"></a><a name="LDAPCONNECTIONTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2722</h3></div></div></div><a class="indexterm" name="id2545983"></a><a name="LDAPCONNECTIONTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    27232723        This parameter tells the LDAP library calls which timeout in seconds
    27242724        they should honor during initial connection establishments to LDAP servers.
    … …  
    27322732        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap connection timeout</code></em> = <code class="literal">2</code>
    27332733</em></span>
    2734 </p></dd></dl></div></div><div class="section" title="ldap debug level (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2552029"></a>
     2734</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546047"></a>
    27352735
    27362736ldap debug level (G)
    2737 </h3></div></div></div><a class="indexterm" name="id2552030"></a><a name="LDAPDEBUGLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2737</h3></div></div></div><a class="indexterm" name="id2546048"></a><a name="LDAPDEBUGLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    27382738                This parameter controls the debug level of the LDAP library
    27392739                calls. In the case of OpenLDAP, it is the same
    … …  
    27522752</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap debug level</code></em> = <code class="literal">1</code>
    27532753</em></span>
    2754 </p></dd></dl></div></div><div class="section" title="ldap debug threshold (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2552117"></a>
     2754</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546135"></a>
    27552755
    27562756ldap debug threshold (G)
    2757 </h3></div></div></div><a class="indexterm" name="id2552118"></a><a name="LDAPDEBUGTHRESHOLD"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2757</h3></div></div></div><a class="indexterm" name="id2546136"></a><a name="LDAPDEBUGTHRESHOLD"></a><div class="variablelist"><dl><dt></dt><dd><p>
    27582758                This parameter controls the Samba debug level at which
    27592759                the ldap library debug output is
    … …  
    27642764</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap debug threshold</code></em> = <code class="literal">5</code>
    27652765</em></span>
    2766 </p></dd></dl></div></div><div class="section" title="ldap delete dn (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2552184"></a>
     2766</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546203"></a>
    27672767
    27682768ldap delete dn (G)
    2769 </h3></div></div></div><a class="indexterm" name="id2552186"></a><a name="LDAPDELETEDN"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter specifies whether a delete
     2769</h3></div></div></div><a class="indexterm" name="id2546204"></a><a name="LDAPDELETEDN"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter specifies whether a delete
    27702770        operation in the ldapsam deletes the complete entry or only the attributes
    27712771        specific to Samba.
    27722772        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap delete dn</code></em> = <code class="literal">no</code>
    27732773</em></span>
    2774 </p></dd></dl></div></div><div class="section" title="ldap group suffix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2552228"></a>
     2774</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546247"></a>
    27752775
    27762776ldap group suffix (G)
    2777 </h3></div></div></div><a class="indexterm" name="id2552230"></a><a name="LDAPGROUPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the suffix that is
     2777</h3></div></div></div><a class="indexterm" name="id2546248"></a><a name="LDAPGROUPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the suffix that is
    27782778        used for groups when these are added to the LDAP directory.
    27792779        If this parameter is unset, the value of <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap suffix</a> will be used instead.  The suffix string is pre-pended to the
    … …  
    27822782</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap group suffix</code></em> = <code class="literal">ou=Groups</code>
    27832783</em></span>
    2784 </p></dd></dl></div></div><div class="section" title="ldap idmap suffix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2552312"></a>
     2784</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546330"></a>
    27852785
    27862786ldap idmap suffix (G)
    2787 </h3></div></div></div><a class="indexterm" name="id2552313"></a><a name="LDAPIDMAPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2787</h3></div></div></div><a class="indexterm" name="id2546331"></a><a name="LDAPIDMAPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
    27882788        This parameters specifies the suffix that is used when storing idmap mappings. If this parameter
    27892789        is unset, the value of <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap suffix</a> will be used instead.  The suffix
    … …  
    27932793</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap idmap suffix</code></em> = <code class="literal">ou=Idmap</code>
    27942794</em></span>
    2795 </p></dd></dl></div></div><div class="section" title="ldap machine suffix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2552395"></a>
     2795</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546413"></a>
    27962796
    27972797ldap machine suffix (G)
    2798 </h3></div></div></div><a class="indexterm" name="id2552396"></a><a name="LDAPMACHINESUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2798</h3></div></div></div><a class="indexterm" name="id2546414"></a><a name="LDAPMACHINESUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
    27992799        It specifies where machines should be added to the ldap tree.  If this parameter is unset, the value of
    28002800        <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap suffix</a> will be used instead.  The suffix string is pre-pended to the
    … …  
    28042804</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap machine suffix</code></em> = <code class="literal">ou=Computers</code>
    28052805</em></span>
    2806 </p></dd></dl></div></div><div class="section" title="ldap page size (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2552477"></a>
     2806</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546495"></a>
    28072807
    28082808ldap page size (G)
    2809 </h3></div></div></div><a class="indexterm" name="id2552478"></a><a name="LDAPPAGESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2809</h3></div></div></div><a class="indexterm" name="id2546496"></a><a name="LDAPPAGESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    28102810        This parameter specifies the number of entries per page.
    28112811        </p><p>If the LDAP server supports paged results, clients can
    … …  
    28162816</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap page size</code></em> = <code class="literal">512</code>
    28172817</em></span>
    2818 </p></dd></dl></div></div><div class="section" title="ldap passwd sync (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2552543"></a>
     2818</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546561"></a>
    28192819
    28202820ldap passwd sync (G)
    2821 </h3></div></div></div><a class="indexterm" name="id2552544"></a><a name="LDAPPASSWDSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2821</h3></div></div></div><a class="indexterm" name="id2546562"></a><a name="LDAPPASSWDSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    28222822        This option is used to define whether or not Samba should sync the LDAP password with the NT
    28232823        and LM hashes for normal accounts (NOT for workstation, server or domain trusts) on a password
    … …  
    28252825        </p><p>
    28262826        The <a class="link" href="smb.conf.5.html#LDAPPASSWDSYNC" target="_top">ldap passwd sync</a> can be set to one of three values:
    2827         </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="parameter"><code>Yes</code></em>  =  Try
    2828                         to update the LDAP, NT and LM passwords and update the pwdLastSet time.</p></li><li class="listitem"><p><em class="parameter"><code>No</code></em> = Update NT and
    2829                         LM passwords and update the pwdLastSet time.</p></li><li class="listitem"><p><em class="parameter"><code>Only</code></em> = Only update
     2827        </p><div class="itemizedlist"><ul type="disc"><li><p><em class="parameter"><code>Yes</code></em>  =  Try
     2828                        to update the LDAP, NT and LM passwords and update the pwdLastSet time.</p></li><li><p><em class="parameter"><code>No</code></em> = Update NT and
     2829                        LM passwords and update the pwdLastSet time.</p></li><li><p><em class="parameter"><code>Only</code></em> = Only update
    28302830                        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>
    28312831</em></span>
    2832 </p></dd></dl></div></div><div class="section" title="ldap replication sleep (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2552645"></a>
     2832</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546663"></a>
    28332833
    28342834ldap replication sleep (G)
    2835 </h3></div></div></div><a class="indexterm" name="id2552646"></a><a name="LDAPREPLICATIONSLEEP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2835</h3></div></div></div><a class="indexterm" name="id2546664"></a><a name="LDAPREPLICATIONSLEEP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    28362836        When Samba is asked to write to a read-only LDAP replica, we are redirected to talk to the read-write master server.
    28372837        This server then replicates our changes back to the 'local' server, however the replication might take some seconds,
    … …  
    28462846        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap replication sleep</code></em> = <code class="literal">1000</code>
    28472847</em></span>
    2848 </p></dd></dl></div></div><div class="section" title="ldapsam:editposix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2552708"></a>
     2848</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546726"></a>
    28492849
    28502850ldapsam:editposix (G)
    2851 </h3></div></div></div><a class="indexterm" name="id2552709"></a><a name="LDAPSAM:EDITPOSIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2851</h3></div></div></div><a class="indexterm" name="id2546728"></a><a name="LDAPSAM:EDITPOSIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
    28522852        Editposix is an option that leverages ldapsam:trusted to make it simpler to manage a domain controller
    28532853        eliminating the need to set up custom scripts to add and manage the posix users and groups. This option
    … …  
    29272927        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldapsam:editposix</code></em> = <code class="literal">no</code>
    29282928</em></span>
    2929 </p></dd></dl></div></div><div class="section" title="ldapsam:trusted (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2552841"></a>
     2929</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546859"></a>
    29302930
    29312931ldapsam:trusted (G)
    2932 </h3></div></div></div><a class="indexterm" name="id2552842"></a><a name="LDAPSAM:TRUSTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2932</h3></div></div></div><a class="indexterm" name="id2546860"></a><a name="LDAPSAM:TRUSTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
    29332933        By default, Samba as a Domain Controller with an LDAP backend needs to use the Unix-style NSS subsystem to
    29342934        access user and group information. Due to the way Unix stores user information in /etc/passwd and /etc/group
    … …  
    29482948        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldapsam:trusted</code></em> = <code class="literal">no</code>
    29492949</em></span>
    2950 </p></dd></dl></div></div><div class="section" title="ldap ssl ads (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2552930"></a>
     2950</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546948"></a>
    29512951
    29522952ldap ssl ads (G)
    2953 </h3></div></div></div><a class="indexterm" name="id2552931"></a><a name="LDAPSSLADS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used to define whether or not Samba should
     2953</h3></div></div></div><a class="indexterm" name="id2546949"></a><a name="LDAPSSLADS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used to define whether or not Samba should
    29542954        use SSL when connecting to the ldap server using
    29552955        <span class="emphasis"><em>ads</em></span> methods.
    … …  
    29612961        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap ssl ads</code></em> = <code class="literal">no</code>
    29622962</em></span>
    2963 </p></dd></dl></div></div><div class="section" title="ldap ssl (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2553016"></a>
     2963</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547034"></a>
    29642964
    29652965ldap ssl (G)
    2966 </h3></div></div></div><a class="indexterm" name="id2553017"></a><a name="LDAPSSL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used to define whether or not Samba should
     2966</h3></div></div></div><a class="indexterm" name="id2547035"></a><a name="LDAPSSL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used to define whether or not Samba should
    29672967        use SSL when connecting to the ldap server
    29682968        This is <span class="emphasis"><em>NOT</em></span> related to
    … …  
    29752975        <span class="emphasis"><em>or</em></span> by specifying <em class="parameter"><code>ldaps://</code></em> in
    29762976        the URL argument of <a class="link" href="smb.conf.5.html#PASSDBBACKEND" target="_top">passdb backend</a>.</p><p>The <a class="link" href="smb.conf.5.html#LDAPSSL" target="_top">ldap ssl</a> can be set to one of
    2977         two values:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="parameter"><code>Off</code></em> = Never
    2978                         use SSL when querying the directory.</p></li><li class="listitem"><p><em class="parameter"><code>start tls</code></em> = Use
     2977        two values:</p><div class="itemizedlist"><ul type="disc"><li><p><em class="parameter"><code>Off</code></em> = Never
     2978                        use SSL when querying the directory.</p></li><li><p><em class="parameter"><code>start tls</code></em> = Use
    29792979                        the LDAPv3 StartTLS extended operation (RFC2830) for
    29802980                        communicating with the directory server.</p></li></ul></div><p>
    … …  
    29892989        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap ssl</code></em> = <code class="literal">start tls</code>
    29902990</em></span>
    2991 </p></dd></dl></div></div><div class="section" title="ldap suffix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2553209"></a>
     2991</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547227"></a>
    29922992
    29932993ldap suffix (G)
    2994 </h3></div></div></div><a class="indexterm" name="id2553210"></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>
     2994</h3></div></div></div><a class="indexterm" name="id2547228"></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>
    29952995        The ldap suffix will be appended to the values specified for the <a class="link" href="smb.conf.5.html#LDAPUSERSUFFIX" target="_top">ldap user suffix</a>,
    29962996         <a class="link" href="smb.conf.5.html#LDAPGROUPSUFFIX" target="_top">ldap group suffix</a>, <a class="link" href="smb.conf.5.html#LDAPMACHINESUFFIX" target="_top">ldap machine suffix</a>, and the
    … …  
    30013001</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap suffix</code></em> = <code class="literal">dc=samba,dc=org</code>
    30023002</em></span>
    3003 </p></dd></dl></div></div><div class="section" title="ldap timeout (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2553331"></a>
     3003</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547349"></a>
    30043004
    30053005ldap timeout (G)
    3006 </h3></div></div></div><a class="indexterm" name="id2553332"></a><a name="LDAPTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3006</h3></div></div></div><a class="indexterm" name="id2547350"></a><a name="LDAPTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    30073007        This parameter defines the number of seconds that Samba should use as timeout for LDAP operations.
    30083008        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap timeout</code></em> = <code class="literal">15</code>
    30093009</em></span>
    3010 </p></dd></dl></div></div><div class="section" title="ldap user suffix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2553374"></a>
     3010</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547392"></a>
    30113011
    30123012ldap user suffix (G)
    3013 </h3></div></div></div><a class="indexterm" name="id2553375"></a><a name="LDAPUSERSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3013</h3></div></div></div><a class="indexterm" name="id2547393"></a><a name="LDAPUSERSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
    30143014        This parameter specifies where users are added to the tree. If this parameter is unset,
    30153015        the value of <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap suffix</a> will be used instead.  The suffix
    … …  
    30193019</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap user suffix</code></em> = <code class="literal">ou=people</code>
    30203020</em></span>
    3021 </p></dd></dl></div></div><div class="section" title="level2 oplocks (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2553455"></a>
     3021</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547474"></a>
    30223022
    30233023level2 oplocks (S)
    3024 </h3></div></div></div><a class="indexterm" name="id2553456"></a><a name="LEVEL2OPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether Samba supports
     3024</h3></div></div></div><a class="indexterm" name="id2547475"></a><a name="LEVEL2OPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether Samba supports
    30253025        level2 (read-only) oplocks on a share.</p><p>Level2, or read-only oplocks allow Windows NT clients
    30263026        that have an oplock on a file to downgrade from a read-write oplock
    … …  
    30423042        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>
    30433043</em></span>
    3044 </p></dd></dl></div></div><div class="section" title="lm announce (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2553562"></a>
     3044</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547580"></a>
    30453045
    30463046lm announce (G)
    3047 </h3></div></div></div><a class="indexterm" name="id2553563"></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
     3047</h3></div></div></div><a class="indexterm" name="id2547581"></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
    30483048        broadcasts that are needed by OS/2 clients in order for them to see
    30493049        the Samba server in their browse list. This parameter can have three
    … …  
    30613061</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lm announce</code></em> = <code class="literal">yes</code>
    30623062</em></span>
    3063 </p></dd></dl></div></div><div class="section" title="lm interval (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2553684"></a>
     3063</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547702"></a>
    30643064
    30653065lm interval (G)
    3066 </h3></div></div></div><a class="indexterm" name="id2553685"></a><a name="LMINTERVAL"></a><div class="variablelist"><dl><dt></dt><dd><p>If Samba is set to produce Lanman announce
     3066</h3></div></div></div><a class="indexterm" name="id2547704"></a><a name="LMINTERVAL"></a><div class="variablelist"><dl><dt></dt><dd><p>If Samba is set to produce Lanman announce
    30673067        broadcasts needed by OS/2 clients (see the
    30683068                <a class="link" href="smb.conf.5.html#LMANNOUNCE" target="_top">lm announce</a> parameter) then this
    … …  
    30743074</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lm interval</code></em> = <code class="literal">120</code>
    30753075</em></span>
    3076 </p></dd></dl></div></div><div class="section" title="load printers (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2553769"></a>
     3076</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547787"></a>
    30773077
    30783078load printers (G)
    3079 </h3></div></div></div><a class="indexterm" name="id2553770"></a><a name="LOADPRINTERS"></a><div class="variablelist"><dl><dt></dt><dd><p>A boolean variable that controls whether all
     3079</h3></div></div></div><a class="indexterm" name="id2547788"></a><a name="LOADPRINTERS"></a><div class="variablelist"><dl><dt></dt><dd><p>A boolean variable that controls whether all
    30803080    printers in the printcap will be loaded for browsing by default.
    30813081    See the <a class="link" href="smb.conf.5.html#PRINTERS" target="_top">printers</a> section for
    30823082    more details.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>load printers</code></em> = <code class="literal">yes</code>
    30833083</em></span>
    3084 </p></dd></dl></div></div><div class="section" title="local master (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2553825"></a>
     3084</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547843"></a>
    30853085
    30863086local master (G)
    3087 </h3></div></div></div><a class="indexterm" name="id2553826"></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
     3087</h3></div></div></div><a class="indexterm" name="id2547844"></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
    30883088        on a subnet. If set to <code class="constant">no</code> then <code class="literal">
    30893089        nmbd</code> will not attempt to become a local master browser
    … …  
    30953095master browser.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>local master</code></em> = <code class="literal">yes</code>
    30963096</em></span>
    3097 </p></dd></dl></div></div><div class="section" title="lock dir"><div class="titlepage"><div><div><h3 class="title"><a name="id2553925"></a>
     3097</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547943"></a>
    30983098
    30993099<a name="LOCKDIR"></a>lock dir
    3100 </h3></div></div></div><a class="indexterm" name="id2553926"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#LOCKDIRECTORY">lock directory</a>.</p></dd></dl></div></div><div class="section" title="lock directory (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2553957"></a>
     3100</h3></div></div></div><a class="indexterm" name="id2547944"></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="id2547975"></a>
    31013101
    31023102lock directory (G)
    3103 </h3></div></div></div><a class="indexterm" name="id2553958"></a><a name="LOCKDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the directory where lock
     3103</h3></div></div></div><a class="indexterm" name="id2547976"></a><a name="LOCKDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the directory where lock
    31043104        files will be placed.  The lock files are used to implement the
    31053105        <a class="link" href="smb.conf.5.html#MAXCONNECTIONS" target="_top">max connections</a> option.
    … …  
    31113111</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lock directory</code></em> = <code class="literal">/var/run/samba/locks</code>
    31123112</em></span>
    3113 </p></dd></dl></div></div><div class="section" title="locking (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2554035"></a>
     3113</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548054"></a>
    31143114
    31153115locking (S)
    3116 </h3></div></div></div><a class="indexterm" name="id2554036"></a><a name="LOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether or not locking will be
     3116</h3></div></div></div><a class="indexterm" name="id2548055"></a><a name="LOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether or not locking will be
    31173117        performed by the server in response to lock requests from the
    31183118        client.</p><p>If <code class="literal">locking = no</code>, all lock and unlock
    … …  
    31243124        is not really recommended even in this case.</p><p>Be careful about disabling locking either globally or in a
    31253125        specific service, as lack of locking may result in data corruption.
    3126         You should never need to set this parameter.</p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="lock spin count (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2554111"></a>
     3126        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="id2548129"></a>
    31273127
    31283128lock spin count (G)
    3129 </h3></div></div></div><a class="indexterm" name="id2554112"></a><a name="LOCKSPINCOUNT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter has been made inoperative in Samba 3.0.24.
     3129</h3></div></div></div><a class="indexterm" name="id2548130"></a><a name="LOCKSPINCOUNT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter has been made inoperative in Samba 3.0.24.
    31303130        The functionality it contolled is now controlled by the parameter
    31313131        <a class="link" href="smb.conf.5.html#LOCKSPINTIME" target="_top">lock spin time</a>.
    31323132        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>lock spin count</code></em> = <code class="literal">0</code>
    31333133</em></span>
    3134 </p></dd></dl></div></div><div class="section" title="lock spin time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2554166"></a>
     3134</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548185"></a>
    31353135
    31363136lock spin time (G)
    3137 </h3></div></div></div><a class="indexterm" name="id2554168"></a><a name="LOCKSPINTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The time in microseconds that smbd should
     3137</h3></div></div></div><a class="indexterm" name="id2548186"></a><a name="LOCKSPINTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The time in microseconds that smbd should
    31383138        keep waiting to see if a failed lock request can
    31393139        be granted. This parameter has changed in default
    … …  
    31433143        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>
    31443144</em></span>
    3145 </p></dd></dl></div></div><div class="section" title="log file (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2554225"></a>
     3145</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548243"></a>
    31463146
    31473147log file (G)
    3148 </h3></div></div></div><a class="indexterm" name="id2554226"></a><a name="LOGFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3148</h3></div></div></div><a class="indexterm" name="id2548244"></a><a name="LOGFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    31493149    This option allows you to override the name of the Samba log file (also known as the debug file).
    31503150    </p><p>
    … …  
    31523152    </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>
    31533153</em></span>
    3154 </p></dd></dl></div></div><div class="section" title="debuglevel"><div class="titlepage"><div><div><h3 class="title"><a name="id2554277"></a>
     3154</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548295"></a>
    31553155
    31563156<a name="DEBUGLEVEL"></a>debuglevel
    3157 </h3></div></div></div><a class="indexterm" name="id2554278"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#LOGLEVEL">log level</a>.</p></dd></dl></div></div><div class="section" title="log level (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2554308"></a>
     3157</h3></div></div></div><a class="indexterm" name="id2548296"></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="id2548326"></a>
    31583158
    31593159log level (G)
    3160 </h3></div></div></div><a class="indexterm" name="id2554309"></a><a name="LOGLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3160</h3></div></div></div><a class="indexterm" name="id2548327"></a><a name="LOGLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    31613161    The value of the parameter (a astring) allows the debug level (logging level) to be specified in the
    31623162    <code class="filename">smb.conf</code> file.
    … …  
    31653165    debug classes. This is to give greater flexibility in the configuration
    31663166    of the system. The following debug classes are currently implemented:
    3167     </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="parameter"><code>all</code></em></p></li><li class="listitem"><p><em class="parameter"><code>tdb</code></em></p></li><li class="listitem"><p><em class="parameter"><code>printdrivers</code></em></p></li><li class="listitem"><p><em class="parameter"><code>lanman</code></em></p></li><li class="listitem"><p><em class="parameter"><code>smb</code></em></p></li><li class="listitem"><p><em class="parameter"><code>rpc_parse</code></em></p></li><li class="listitem"><p><em class="parameter"><code>rpc_srv</code></em></p></li><li class="listitem"><p><em class="parameter"><code>rpc_cli</code></em></p></li><li class="listitem"><p><em class="parameter"><code>passdb</code></em></p></li><li class="listitem"><p><em class="parameter"><code>sam</code></em></p></li><li class="listitem"><p><em class="parameter"><code>auth</code></em></p></li><li class="listitem"><p><em class="parameter"><code>winbind</code></em></p></li><li class="listitem"><p><em class="parameter"><code>vfs</code></em></p></li><li class="listitem"><p><em class="parameter"><code>idmap</code></em></p></li><li class="listitem"><p><em class="parameter"><code>quota</code></em></p></li><li class="listitem"><p><em class="parameter"><code>acls</code></em></p></li><li class="listitem"><p><em class="parameter"><code>locking</code></em></p></li><li class="listitem"><p><em class="parameter"><code>msdfs</code></em></p></li><li class="listitem"><p><em class="parameter"><code>dmapi</code></em></p></li><li class="listitem"><p><em class="parameter"><code>registry</code></em></p></li></ul></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>log level</code></em> = <code class="literal">0</code>
     3167    </p><div class="itemizedlist"><ul type="disc"><li><p><em class="parameter"><code>all</code></em></p></li><li><p><em class="parameter"><code>tdb</code></em></p></li><li><p><em class="parameter"><code>printdrivers</code></em></p></li><li><p><em class="parameter"><code>lanman</code></em></p></li><li><p><em class="parameter"><code>smb</code></em></p></li><li><p><em class="parameter"><code>rpc_parse</code></em></p></li><li><p><em class="parameter"><code>rpc_srv</code></em></p></li><li><p><em class="parameter"><code>rpc_cli</code></em></p></li><li><p><em class="parameter"><code>passdb</code></em></p></li><li><p><em class="parameter"><code>sam</code></em></p></li><li><p><em class="parameter"><code>auth</code></em></p></li><li><p><em class="parameter"><code>winbind</code></em></p></li><li><p><em class="parameter"><code>vfs</code></em></p></li><li><p><em class="parameter"><code>idmap</code></em></p></li><li><p><em class="parameter"><code>quota</code></em></p></li><li><p><em class="parameter"><code>acls</code></em></p></li><li><p><em class="parameter"><code>locking</code></em></p></li><li><p><em class="parameter"><code>msdfs</code></em></p></li><li><p><em class="parameter"><code>dmapi</code></em></p></li><li><p><em class="parameter"><code>registry</code></em></p></li></ul></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>log level</code></em> = <code class="literal">0</code>
    31683168</em></span>
    31693169</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>
    31703170</em></span>
    3171 </p></dd></dl></div></div><div class="section" title="logon drive (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2554542"></a>
     3171</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548560"></a>
    31723172
    31733173logon drive (G)
    3174 </h3></div></div></div><a class="indexterm" name="id2554543"></a><a name="LOGONDRIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3174</h3></div></div></div><a class="indexterm" name="id2548561"></a><a name="LOGONDRIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    31753175        This parameter specifies the local path to which the home directory will be
    31763176        connected (see <a class="link" href="smb.conf.5.html#LOGONHOME" target="_top">logon home</a>) and is only used by NT
    … …  
    31823182</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>logon drive</code></em> = <code class="literal">h:</code>
    31833183</em></span>
    3184 </p></dd></dl></div></div><div class="section" title="logon home (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2554617"></a>
     3184</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548635"></a>
    31853185
    31863186logon home (G)
    3187 </h3></div></div></div><a class="indexterm" name="id2554618"></a><a name="LOGONHOME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3187</h3></div></div></div><a class="indexterm" name="id2548636"></a><a name="LOGONHOME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    31883188        This parameter specifies the home directory location when a Win95/98 or NT Workstation logs into a Samba PDC. 
    31893189        It allows you to do
    … …  
    32163216</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>logon home</code></em> = <code class="literal">\\remote_smb_server\%U</code>
    32173217</em></span>
    3218 </p></dd></dl></div></div><div class="section" title="logon path (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2554781"></a>
     3218</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548800"></a>
    32193219
    32203220logon path (G)
    3221 </h3></div></div></div><a class="indexterm" name="id2554782"></a><a name="LOGONPATH"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3221</h3></div></div></div><a class="indexterm" name="id2548801"></a><a name="LOGONPATH"></a><div class="variablelist"><dl><dt></dt><dd><p>
    32223222        This parameter specifies the directory where roaming profiles (Desktop, NTuser.dat, etc) are
    32233223        stored.  Contrary to previous versions of these manual pages, it has nothing to do with Win 9X roaming
    … …  
    32413241        </p><p>
    32423242        This option takes the standard substitutions, allowing you to have separate logon scripts for each user or machine.
    3243         </p><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>
    3244         Do not quote the value. Setting this as <span class="quote">&#8220;<span class="quote">\\%N\profile\%U</span>&#8221;</span>
     3243        </p><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>
     3244        Do not quote the value. Setting this as &#8220;<span class="quote">\\%N\profile\%U</span>&#8221;
    32453245        will break profile handling. Where the tdbsam or ldapsam passdb backend
    32463246        is used, at the time the user account is created the value configured
    … …  
    32633263        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>logon path</code></em> = <code class="literal">\\%N\%U\profile</code>
    32643264</em></span>
    3265 </p></dd></dl></div></div><div class="section" title="logon script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2554950"></a>
     3265</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548968"></a>
    32663266
    32673267logon script (G)
    3268 </h3></div></div></div><a class="indexterm" name="id2554951"></a><a name="LOGONSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3268</h3></div></div></div><a class="indexterm" name="id2548969"></a><a name="LOGONSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    32693269        This parameter specifies the batch file (<code class="filename">.bat</code>) or NT command file
    32703270        (<code class="filename">.cmd</code>) to be downloaded and run on a machine when a user successfully logs in.  The file
    … …  
    32973297</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>logon script</code></em> = <code class="literal">scripts\%U.bat</code>
    32983298</em></span>
    3299 </p></dd></dl></div></div><div class="section" title="lppause command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2555120"></a>
     3299</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549138"></a>
    33003300
    33013301lppause command (S)
    3302 </h3></div></div></div><a class="indexterm" name="id2555121"></a><a name="LPPAUSECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     3302</h3></div></div></div><a class="indexterm" name="id2549139"></a><a name="LPPAUSECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    33033303    executed on the server host in order to stop printing or spooling
    33043304    a specific print job.</p><p>This command should be a program or script which takes
    … …  
    33243324</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>
    33253325</em></span>
    3326 </p></dd></dl></div></div><div class="section" title="lpq cache time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2555268"></a>
     3326</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549286"></a>
    33273327
    33283328lpq cache time (G)
    3329 </h3></div></div></div><a class="indexterm" name="id2555269"></a><a name="LPQCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls how long lpq info will be cached
     3329</h3></div></div></div><a class="indexterm" name="id2549287"></a><a name="LPQCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls how long lpq info will be cached
    33303330        for to prevent the <code class="literal">lpq</code> command being called too
    33313331        often. A separate cache is kept for each variation of the <code class="literal">
    … …  
    33403340</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lpq cache time</code></em> = <code class="literal">10</code>
    33413341</em></span>
    3342 </p></dd></dl></div></div><div class="section" title="lpq command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2555386"></a>
     3342</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549404"></a>
    33433343
    33443344lpq command (S)
    3345 </h3></div></div></div><a class="indexterm" name="id2555387"></a><a name="LPQCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     3345</h3></div></div></div><a class="indexterm" name="id2549406"></a><a name="LPQCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    33463346    executed on the server host in order to obtain <code class="literal">lpq
    33473347    </code>-style printer status information.</p><p>This command should be a program or script which
    … …  
    33653365</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lpq command</code></em> = <code class="literal">/usr/bin/lpq -P%p</code>
    33663366</em></span>
    3367 </p></dd></dl></div></div><div class="section" title="lpresume command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2555513"></a>
     3367</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549531"></a>
    33683368
    33693369lpresume command (S)
    3370 </h3></div></div></div><a class="indexterm" name="id2555514"></a><a name="LPRESUMECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     3370</h3></div></div></div><a class="indexterm" name="id2549532"></a><a name="LPRESUMECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    33713371    executed on the server host in order to restart or continue
    33723372    printing or spooling a specific print job.</p><p>This command should be a program or script which takes
    … …  
    33813381    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>
    33823382</em></span>
    3383 </p></dd></dl></div></div><div class="section" title="lprm command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2555666"></a>
     3383</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549684"></a>
    33843384
    33853385lprm command (S)
    3386 </h3></div></div></div><a class="indexterm" name="id2555667"></a><a name="LPRMCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     3386</h3></div></div></div><a class="indexterm" name="id2549685"></a><a name="LPRMCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    33873387    executed on the server host in order to delete a print job.</p><p>This command should be a program or script which takes
    33883388    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
    … …  
    34013401        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>lprm command</code></em> = <code class="literal"> determined by printing parameter</code>
    34023402</em></span>
    3403 </p></dd></dl></div></div><div class="section" title="machine password timeout (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2555753"></a>
     3403</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549771"></a>
    34043404
    34053405machine password timeout (G)
    3406 </h3></div></div></div><a class="indexterm" name="id2555754"></a><a name="MACHINEPASSWORDTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3406</h3></div></div></div><a class="indexterm" name="id2549772"></a><a name="MACHINEPASSWORDTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    34073407        If a Samba server is a member of a Windows NT Domain (see the <a class="link" href="smb.conf.5.html#SECURITY" target="_top">security = domain</a> parameter) then periodically a running smbd process will try and change
    34083408        the MACHINE ACCOUNT PASSWORD stored in the TDB called <code class="filename">private/secrets.tdb
    … …  
    34143414        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>machine password timeout</code></em> = <code class="literal">604800</code>
    34153415</em></span>
    3416 </p></dd></dl></div></div><div class="section" title="magic output (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2555841"></a>
     3416</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549859"></a>
    34173417
    34183418magic output (S)
    3419 </h3></div></div></div><a class="indexterm" name="id2555842"></a><a name="MAGICOUTPUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3419</h3></div></div></div><a class="indexterm" name="id2549860"></a><a name="MAGICOUTPUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    34203420        This parameter specifies the name of a file which will contain output created by a magic script (see the
    34213421        <a class="link" href="smb.conf.5.html#MAGICSCRIPT" target="_top">magic script</a> parameter below).
    3422         </p><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>If two clients use the same <em class="parameter"><code>magic script
     3422        </p><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>If two clients use the same <em class="parameter"><code>magic script
    34233423        </code></em> in the same directory the output file content is undefined.
    34243424        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>magic output</code></em> = <code class="literal">&lt;magic script name&gt;.out</code>
    … …  
    34263426</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>magic output</code></em> = <code class="literal">myfile.txt</code>
    34273427</em></span>
    3428 </p></dd></dl></div></div><div class="section" title="magic script (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2555925"></a>
     3428</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549943"></a>
    34293429
    34303430magic script (S)
    3431 </h3></div></div></div><a class="indexterm" name="id2555926"></a><a name="MAGICSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the name of a file which,
     3431</h3></div></div></div><a class="indexterm" name="id2549944"></a><a name="MAGICSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the name of a file which,
    34323432        if opened, will be executed by the server when the file is closed.
    34333433        This allows a UNIX script to be sent to the Samba host and
    … …  
    34453445</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>magic script</code></em> = <code class="literal">user.csh</code>
    34463446</em></span>
    3447 </p></dd></dl></div></div><div class="section" title="mangled names (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2556030"></a>
     3447</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550048"></a>
    34483448
    34493449mangled names (S)
    3450 </h3></div></div></div><a class="indexterm" name="id2556031"></a><a name="MANGLEDNAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether non-DOS names under UNIX
     3450</h3></div></div></div><a class="indexterm" name="id2550050"></a><a name="MANGLEDNAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether non-DOS names under UNIX
    34513451        should be mapped to DOS-compatible names ("mangled") and made visible,
    34523452        or whether non-DOS names should simply be ignored.</p><p>See the section on <a class="link" href="smb.conf.5.html#NAMEMANGLING" target="_top">name mangling</a> for
    3453         details on how to control the mangling process.</p><p>If mangling is used then the mangling algorithm is as follows:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>The first (up to) five alphanumeric characters
     3453        details on how to control the mangling process.</p><p>If mangling is used then the mangling algorithm is as follows:</p><div class="itemizedlist"><ul type="disc"><li><p>The first (up to) five alphanumeric characters
    34543454                        before the rightmost dot of the filename are preserved, forced
    34553455                        to upper case, and appear as the first (up to) five characters
    3456                         of the mangled name.</p></li><li class="listitem"><p>A tilde "~" is appended to the first part of the mangled
     3456                        of the mangled name.</p></li><li><p>A tilde "~" is appended to the first part of the mangled
    34573457                        name, followed by a two-character unique sequence, based on the
    34583458                        original root name (i.e., the original filename minus its final
    … …  
    34613461                        characters.</p><p>Note that the character to use may be specified using
    34623462                                the <a class="link" href="smb.conf.5.html#MANGLINGCHAR" target="_top">mangling char</a>
    3463                         option, if you don't like '~'.</p></li><li class="listitem"><p>Files whose UNIX name begins with a dot will be
     3463                        option, if you don't like '~'.</p></li><li><p>Files whose UNIX name begins with a dot will be
    34643464                        presented as DOS hidden files. The mangled name will be created as
    34653465                        for other filenames, but with the leading dot removed and "___" as
    … …  
    34733473        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>
    34743474</em></span>
    3475 </p></dd></dl></div></div><div class="section" title="mangle prefix (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2556167"></a>
     3475</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550186"></a>
    34763476
    34773477mangle prefix (G)
    3478 </h3></div></div></div><a class="indexterm" name="id2556168"></a><a name="MANGLEPREFIX"></a><div class="variablelist"><dl><dt></dt><dd><p> controls the number of prefix
     3478</h3></div></div></div><a class="indexterm" name="id2550187"></a><a name="MANGLEPREFIX"></a><div class="variablelist"><dl><dt></dt><dd><p> controls the number of prefix
    34793479        characters from the original name used when generating
    34803480        the mangled names. A larger value will give a weaker
    … …  
    34863486</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>mangle prefix</code></em> = <code class="literal">4</code>
    34873487</em></span>
    3488 </p></dd></dl></div></div><div class="section" title="mangling char (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2556234"></a>
     3488</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550252"></a>
    34893489
    34903490mangling char (S)
    3491 </h3></div></div></div><a class="indexterm" name="id2556235"></a><a name="MANGLINGCHAR"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what character is used as
     3491</h3></div></div></div><a class="indexterm" name="id2550253"></a><a name="MANGLINGCHAR"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what character is used as
    34923492        the <span class="emphasis"><em>magic</em></span> character in <a class="link" href="smb.conf.5.html#NAMEMANGLING" target="_top">name mangling</a>. The
    34933493        default is a '~' but this may interfere with some software. Use this option to set
    … …  
    34963496</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>mangling char</code></em> = <code class="literal">^</code>
    34973497</em></span>
    3498 </p></dd></dl></div></div><div class="section" title="mangling method (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2556312"></a>
     3498</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550330"></a>
    34993499
    35003500mangling method (G)
    3501 </h3></div></div></div><a class="indexterm" name="id2556313"></a><a name="MANGLINGMETHOD"></a><div class="variablelist"><dl><dt></dt><dd><p> controls the algorithm used for the generating
     3501</h3></div></div></div><a class="indexterm" name="id2550331"></a><a name="MANGLINGMETHOD"></a><div class="variablelist"><dl><dt></dt><dd><p> controls the algorithm used for the generating
    35023502        the mangled names. Can take two different values, "hash" and
    35033503        "hash2". "hash" is the algorithm that was used
    … …  
    35103510</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>mangling method</code></em> = <code class="literal">hash</code>
    35113511</em></span>
    3512 </p></dd></dl></div></div><div class="section" title="map acl inherit (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2556379"></a>
     3512</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550397"></a>
    35133513
    35143514map acl inherit (S)
    3515 </h3></div></div></div><a class="indexterm" name="id2556380"></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'
     3515</h3></div></div></div><a class="indexterm" name="id2550398"></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'
    35163516    access control entry flags stored in Windows ACLs into an extended attribute
    35173517    called user.SAMBA_PAI. This parameter only takes effect if Samba is being run
    … …  
    35213521    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>map acl inherit</code></em> = <code class="literal">no</code>
    35223522</em></span>
    3523 </p></dd></dl></div></div><div class="section" title="map archive (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2556436"></a>
     3523</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550454"></a>
    35243524
    35253525map archive (S)
    3526 </h3></div></div></div><a class="indexterm" name="id2556437"></a><a name="MAPARCHIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3526</h3></div></div></div><a class="indexterm" name="id2550455"></a><a name="MAPARCHIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    35273527        This controls whether the DOS archive attribute
    35283528        should be mapped to the UNIX owner execute bit.  The DOS archive bit
    … …  
    35373537        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>map archive</code></em> = <code class="literal">yes</code>
    35383538</em></span>
    3539 </p></dd></dl></div></div><div class="section" title="map hidden (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2556511"></a>
     3539</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550529"></a>
    35403540
    35413541map hidden (S)
    3542 </h3></div></div></div><a class="indexterm" name="id2556512"></a><a name="MAPHIDDEN"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3542</h3></div></div></div><a class="indexterm" name="id2550530"></a><a name="MAPHIDDEN"></a><div class="variablelist"><dl><dt></dt><dd><p>
    35433543        This controls whether DOS style hidden files should be mapped to the UNIX world execute bit.
    35443544        </p><p>
    … …  
    35463546        bit is not masked out (i.e. it must include 001). See the parameter <a class="link" href="smb.conf.5.html#CREATEMASK" target="_top">create mask</a>
    35473547        for details.
    3548         </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="map read only (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2556569"></a>
     3548        </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="id2550587"></a>
    35493549
    35503550map read only (S)
    3551 </h3></div></div></div><a class="indexterm" name="id2556570"></a><a name="MAPREADONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3551</h3></div></div></div><a class="indexterm" name="id2550588"></a><a name="MAPREADONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    35523552        This controls how the DOS read only attribute should be mapped from a UNIX filesystem.
    35533553        </p><p>
    … …  
    35563556        present. If <a class="link" href="smb.conf.5.html#STOREDOSATTRIBUTES" target="_top">store dos attributes</a> is set to <code class="constant">yes</code> then this
    35573557        parameter is <span class="emphasis"><em>ignored</em></span>. This is a new parameter introduced in Samba version 3.0.21.
    3558         </p><p>The three settings are :</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     3558        </p><p>The three settings are :</p><div class="itemizedlist"><ul type="disc"><li><p>
    35593559                <code class="constant">Yes</code> - The read only DOS attribute is mapped to the inverse of the user
    35603560                or owner write bit in the unix permission mode set. If the owner write bit is not set, the
    … …  
    35643564                If the read only DOS attribute is unset, Samba simply sets the write bit of the
    35653565                owner to one.
    3566                 </p></li><li class="listitem"><p>
     3566                </p></li><li><p>
    35673567                <code class="constant">Permissions</code> - The read only DOS attribute is mapped to the effective permissions of
    35683568                the connecting user, as evaluated by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> by reading the unix permissions and POSIX ACL (if present).
    35693569                If the connecting user does not have permission to modify the file, the read only attribute
    35703570                is reported as being set on the file.
    3571                 </p></li><li class="listitem"><p>
     3571                </p></li><li><p>
    35723572                <code class="constant">No</code> - The read only DOS attribute is unaffected by permissions, and can only be set by
    35733573                the <a class="link" href="smb.conf.5.html#STOREDOSATTRIBUTES" target="_top">store dos attributes</a> method. This may be useful for exporting mounted CDs.
    35743574                </p></li></ul></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>map read only</code></em> = <code class="literal">yes</code>
    35753575</em></span>
    3576 </p></dd></dl></div></div><div class="section" title="map system (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2556725"></a>
     3576</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550744"></a>
    35773577
    35783578map system (S)
    3579 </h3></div></div></div><a class="indexterm" name="id2556726"></a><a name="MAPSYSTEM"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3579</h3></div></div></div><a class="indexterm" name="id2550745"></a><a name="MAPSYSTEM"></a><div class="variablelist"><dl><dt></dt><dd><p>
    35803580        This controls whether DOS style system files should be mapped to the UNIX group execute bit.
    35813581        </p><p>
    … …  
    35853585        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>map system</code></em> = <code class="literal">no</code>
    35863586</em></span>
    3587 </p></dd></dl></div></div><div class="section" title="map to guest (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2556795"></a>
     3587</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550813"></a>
    35883588
    35893589map to guest (G)
    3590 </h3></div></div></div><a class="indexterm" name="id2556796"></a><a name="MAPTOGUEST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only useful in <a class="link" href="smb.conf.5.html#SECURITY" target="_top">SECURITY =
     3590</h3></div></div></div><a class="indexterm" name="id2550814"></a><a name="MAPTOGUEST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only useful in <a class="link" href="smb.conf.5.html#SECURITY" target="_top">SECURITY =
    35913591    security</a> modes other than <em class="parameter"><code>security = share</code></em>
    35923592    and <em class="parameter"><code>security = server</code></em>
    35933593    - i.e. <code class="constant">user</code>, and <code class="constant">domain</code>.</p><p>This parameter can take four different values, which tell
    35943594    <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> what to do with user
    3595     login requests that don't match a valid UNIX user in some way.</p><p>The four settings are :</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="constant">Never</code> - Means user login
     3595    login requests that don't match a valid UNIX user in some way.</p><p>The four settings are :</p><div class="itemizedlist"><ul type="disc"><li><p><code class="constant">Never</code> - Means user login
    35963596            requests with an invalid password are rejected. This is the
    3597             default.</p></li><li class="listitem"><p><code class="constant">Bad User</code> - Means user
     3597            default.</p></li><li><p><code class="constant">Bad User</code> - Means user
    35983598            logins with an invalid password are rejected, unless the username
    35993599            does not exist, in which case it is treated as a guest login and
    3600             mapped into the <a class="link" href="smb.conf.5.html#GUESTACCOUNT" target="_top">guest account</a>.</p></li><li class="listitem"><p><code class="constant">Bad Password</code> - Means user logins
     3600            mapped into the <a class="link" href="smb.conf.5.html#GUESTACCOUNT" target="_top">guest account</a>.</p></li><li><p><code class="constant">Bad Password</code> - Means user logins
    36013601            with an invalid password are treated as a guest login and mapped
    36023602            into the <a class="link" href="smb.conf.5.html#GUESTACCOUNT" target="_top">guest account</a>. Note that
    … …  
    36073607            that they got their password wrong. Helpdesk services will
    36083608            <span class="emphasis"><em>hate</em></span> you if you set the <em class="parameter"><code>map to
    3609             guest</code></em> parameter this way :-).</p></li><li class="listitem"><p><code class="constant">Bad Uid</code> - Is only applicable when Samba is configured
     3609            guest</code></em> parameter this way :-).</p></li><li><p><code class="constant">Bad Uid</code> - Is only applicable when Samba is configured
    36103610            in some type of domain mode security (security = {domain|ads}) and means that
    36113611            user logins which are successfully authenticated but which have no valid Unix
    … …  
    36303630</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>map to guest</code></em> = <code class="literal">Bad User</code>
    36313631</em></span>
    3632 </p></dd></dl></div></div><div class="section" title="max connections (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2557035"></a>
     3632</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551053"></a>
    36333633
    36343634max connections (S)
    3635 </h3></div></div></div><a class="indexterm" name="id2557036"></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.
     3635</h3></div></div></div><a class="indexterm" name="id2551054"></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.
    36363636    If <em class="parameter"><code>max connections</code></em> is greater than 0 then connections
    36373637    will be refused if this number of connections to the service are already open. A value
    … …  
    36413641</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max connections</code></em> = <code class="literal">10</code>
    36423642</em></span>
    3643 </p></dd></dl></div></div><div class="section" title="max disk size (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2557121"></a>
     3643</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551139"></a>
    36443644
    36453645max disk size (G)
    3646 </h3></div></div></div><a class="indexterm" name="id2557122"></a><a name="MAXDISKSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to put an upper limit
     3646</h3></div></div></div><a class="indexterm" name="id2551140"></a><a name="MAXDISKSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to put an upper limit
    36473647    on the apparent size of disks. If you set this option to 100
    36483648    then all shares will appear to be not larger than 100 MB in
    … …  
    36583658</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max disk size</code></em> = <code class="literal">1000</code>
    36593659</em></span>
    3660 </p></dd></dl></div></div><div class="section" title="max log size (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2557213"></a>
     3660</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551231"></a>
    36613661
    36623662max log size (G)
    3663 </h3></div></div></div><a class="indexterm" name="id2557214"></a><a name="MAXLOGSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3663</h3></div></div></div><a class="indexterm" name="id2551232"></a><a name="MAXLOGSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    36643664    This option (an integer in kilobytes) specifies the max size the log file should grow to.
    36653665    Samba periodically checks the size and if it is exceeded it will rename the file, adding
    … …  
    36703670</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max log size</code></em> = <code class="literal">1000</code>
    36713671</em></span>
    3672 </p></dd></dl></div></div><div class="section" title="max mux (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2557284"></a>
     3672</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551302"></a>
    36733673
    36743674max mux (G)
    3675 </h3></div></div></div><a class="indexterm" name="id2557285"></a><a name="MAXMUX"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum number of
     3675</h3></div></div></div><a class="indexterm" name="id2551303"></a><a name="MAXMUX"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum number of
    36763676    outstanding simultaneous SMB operations that Samba tells the client
    36773677        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>
    36783678</em></span>
    3679 </p></dd></dl></div></div><div class="section" title="max open files (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2557327"></a>
     3679</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551345"></a>
    36803680
    36813681max open files (G)
    3682 </h3></div></div></div><a class="indexterm" name="id2557328"></a><a name="MAXOPENFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of
     3682</h3></div></div></div><a class="indexterm" name="id2551346"></a><a name="MAXOPENFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of
    36833683    open files that one <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> file
    36843684    serving process may have open for a client at any one time. The
    … …  
    36883688    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>
    36893689</em></span>
    3690 </p></dd></dl></div></div><div class="section" title="max print jobs (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2557387"></a>
     3690</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551405"></a>
    36913691
    36923692max print jobs (S)
    3693 </h3></div></div></div><a class="indexterm" name="id2557388"></a><a name="MAXPRINTJOBS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of
     3693</h3></div></div></div><a class="indexterm" name="id2551406"></a><a name="MAXPRINTJOBS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of
    36943694    jobs allowable in a Samba printer queue at any given moment.
    36953695    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.
    … …  
    36983698</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max print jobs</code></em> = <code class="literal">5000</code>
    36993699</em></span>
    3700 </p></dd></dl></div></div><div class="section" title="protocol"><div class="titlepage"><div><div><h3 class="title"><a name="id2557457"></a>
     3700</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551475"></a>
    37013701
    37023702<a name="PROTOCOL"></a>protocol
    3703 </h3></div></div></div><a class="indexterm" name="id2557458"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#MAXPROTOCOL">max protocol</a>.</p></dd></dl></div></div><div class="section" title="max protocol (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2557490"></a>
     3703</h3></div></div></div><a class="indexterm" name="id2551476"></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="id2551508"></a>
    37043704
    37053705max protocol (G)
    3706 </h3></div></div></div><a class="indexterm" name="id2557491"></a><a name="MAXPROTOCOL"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a string) is the highest
    3707     protocol level that will be supported by the server.</p><p>Possible values are :</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="constant">CORE</code>: Earliest version. No
    3708             concept of user names.</p></li><li class="listitem"><p><code class="constant">COREPLUS</code>: Slight improvements on
    3709             CORE for efficiency.</p></li><li class="listitem"><p><code class="constant">LANMAN1</code>: First <span class="emphasis"><em>
     3706</h3></div></div></div><a class="indexterm" name="id2551509"></a><a name="MAXPROTOCOL"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a string) is the highest
     3707    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
     3708            concept of user names.</p></li><li><p><code class="constant">COREPLUS</code>: Slight improvements on
     3709            CORE for efficiency.</p></li><li><p><code class="constant">LANMAN1</code>: First <span class="emphasis"><em>
    37103710            modern</em></span> version of the protocol. Long filename
    3711             support.</p></li><li class="listitem"><p><code class="constant">LANMAN2</code>: Updates to Lanman1 protocol.</p></li><li class="listitem"><p><code class="constant">NT1</code>: Current up to date version of the protocol.
     3711            support.</p></li><li><p><code class="constant">LANMAN2</code>: Updates to Lanman1 protocol.</p></li><li><p><code class="constant">NT1</code>: Current up to date version of the protocol.
    37123712            Used by Windows NT. Known as CIFS.</p></li></ul></div><p>Normally this option should not be set as the automatic
    37133713    negotiation phase in the SMB protocol takes care of choosing
    … …  
    37163716</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max protocol</code></em> = <code class="literal">LANMAN1</code>
    37173717</em></span>
    3718 </p></dd></dl></div></div><div class="section" title="max reported print jobs (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2557615"></a>
     3718</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551633"></a>
    37193719
    37203720max reported print jobs (S)
    3721 </h3></div></div></div><a class="indexterm" name="id2557616"></a><a name="MAXREPORTEDPRINTJOBS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3721</h3></div></div></div><a class="indexterm" name="id2551634"></a><a name="MAXREPORTEDPRINTJOBS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    37223722    This parameter limits the maximum number of jobs displayed in a port monitor for
    37233723    Samba printer queue at any given moment. If this number is exceeded, the excess
    … …  
    37283728</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max reported print jobs</code></em> = <code class="literal">1000</code>
    37293729</em></span>
    3730 </p></dd></dl></div></div><div class="section" title="max smbd processes (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2557679"></a>
     3730</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551697"></a>
    37313731
    37323732max smbd processes (G)
    3733 </h3></div></div></div><a class="indexterm" name="id2557680"></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
     3733</h3></div></div></div><a class="indexterm" name="id2551698"></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
    37343734    as a stopgap to prevent degrading service to clients in the event that the server has insufficient
    37353735    resources to handle more than this number of connections.  Remember that under normal operating
    … …  
    37393739</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max smbd processes</code></em> = <code class="literal">1000</code>
    37403740</em></span>
    3741 </p></dd></dl></div></div><div class="section" title="max stat cache size (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2557760"></a>
     3741</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551779"></a>
    37423742
    37433743max stat cache size (G)
    3744 </h3></div></div></div><a class="indexterm" name="id2557762"></a><a name="MAXSTATCACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the size in memory of any
     3744</h3></div></div></div><a class="indexterm" name="id2551780"></a><a name="MAXSTATCACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the size in memory of any
    37453745          <em class="parameter"><code>stat cache</code></em> being used
    37463746          to speed up case insensitive name mappings. It represents
    … …  
    37533753</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max stat cache size</code></em> = <code class="literal">100</code>
    37543754</em></span>
    3755 </p></dd></dl></div></div><div class="section" title="max ttl (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2557830"></a>
     3755</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551848"></a>
    37563756
    37573757max ttl (G)
    3758 </h3></div></div></div><a class="indexterm" name="id2557831"></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'
     3758</h3></div></div></div><a class="indexterm" name="id2551849"></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'
    37593759    of NetBIOS names should be (in seconds) when <code class="literal">nmbd</code> is
    37603760    requesting a name using either a broadcast packet or from a WINS server. You should
    37613761        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>
    37623762</em></span>
    3763 </p></dd></dl></div></div><div class="section" title="max wins ttl (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2557889"></a>
     3763</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551907"></a>
    37643764
    37653765max wins ttl (G)
    3766 </h3></div></div></div><a class="indexterm" name="id2557890"></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
     3766</h3></div></div></div><a class="indexterm" name="id2551908"></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
    37673767        (<a class="link" href="smb.conf.5.html#WINSSUPPORT" target="_top">wins support = yes</a>) what the maximum
    37683768    'time to live' of NetBIOS names that <code class="literal">nmbd</code>
    … …  
    37703770        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>
    37713771</em></span>
    3772 </p></dd></dl></div></div><div class="section" title="max xmit (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2557960"></a>
     3772</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551978"></a>
    37733773
    37743774max xmit (G)
    3775 </h3></div></div></div><a class="indexterm" name="id2557961"></a><a name="MAXXMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum packet size
     3775</h3></div></div></div><a class="indexterm" name="id2551979"></a><a name="MAXXMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum packet size
    37763776    that will be negotiated by Samba. The default is 16644, which
    37773777    matches the behavior of Windows 2000.  A value below 2048 is likely to cause problems.
    … …  
    37813781</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max xmit</code></em> = <code class="literal">8192</code>
    37823782</em></span>
    3783 </p></dd></dl></div></div><div class="section" title="message command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2558023"></a>
     3783</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552041"></a>
    37843784
    37853785message command (G)
    3786 </h3></div></div></div><a class="indexterm" name="id2558024"></a><a name="MESSAGECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies what command to run when the
     3786</h3></div></div></div><a class="indexterm" name="id2552042"></a><a name="MESSAGECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies what command to run when the
    37873787        server receives a WinPopup style message.</p><p>This would normally be a command that would
    37883788        deliver the message somehow. How this is to be done is
    … …  
    38003800        %u</code></em> won't work (<em class="parameter"><code>%U</code></em> may be better
    38013801        in this case).</p><p>Apart from the standard substitutions, some additional
    3802         ones apply. In particular:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="parameter"><code>%s</code></em> = the filename containing
    3803                                 the message.</p></li><li class="listitem"><p><em class="parameter"><code>%t</code></em> = the destination that
    3804                                 the message was sent to (probably the server name).</p></li><li class="listitem"><p><em class="parameter"><code>%f</code></em> = who the message
     3802        ones apply. In particular:</p><div class="itemizedlist"><ul type="disc"><li><p><em class="parameter"><code>%s</code></em> = the filename containing
     3803                                the message.</p></li><li><p><em class="parameter"><code>%t</code></em> = the destination that
     3804                                the message was sent to (probably the server name).</p></li><li><p><em class="parameter"><code>%f</code></em> = who the message
    38053805                                is from.</p></li></ul></div><p>You could make this command send mail, or whatever else
    38063806        takes your fancy. Please let us know of any really interesting
    … …  
    38233823</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>
    38243824</em></span>
    3825 </p></dd></dl></div></div><div class="section" title="min print space (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2558233"></a>
     3825</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552251"></a>
    38263826
    38273827min print space (S)
    3828 </h3></div></div></div><a class="indexterm" name="id2558234"></a><a name="MINPRINTSPACE"></a><div class="variablelist"><dl><dt></dt><dd><p>This sets the minimum amount of free disk
     3828</h3></div></div></div><a class="indexterm" name="id2552252"></a><a name="MINPRINTSPACE"></a><div class="variablelist"><dl><dt></dt><dd><p>This sets the minimum amount of free disk
    38293829    space that must be available before a user will be able to spool
    38303830    a print job. It is specified in kilobytes. The default is 0, which
    … …  
    38333833</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>min print space</code></em> = <code class="literal">2000</code>
    38343834</em></span>
    3835 </p></dd></dl></div></div><div class="section" title="min protocol (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2558295"></a>
     3835</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552313"></a>
    38363836
    38373837min protocol (G)
    3838 </h3></div></div></div><a class="indexterm" name="id2558296"></a><a name="MINPROTOCOL"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a string) is the
     3838</h3></div></div></div><a class="indexterm" name="id2552314"></a><a name="MINPROTOCOL"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a string) is the
    38393839    lowest SMB protocol dialect than Samba will support.  Please refer
    38403840    to the <a class="link" href="smb.conf.5.html#MAXPROTOCOL" target="_top">max protocol</a>
    … …  
    38483848</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>min protocol</code></em> = <code class="literal">NT1</code>
    38493849</em></span>
    3850 </p></dd></dl></div></div><div class="section" title="min receivefile size (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2558394"></a>
     3850</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552412"></a>
    38513851
    38523852min receivefile size (G)
    3853 </h3></div></div></div><a class="indexterm" name="id2558395"></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
     3853</h3></div></div></div><a class="indexterm" name="id2552413"></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
    38543854SMBwriteX call on a non-signed SMB/CIFS connection greater than this value will not be processed in the normal way but will
    38553855be passed to any underlying kernel recvfile or splice system call (if there is no such
    … …  
    38603860nonzero. 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>
    38613861</em></span>
    3862 </p></dd></dl></div></div><div class="section" title="min wins ttl (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2558463"></a>
     3862</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552481"></a>
    38633863
    38643864min wins ttl (G)
    3865 </h3></div></div></div><a class="indexterm" name="id2558464"></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>
     3865</h3></div></div></div><a class="indexterm" name="id2552482"></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>
    38663866    when acting as a WINS server (<a class="link" href="smb.conf.5.html#WINSSUPPORT" target="_top">wins support = yes</a>) what the minimum 'time to live'
    38673867    of NetBIOS names that <code class="literal">nmbd</code> will grant will be (in
    … …  
    38693869    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>
    38703870</em></span>
    3871 </p></dd></dl></div></div><div class="section" title="msdfs proxy (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2558534"></a>
     3871</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552552"></a>
    38723872
    38733873msdfs proxy (S)
    3874 </h3></div></div></div><a class="indexterm" name="id2558535"></a><a name="MSDFSPROXY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter indicates that the share is a
     3874</h3></div></div></div><a class="indexterm" name="id2552553"></a><a name="MSDFSPROXY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter indicates that the share is a
    38753875        stand-in for another CIFS share whose location is specified by
    38763876        the value of the parameter. When clients attempt to connect to
    … …  
    38803880        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>
    38813881</em></span>
    3882 </p></dd></dl></div></div><div class="section" title="msdfs root (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2558612"></a>
     3882</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552630"></a>
    38833883
    38843884msdfs root (S)
    3885 </h3></div></div></div><a class="indexterm" name="id2558613"></a><a name="MSDFSROOT"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to <code class="constant">yes</code>, Samba treats the
     3885</h3></div></div></div><a class="indexterm" name="id2552631"></a><a name="MSDFSROOT"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to <code class="constant">yes</code>, Samba treats the
    38863886        share as a Dfs root and allows clients to browse the
    38873887        distributed file system tree rooted at the share directory.
    … …  
    38913891        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>
    38923892</em></span>
    3893 </p></dd></dl></div></div><div class="section" title="name cache timeout (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2558667"></a>
     3893</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552685"></a>
    38943894
    38953895name cache timeout (G)
    3896 </h3></div></div></div><a class="indexterm" name="id2558668"></a><a name="NAMECACHETIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the number of seconds it takes before
     3896</h3></div></div></div><a class="indexterm" name="id2552686"></a><a name="NAMECACHETIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the number of seconds it takes before
    38973897    entries in samba's hostname resolve cache time out. If
    38983898    the timeout is set to 0. the caching is disabled.
    … …  
    39013901</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>name cache timeout</code></em> = <code class="literal">0</code>
    39023902</em></span>
    3903 </p></dd></dl></div></div><div class="section" title="name resolve order (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2558728"></a>
     3903</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552746"></a>
    39043904
    39053905name resolve order (G)
    3906 </h3></div></div></div><a class="indexterm" name="id2558729"></a><a name="NAMERESOLVEORDER"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used by the programs in the Samba
     3906</h3></div></div></div><a class="indexterm" name="id2552747"></a><a name="NAMERESOLVEORDER"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used by the programs in the Samba
    39073907    suite to determine what naming services to use and in what order
    39083908    to resolve host names to IP addresses. Its main purpose to is to
    … …  
    39103910    separated string of name resolution options.</p><p>The options are: "lmhosts", "host",
    39113911    "wins" and "bcast". They cause names to be
    3912     resolved as follows:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     3912    resolved as follows:</p><div class="itemizedlist"><ul type="disc"><li><p>
    39133913                <code class="constant">lmhosts</code> : Lookup an IP address in the Samba lmhosts file. If the line in lmhosts has
    39143914            no name type attached to the NetBIOS name (see the manpage for lmhosts for details) then
    39153915            any name type matches for lookup.
    3916                 </p></li><li class="listitem"><p>
     3916                </p></li><li><p>
    39173917                <code class="constant">host</code> : Do a standard host name to IP address resolution, using the system
    39183918                <code class="filename">/etc/hosts </code>, NIS, or DNS lookups. This method of name resolution is
    … …  
    39213921                useful for active directory domains and results in a DNS query for the SRV RR entry matching
    39223922                _ldap._tcp.domain.
    3923         </p></li><li class="listitem"><p><code class="constant">wins</code> : Query a name with
     3923        </p></li><li><p><code class="constant">wins</code> : Query a name with
    39243924            the IP address listed in the <a class="link" href="smb.conf.5.html#WINSSERVER" target="_top">WINSSERVER</a> parameter.  If no WINS server has
    3925             been specified this method will be ignored.</p></li><li class="listitem"><p><code class="constant">bcast</code> : Do a broadcast on
     3925            been specified this method will be ignored.</p></li><li><p><code class="constant">bcast</code> : Do a broadcast on
    39263926            each of the known local interfaces listed in the <a class="link" href="smb.conf.5.html#INTERFACES" target="_top">interfaces</a>
    39273927            parameter. This is the least reliable of the name resolution
    … …  
    39353935</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>name resolve order</code></em> = <code class="literal">lmhosts bcast host</code>
    39363936</em></span>
    3937 </p></dd></dl></div></div><div class="section" title="netbios aliases (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2558930"></a>
     3937</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552948"></a>
    39383938
    39393939netbios aliases (G)
    3940 </h3></div></div></div><a class="indexterm" name="id2558931"></a><a name="NETBIOSALIASES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of NetBIOS names that nmbd will
     3940</h3></div></div></div><a class="indexterm" name="id2552950"></a><a name="NETBIOSALIASES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of NetBIOS names that nmbd will
    39413941        advertise as additional names by which the Samba server is known. This allows one machine
    39423942        to appear in browse lists under multiple names. If a machine is acting as a browse server
    … …  
    39483948</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>netbios aliases</code></em> = <code class="literal">TEST TEST1 TEST2</code>
    39493949</em></span>
    3950 </p></dd></dl></div></div><div class="section" title="netbios name (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2558996"></a>
     3950</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553015"></a>
    39513951
    39523952netbios name (G)
    3953 </h3></div></div></div><a class="indexterm" name="id2558998"></a><a name="NETBIOSNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3953</h3></div></div></div><a class="indexterm" name="id2553016"></a><a name="NETBIOSNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    39543954                This sets the NetBIOS name by which a Samba server is known. By default it is the same as the first component
    39553955                of the host's DNS name. If a machine is a browse server or logon server this name (or the first component of
    … …  
    39643964</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>netbios name</code></em> = <code class="literal">MYNAME</code>
    39653965</em></span>
    3966 </p></dd></dl></div></div><div class="section" title="netbios scope (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2559078"></a>
     3966</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553096"></a>
    39673967
    39683968netbios scope (G)
    3969 </h3></div></div></div><a class="indexterm" name="id2559079"></a><a name="NETBIOSSCOPE"></a><div class="variablelist"><dl><dt></dt><dd><p>This sets the NetBIOS scope that Samba will
     3969</h3></div></div></div><a class="indexterm" name="id2553097"></a><a name="NETBIOSSCOPE"></a><div class="variablelist"><dl><dt></dt><dd><p>This sets the NetBIOS scope that Samba will
    39703970        operate under. This should not be set unless every machine
    39713971        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>
    39723972</em></span>
    3973 </p></dd></dl></div></div><div class="section" title="nis homedir (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2559120"></a>
     3973</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553138"></a>
    39743974
    39753975nis homedir (G)
    3976 </h3></div></div></div><a class="indexterm" name="id2559121"></a><a name="NISHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>Get the home share server from a NIS map. For
     3976</h3></div></div></div><a class="indexterm" name="id2553140"></a><a name="NISHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>Get the home share server from a NIS map. For
    39773977        UNIX systems that use an automounter, the user's home directory
    39783978        will often be mounted on a workstation on demand from a remote
    … …  
    39933993        be a logon server.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>nis homedir</code></em> = <code class="literal">no</code>
    39943994</em></span>
    3995 </p></dd></dl></div></div><div class="section" title="nt acl support (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2559200"></a>
     3995</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553218"></a>
    39963996
    39973997nt acl support (S)
    3998 </h3></div></div></div><a class="indexterm" name="id2559201"></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
     3998</h3></div></div></div><a class="indexterm" name="id2553220"></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
    39993999    UNIX permissions into Windows NT access control lists.  The UNIX
    40004000    permissions considered are the the traditional UNIX owner and
    … …  
    40034003    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>
    40044004</em></span>
    4005 </p></dd></dl></div></div><div class="section" title="ntlm auth (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2559255"></a>
     4005</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553273"></a>
    40064006
    40074007ntlm auth (G)
    4008 </h3></div></div></div><a class="indexterm" name="id2559256"></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
     4008</h3></div></div></div><a class="indexterm" name="id2553274"></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
    40094009    authenticate users using the NTLM encrypted password response.
    40104010    If disabled, either the lanman password hash or an NTLMv2 response
    … …  
    40144014        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>
    40154015</em></span>
    4016 </p></dd></dl></div></div><div class="section" title="nt pipe support (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2559319"></a>
     4016</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553337"></a>
    40174017
    40184018nt pipe support (G)
    4019 </h3></div></div></div><a class="indexterm" name="id2559320"></a><a name="NTPIPESUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether
     4019</h3></div></div></div><a class="indexterm" name="id2553338"></a><a name="NTPIPESUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether
    40204020    <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will allow Windows NT
    40214021    clients to connect to the NT SMB specific <code class="constant">IPC$</code>
    … …  
    40234023        alone.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>nt pipe support</code></em> = <code class="literal">yes</code>
    40244024</em></span>
    4025 </p></dd></dl></div></div><div class="section" title="nt status support (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2559375"></a>
     4025</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553393"></a>
    40264026
    40274027nt status support (G)
    4028 </h3></div></div></div><a class="indexterm" name="id2559376"></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
     4028</h3></div></div></div><a class="indexterm" name="id2553394"></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
    40294029    support with Windows NT/2k/XP clients. This is a developer debugging option and should be left alone.
    40304030    If this option is set to <code class="constant">no</code> then Samba offers
    … …  
    40324032    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>
    40334033</em></span>
    4034 </p></dd></dl></div></div><div class="section" title="null passwords (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2559437"></a>
     4034</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553455"></a>
    40354035
    40364036null passwords (G)
    4037 </h3></div></div></div><a class="indexterm" name="id2559438"></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>
    4038 </em></span>
    4039 </p></dd></dl></div></div><div class="section" title="obey pam restrictions (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2559490"></a>
     4037</h3></div></div></div><a class="indexterm" name="id2553456"></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>
     4038</em></span>
     4039</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553508"></a>
    40404040
    40414041obey pam restrictions (G)
    4042 </h3></div></div></div><a class="indexterm" name="id2559491"></a><a name="OBEYPAMRESTRICTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba 3.0 is configured to enable PAM support
     4042</h3></div></div></div><a class="indexterm" name="id2553509"></a><a name="OBEYPAMRESTRICTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba 3.0 is configured to enable PAM support
    40434043    (i.e. --with-pam), this parameter will control whether or not Samba
    40444044    should obey PAM's account and session management directives.  The
    … …  
    40504050</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>obey pam restrictions</code></em> = <code class="literal">no</code>
    40514051</em></span>
    4052 </p></dd></dl></div></div><div class="section" title="only user (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2559555"></a>
     4052</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553573"></a>
    40534053
    40544054only user (S)
    4055 </h3></div></div></div><a class="indexterm" name="id2559556"></a><a name="ONLYUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean option that controls whether
     4055</h3></div></div></div><a class="indexterm" name="id2553574"></a><a name="ONLYUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean option that controls whether
    40564056    connections with usernames not in the <em class="parameter"><code>user</code></em>
    40574057    list will be allowed. By default this option is disabled so that a
    … …  
    40664066    name of the user.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>only user</code></em> = <code class="literal">no</code>
    40674067</em></span>
    4068 </p></dd></dl></div></div><div class="section" title="oplock break wait time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2559644"></a>
     4068</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553662"></a>
    40694069
    40704070oplock break wait time (G)
    4071 </h3></div></div></div><a class="indexterm" name="id2559645"></a><a name="OPLOCKBREAKWAITTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4071</h3></div></div></div><a class="indexterm" name="id2553663"></a><a name="OPLOCKBREAKWAITTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    40724072        This is a tuning parameter added due to bugs in both Windows 9x and WinNT. If Samba responds to a client too
    40734073        quickly when that client issues an SMB that can cause an oplock break request, then the network client can
    40744074        fail and not respond to the break request. This tuning parameter (which is set in milliseconds) is the amount
    40754075        of time Samba will wait before sending an oplock break request to such (broken) clients.
    4076         </p><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>
     4076        </p><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>
    40774077        DO NOT CHANGE THIS PARAMETER UNLESS YOU HAVE READ AND UNDERSTOOD THE SAMBA OPLOCK CODE.
    40784078        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>oplock break wait time</code></em> = <code class="literal">0</code>
    40794079</em></span>
    4080 </p></dd></dl></div></div><div class="section" title="oplock contention limit (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2559698"></a>
     4080</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553717"></a>
    40814081
    40824082oplock contention limit (S)
    4083 </h3></div></div></div><a class="indexterm" name="id2559700"></a><a name="OPLOCKCONTENTIONLIMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4083</h3></div></div></div><a class="indexterm" name="id2553718"></a><a name="OPLOCKCONTENTIONLIMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    40844084        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
    40854085        granting of oplocks under multiple client contention for the same file.
    … …  
    40894089        limit. This causes <code class="literal">smbd</code> to behave in a similar
    40904090        way to Windows NT.
    4091         </p><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>
     4091        </p><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>
    40924092        DO NOT CHANGE THIS PARAMETER UNLESS YOU HAVE READ AND UNDERSTOOD THE SAMBA OPLOCK CODE.
    40934093        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>oplock contention limit</code></em> = <code class="literal">2</code>
    40944094</em></span>
    4095 </p></dd></dl></div></div><div class="section" title="oplocks (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2559781"></a>
     4095</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553799"></a>
    40964096
    40974097oplocks (S)
    4098 </h3></div></div></div><a class="indexterm" name="id2559782"></a><a name="OPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4098</h3></div></div></div><a class="indexterm" name="id2553800"></a><a name="OPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    40994099        This boolean option tells <code class="literal">smbd</code> whether to
    41004100        issue oplocks (opportunistic locks) to file open requests on this
    … …  
    41154115        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>oplocks</code></em> = <code class="literal">yes</code>
    41164116</em></span>
    4117 </p></dd></dl></div></div><div class="section" title="os2 driver map (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2559879"></a>
     4117</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553898"></a>
    41184118
    41194119os2 driver map (G)
    4120 </h3></div></div></div><a class="indexterm" name="id2559880"></a><a name="OS2DRIVERMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>The parameter is used to define the absolute
     4120</h3></div></div></div><a class="indexterm" name="id2553899"></a><a name="OS2DRIVERMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>The parameter is used to define the absolute
    41214121    path to a file containing a mapping of Windows NT printer driver
    41224122    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
    … …  
    41284128    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>os2 driver map</code></em> = <code class="literal"></code>
    41294129</em></span>
    4130 </p></dd></dl></div></div><div class="section" title="os level (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2559947"></a>
     4130</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553965"></a>
    41314131
    41324132os level (G)
    4133 </h3></div></div></div><a class="indexterm" name="id2559948"></a><a name="OSLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4133</h3></div></div></div><a class="indexterm" name="id2553966"></a><a name="OSLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    41344134        This integer value controls what level Samba advertises itself as for browse elections. The value of this
    41354135        parameter determines whether <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> has a chance of becoming a local master browser for the <a class="link" href="smb.conf.5.html#WORKGROUP" target="_top">workgroup</a> in the local broadcast area.
    … …  
    41474147</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>os level</code></em> = <code class="literal">65</code>
    41484148</em></span>
    4149 </p></dd></dl></div></div><div class="section" title="pam password change (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2560046"></a>
     4149</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554064"></a>
    41504150
    41514151pam password change (G)
    4152 </h3></div></div></div><a class="indexterm" name="id2560047"></a><a name="PAMPASSWORDCHANGE"></a><div class="variablelist"><dl><dt></dt><dd><p>With the addition of better PAM support in Samba 2.2,
     4152</h3></div></div></div><a class="indexterm" name="id2554065"></a><a name="PAMPASSWORDCHANGE"></a><div class="variablelist"><dl><dt></dt><dd><p>With the addition of better PAM support in Samba 2.2,
    41534153    this parameter, it is possible to use PAM's password change control
    41544154    flag for Samba.  If enabled, then PAM will be used for password
    … …  
    41584158    <a class="link" href="smb.conf.5.html#PASSWDCHAT" target="_top">passwd chat</a> parameter for most setups.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>pam password change</code></em> = <code class="literal">no</code>
    41594159</em></span>
    4160 </p></dd></dl></div></div><div class="section" title="panic action (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2560119"></a>
     4160</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554137"></a>
    41614161
    41624162panic action (G)
    4163 </h3></div></div></div><a class="indexterm" name="id2560120"></a><a name="PANICACTION"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a Samba developer option that allows a
     4163</h3></div></div></div><a class="indexterm" name="id2554138"></a><a name="PANICACTION"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a Samba developer option that allows a
    41644164        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
    41654165        draw attention to the fact that a problem occurred.
    … …  
    41684168</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>panic action</code></em> = <code class="literal">"/bin/sleep 90000"</code>
    41694169</em></span>
    4170 </p></dd></dl></div></div><div class="section" title="paranoid server security (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2560195"></a>
     4170</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554213"></a>
    41714171
    41724172paranoid server security (G)
    4173 </h3></div></div></div><a class="indexterm" name="id2560196"></a><a name="PARANOIDSERVERSECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>Some version of NT 4.x allow non-guest
     4173</h3></div></div></div><a class="indexterm" name="id2554214"></a><a name="PARANOIDSERVERSECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>Some version of NT 4.x allow non-guest
    41744174    users with a bad passowrd. When this option is enabled, samba will not
    41754175    use a broken NT 4.x server as password server, but instead complain
    … …  
    41794179    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>
    41804180</em></span>
    4181 </p></dd></dl></div></div><div class="section" title="passdb backend (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2560246"></a>
     4181</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554264"></a>
    41824182
    41834183passdb backend (G)
    4184 </h3></div></div></div><a class="indexterm" name="id2560247"></a><a name="PASSDBBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows the administrator to chose which backend
     4184</h3></div></div></div><a class="indexterm" name="id2554265"></a><a name="PASSDBBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows the administrator to chose which backend
    41854185    will be used for storing user and possibly group information.  This allows
    41864186    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'
    41874187    string that has meaning only to that particular backed.  These are separated
    41884188    by a : character.</p><p>Available backends can include:
    4189         </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">smbpasswd</code> - The default smbpasswd
     4189        </p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">smbpasswd</code> - The default smbpasswd
    41904190                backend. Takes a path to the smbpasswd file as an optional argument.
    4191                 </p></li><li class="listitem"><p><code class="literal">tdbsam</code> - The TDB based password storage
     4191                </p></li><li><p><code class="literal">tdbsam</code> - The TDB based password storage
    41924192                backend.  Takes a path to the TDB as an optional argument (defaults to passdb.tdb
    4193                 in the <a class="link" href="smb.conf.5.html#PRIVATEDIR" target="_top">private dir</a> directory.</p></li><li class="listitem"><p><code class="literal">ldapsam</code> - The LDAP based passdb
     4193                in the <a class="link" href="smb.conf.5.html#PRIVATEDIR" target="_top">private dir</a> directory.</p></li><li><p><code class="literal">ldapsam</code> - The LDAP based passdb
    41944194                backend.  Takes an LDAP URL as an optional argument (defaults to
    41954195                <code class="literal">ldap://localhost</code>)</p><p>LDAP connections should be secured where possible.  This may be done using either
    … …  
    42154215</pre><p>Default: <span class="emphasis"><em><em class="parameter"><code>passdb backend</code></em> = <code class="literal">smbpasswd</code>
    42164216</em></span>
    4217 </p></dd></dl></div></div><div class="section" title="passdb expand explicit (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2560404"></a>
     4217</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554422"></a>
    42184218
    42194219passdb expand explicit (G)
    4220 </h3></div></div></div><a class="indexterm" name="id2560405"></a><a name="PASSDBEXPANDEXPLICIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4220</h3></div></div></div><a class="indexterm" name="id2554423"></a><a name="PASSDBEXPANDEXPLICIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    42214221        This parameter controls whether Samba substitutes %-macros in the passdb fields if they are explicitly set. We
    42224222        used to expand macros here, but this turned out to be a bug because the Windows client can expand a variable
    … …  
    42244224    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>passdb expand explicit</code></em> = <code class="literal">no</code>
    42254225</em></span>
    4226 </p></dd></dl></div></div><div class="section" title="passwd chat debug (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2560450"></a>
     4226</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554468"></a>
    42274227
    42284228passwd chat debug (G)
    4229 </h3></div></div></div><a class="indexterm" name="id2560451"></a><a name="PASSWDCHATDEBUG"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean specifies if the passwd chat script
     4229</h3></div></div></div><a class="indexterm" name="id2554470"></a><a name="PASSWDCHATDEBUG"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean specifies if the passwd chat script
    42304230    parameter is run in <span class="emphasis"><em>debug</em></span> mode. In this mode the
    42314231    strings passed to and received from the passwd chat are printed
    … …  
    42404240        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>
    42414241</em></span>
    4242 </p></dd></dl></div></div><div class="section" title="passwd chat timeout (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2560554"></a>
     4242</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554572"></a>
    42434243
    42444244passwd chat timeout (G)
    4245 </h3></div></div></div><a class="indexterm" name="id2560555"></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
     4245</h3></div></div></div><a class="indexterm" name="id2554573"></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
    42464246    answer from a passwd chat script being run. Once the initial answer is received
    42474247    the subsequent answers must be received in one tenth of this time. The default it
    42484248    two seconds.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>passwd chat timeout</code></em> = <code class="literal">2</code>
    42494249</em></span>
    4250 </p></dd></dl></div></div><div class="section" title="passwd chat (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2560599"></a>
     4250</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554617"></a>
    42514251
    42524252passwd chat (G)
    4253 </h3></div></div></div><a class="indexterm" name="id2560600"></a><a name="PASSWDCHAT"></a><div class="variablelist"><dl><dt></dt><dd><p>This string controls the <span class="emphasis"><em>"chat"</em></span>
     4253</h3></div></div></div><a class="indexterm" name="id2554618"></a><a name="PASSWDCHAT"></a><div class="variablelist"><dl><dt></dt><dd><p>This string controls the <span class="emphasis"><em>"chat"</em></span>
    42544254    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
    42554255    program to change the user's password. The string describes a
    … …  
    42824282</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>
    42834283</em></span>
    4284 </p></dd></dl></div></div><div class="section" title="passwd program (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2560804"></a>
     4284</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554822"></a>
    42854285
    42864286passwd program (G)
    4287 </h3></div></div></div><a class="indexterm" name="id2560805"></a><a name="PASSWDPROGRAM"></a><div class="variablelist"><dl><dt></dt><dd><p>The name of a program that can be used to set
     4287</h3></div></div></div><a class="indexterm" name="id2554823"></a><a name="PASSWDPROGRAM"></a><div class="variablelist"><dl><dt></dt><dd><p>The name of a program that can be used to set
    42884288    UNIX user passwords.  Any occurrences of <em class="parameter"><code>%u</code></em>
    42894289    will be replaced with the user name. The user name is checked for
    … …  
    43064306</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>passwd program</code></em> = <code class="literal">/bin/passwd %u</code>
    43074307</em></span>
    4308 </p></dd></dl></div></div><div class="section" title="password level (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2560940"></a>
     4308</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554958"></a>
    43094309
    43104310password level (G)
    4311 </h3></div></div></div><a class="indexterm" name="id2560941"></a><a name="PASSWORDLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>Some client/server combinations have difficulty
     4311</h3></div></div></div><a class="indexterm" name="id2554959"></a><a name="PASSWORDLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>Some client/server combinations have difficulty
    43124312    with mixed-case passwords.  One offending client is Windows for
    43134313    Workgroups, which for some reason forces passwords to upper
    … …  
    43314331</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>password level</code></em> = <code class="literal">4</code>
    43324332</em></span>
    4333 </p></dd></dl></div></div><div class="section" title="password server (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2561076"></a>
     4333</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555095"></a>
    43344334
    43354335password server (G)
    4336 </h3></div></div></div><a class="indexterm" name="id2561078"></a><a name="PASSWORDSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>By specifying the name of another SMB server
     4336</h3></div></div></div><a class="indexterm" name="id2555096"></a><a name="PASSWORDSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>By specifying the name of another SMB server
    43374337    or Active Directory domain controller with this option,
    43384338    and using <code class="literal">security = [ads|domain|server]</code>
    … …  
    43494349    by any method and order described in that parameter.</p><p>The password server must be a machine capable of using
    43504350    the "LM1.2X002" or the "NT LM 0.12" protocol, and it must be in
    4351     user level security mode.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Using a password server  means your UNIX box (running
     4351    user level security mode.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Using a password server  means your UNIX box (running
    43524352    Samba) is only as secure as your  password server. <span class="emphasis"><em>DO NOT
    43534353    CHOOSE A PASSWORD SERVER THAT  YOU DON'T COMPLETELY TRUST</em></span>.
    … …  
    43784378    set to <code class="constant">server</code>, then there are different
    43794379    restrictions that <code class="literal">security = domain</code> doesn't
    4380     suffer from:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>You may list several password servers in
     4380    suffer from:</p><div class="itemizedlist"><ul type="disc"><li><p>You may list several password servers in
    43814381            the <em class="parameter"><code>password server</code></em> parameter, however if an
    43824382            <code class="literal">smbd</code> makes a connection to a password server,
    … …  
    43844384            to be authenticated from this <code class="literal">smbd</code>.  This is a
    43854385            restriction of the SMB/CIFS protocol when in <code class="literal">security = server
    4386             </code> mode and cannot be fixed in Samba.</p></li><li class="listitem"><p>If you are using a Windows NT server as your
     4386            </code> mode and cannot be fixed in Samba.</p></li><li><p>If you are using a Windows NT server as your
    43874387            password server then you will have to ensure that your users
    43884388            are able to login from the Samba server, as when in <code class="literal">
    … …  
    43944394</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>
    43954395</em></span>
    4396 </p></dd></dl></div></div><div class="section" title="directory"><div class="titlepage"><div><div><h3 class="title"><a name="id2561375"></a>
     4396</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555393"></a>
    43974397
    43984398<a name="DIRECTORY"></a>directory
    4399 </h3></div></div></div><a class="indexterm" name="id2561376"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PATH">path</a>.</p></dd></dl></div></div><div class="section" title="path (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2561406"></a>
     4399</h3></div></div></div><a class="indexterm" name="id2555394"></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="id2555424"></a>
    44004400
    44014401path (S)
    4402 </h3></div></div></div><a class="indexterm" name="id2561407"></a><a name="PATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a directory to which
     4402</h3></div></div></div><a class="indexterm" name="id2555425"></a><a name="PATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a directory to which
    44034403        the user of the service is to be given access. In the case of
    44044404        printable services, this is where print data will spool prior to
    … …  
    44174417</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>path</code></em> = <code class="literal">/home/fred</code>
    44184418</em></span>
    4419 </p></dd></dl></div></div><div class="section" title="pid directory (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2561510"></a>
     4419</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555528"></a>
    44204420
    44214421pid directory (G)
    4422 </h3></div></div></div><a class="indexterm" name="id2561511"></a><a name="PIDDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4422</h3></div></div></div><a class="indexterm" name="id2555529"></a><a name="PIDDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    44234423        This option specifies the directory where pid files will be placed. 
    44244424        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>pid directory</code></em> = <code class="literal">${prefix}/var/locks</code>
    … …  
    44264426</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>pid directory</code></em> = <code class="literal">pid directory = /var/run/</code>
    44274427</em></span>
    4428 </p></dd></dl></div></div><div class="section" title="posix locking (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2561569"></a>
     4428</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555588"></a>
    44294429
    44304430posix locking (S)
    4431 </h3></div></div></div><a class="indexterm" name="id2561570"></a><a name="POSIXLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4431</h3></div></div></div><a class="indexterm" name="id2555589"></a><a name="POSIXLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
    44324432        The <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>
    44334433        daemon maintains an database of file locks obtained by SMB clients. The default behavior is
    … …  
    44374437        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>posix locking</code></em> = <code class="literal">yes</code>
    44384438</em></span>
    4439 </p></dd></dl></div></div><div class="section" title="postexec (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2561625"></a>
     4439</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555643"></a>
    44404440
    44414441postexec (S)
    4442 </h3></div></div></div><a class="indexterm" name="id2561626"></a><a name="POSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run
     4442</h3></div></div></div><a class="indexterm" name="id2555644"></a><a name="POSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run
    44434443        whenever the service is disconnected. It takes the usual
    44444444        substitutions. The command may be run as the root on some
    … …  
    44484448</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>
    44494449</em></span>
    4450 </p></dd></dl></div></div><div class="section" title="preexec close (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2561698"></a>
     4450</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555716"></a>
    44514451
    44524452preexec close (S)
    4453 </h3></div></div></div><a class="indexterm" name="id2561699"></a><a name="PREEXECCLOSE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4453</h3></div></div></div><a class="indexterm" name="id2555717"></a><a name="PREEXECCLOSE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    44544454        This boolean option controls whether a non-zero return code from <a class="link" href="smb.conf.5.html#PREEXEC" target="_top">preexec</a>
    44554455        should close the service being connected to.
    44564456        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preexec close</code></em> = <code class="literal">no</code>
    44574457</em></span>
    4458 </p></dd></dl></div></div><div class="section" title="exec"><div class="titlepage"><div><div><h3 class="title"><a name="id2561753"></a>
     4458</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555772"></a>
    44594459
    44604460<a name="EXEC"></a>exec
    4461 </h3></div></div></div><a class="indexterm" name="id2561754"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PREEXEC">preexec</a>.</p></dd></dl></div></div><div class="section" title="preexec (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2561785"></a>
     4461</h3></div></div></div><a class="indexterm" name="id2555773"></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="id2555803"></a>
    44624462
    44634463preexec (S)
    4464 </h3></div></div></div><a class="indexterm" name="id2561786"></a><a name="PREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run whenever
     4464</h3></div></div></div><a class="indexterm" name="id2555804"></a><a name="PREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run whenever
    44654465        the service is connected to. It takes the usual substitutions.</p><p>An interesting example is to send the users a welcome
    44664466        message every time they log in. Maybe a message of the day? Here
    … …  
    44744474</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>
    44754475</em></span>
    4476 </p></dd></dl></div></div><div class="section" title="prefered master"><div class="titlepage"><div><div><h3 class="title"><a name="id2561893"></a>
     4476</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555911"></a>
    44774477
    44784478<a name="PREFEREDMASTER"></a>prefered master
    4479 </h3></div></div></div><a class="indexterm" name="id2561894"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PREFERREDMASTER">preferred master</a>.</p></dd></dl></div></div><div class="section" title="preferred master (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2561926"></a>
     4479</h3></div></div></div><a class="indexterm" name="id2555912"></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="id2555945"></a>
    44804480
    44814481preferred master (G)
    4482 </h3></div></div></div><a class="indexterm" name="id2561927"></a><a name="PREFERREDMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4482</h3></div></div></div><a class="indexterm" name="id2555946"></a><a name="PREFERREDMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    44834483        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.
    44844484        </p><p>
    … …  
    44944494        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preferred master</code></em> = <code class="literal">auto</code>
    44954495</em></span>
    4496 </p></dd></dl></div></div><div class="section" title="preload modules (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2562019"></a>
     4496</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556038"></a>
    44974497
    44984498preload modules (G)
    4499 </h3></div></div></div><a class="indexterm" name="id2562020"></a><a name="PRELOADMODULES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of paths to modules that should
     4499</h3></div></div></div><a class="indexterm" name="id2556039"></a><a name="PRELOADMODULES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of paths to modules that should
    45004500        be loaded into smbd before a client connects. This improves
    45014501        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>
    … …  
    45034503</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>
    45044504</em></span>
    4505 </p></dd></dl></div></div><div class="section" title="auto services"><div class="titlepage"><div><div><h3 class="title"><a name="id2562080"></a>
     4505</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556098"></a>
    45064506
    45074507<a name="AUTOSERVICES"></a>auto services
    4508 </h3></div></div></div><a class="indexterm" name="id2562081"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PRELOAD">preload</a>.</p></dd></dl></div></div><div class="section" title="preload (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2562113"></a>
     4508</h3></div></div></div><a class="indexterm" name="id2556100"></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="id2556132"></a>
    45094509
    45104510preload (G)
    4511 </h3></div></div></div><a class="indexterm" name="id2562114"></a><a name="PRELOAD"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of services that you want to be
     4511</h3></div></div></div><a class="indexterm" name="id2556133"></a><a name="PRELOAD"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of services that you want to be
    45124512        automatically added to the browse lists. This is most useful
    45134513        for homes and printers services that would otherwise not be
    … …  
    45204520</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>preload</code></em> = <code class="literal">fred lp colorlp</code>
    45214521</em></span>
    4522 </p></dd></dl></div></div><div class="section" title="preserve case (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2562191"></a>
     4522</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556210"></a>
    45234523
    45244524preserve case (S)
    4525 </h3></div></div></div><a class="indexterm" name="id2562192"></a><a name="PRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4525</h3></div></div></div><a class="indexterm" name="id2556211"></a><a name="PRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    45264526        This controls if new filenames are created with the case that the client passes, or if
    45274527        they are forced to be the <a class="link" href="smb.conf.5.html#DEFAULTCASE" target="_top">default case</a>.
    … …  
    45304530        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preserve case</code></em> = <code class="literal">yes</code>
    45314531</em></span>
    4532 </p></dd></dl></div></div><div class="section" title="print ok"><div class="titlepage"><div><div><h3 class="title"><a name="id2562258"></a>
     4532</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556276"></a>
    45334533
    45344534<a name="PRINTOK"></a>print ok
    4535 </h3></div></div></div><a class="indexterm" name="id2562259"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PRINTABLE">printable</a>.</p></dd></dl></div></div><div class="section" title="printable (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2562289"></a>
     4535</h3></div></div></div><a class="indexterm" name="id2556277"></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="id2556307"></a>
    45364536
    45374537printable (S)
    4538 </h3></div></div></div><a class="indexterm" name="id2562290"></a><a name="PRINTABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code>, then
     4538</h3></div></div></div><a class="indexterm" name="id2556308"></a><a name="PRINTABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code>, then
    45394539    clients may open, write to and submit spool files on the directory
    45404540    specified for the service. </p><p>Note that a printable service will ALWAYS allow writing
    … …  
    45434543    the resource.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>printable</code></em> = <code class="literal">no</code>
    45444544</em></span>
    4545 </p></dd></dl></div></div><div class="section" title="printcap cache time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2562352"></a>
     4545</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556370"></a>
    45464546
    45474547printcap cache time (G)
    4548 </h3></div></div></div><a class="indexterm" name="id2562353"></a><a name="PRINTCAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the number of seconds before the printing
     4548</h3></div></div></div><a class="indexterm" name="id2556371"></a><a name="PRINTCAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the number of seconds before the printing
    45494549    subsystem is again asked for the known printers.  If the value
    45504550    is greater than 60 the initial waiting time is set to 60 seconds
    … …  
    45564556</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printcap cache time</code></em> = <code class="literal">600</code>
    45574557</em></span>
    4558 </p></dd></dl></div></div><div class="section" title="printcap"><div class="titlepage"><div><div><h3 class="title"><a name="id2562421"></a>
     4558</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556439"></a>
    45594559
    45604560<a name="PRINTCAP"></a>printcap
    4561 </h3></div></div></div><a class="indexterm" name="id2562422"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PRINTCAPNAME">printcap name</a>.</p></dd></dl></div></div><div class="section" title="printcap name (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2562454"></a>
     4561</h3></div></div></div><a class="indexterm" name="id2556440"></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="id2556472"></a>
    45624562
    45634563printcap name (G)
    4564 </h3></div></div></div><a class="indexterm" name="id2562455"></a><a name="PRINTCAPNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4564</h3></div></div></div><a class="indexterm" name="id2556473"></a><a name="PRINTCAPNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    45654565        This parameter may be used to override the compiled-in default printcap name used by the server (usually
    45664566        <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.
    … …  
    45904590    where the '|' separates aliases of a printer. The fact that the second alias has a space in
    45914591        it gives a hint to Samba that it's a comment.
    4592         </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
     4592        </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
    45934593        Under AIX the default printcap name is <code class="filename">/etc/qconfig</code>. Samba will
    45944594        assume the file is in AIX <code class="filename">qconfig</code> format if the string <code class="filename">qconfig</code> appears in the printcap filename.
    … …  
    45974597</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printcap name</code></em> = <code class="literal">/etc/myprintcap</code>
    45984598</em></span>
    4599 </p></dd></dl></div></div><div class="section" title="print command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2562638"></a>
     4599</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556656"></a>
    46004600
    46014601print command (S)
    4602 </h3></div></div></div><a class="indexterm" name="id2562639"></a><a name="PRINTCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>After a print job has finished spooling to
     4602</h3></div></div></div><a class="indexterm" name="id2556657"></a><a name="PRINTCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>After a print job has finished spooling to
    46034603    a service, this command will be used via a <code class="literal">system()</code>
    46044604    call to process the spool file. Typically the command specified will
    … …  
    46424642        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>
    46434643</em></span>
    4644 </p></dd></dl></div></div><div class="section" title="printer admin (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2562908"></a>
     4644</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556926"></a>
    46454645
    46464646printer admin (S)
    4647 </h3></div></div></div><a class="indexterm" name="id2562909"></a><a name="PRINTERADMIN"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4647</h3></div></div></div><a class="indexterm" name="id2556927"></a><a name="PRINTERADMIN"></a><div class="variablelist"><dl><dt></dt><dd><p>
    46484648        This lists users who can do anything to printers
    46494649        via the remote administration interfaces offered
    … …  
    46614661</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printer admin</code></em> = <code class="literal">admin, @staff</code>
    46624662</em></span>
    4663 </p></dd></dl></div></div><div class="section" title="printer"><div class="titlepage"><div><div><h3 class="title"><a name="id2562977"></a>
     4663</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556995"></a>
    46644664
    46654665<a name="PRINTER"></a>printer
    4666 </h3></div></div></div><a class="indexterm" name="id2562978"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PRINTERNAME">printer name</a>.</p></dd></dl></div></div><div class="section" title="printer name (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2563008"></a>
     4666</h3></div></div></div><a class="indexterm" name="id2556996"></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="id2557027"></a>
    46674667
    46684668printer name (S)
    4669 </h3></div></div></div><a class="indexterm" name="id2563010"></a><a name="PRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4669</h3></div></div></div><a class="indexterm" name="id2557028"></a><a name="PRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    46704670        This parameter specifies the name of the printer to which print jobs spooled through a printable service
    46714671        will be sent.
    … …  
    46804680</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printer name</code></em> = <code class="literal">laserwriter</code>
    46814681</em></span>
    4682 </p></dd></dl></div></div><div class="section" title="printing (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2563096"></a>
     4682</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557115"></a>
    46834683
    46844684printing (S)
    4685 </h3></div></div></div><a class="indexterm" name="id2563097"></a><a name="PRINTING"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters controls how printer status  information is
     4685</h3></div></div></div><a class="indexterm" name="id2557116"></a><a name="PRINTING"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters controls how printer status  information is
    46864686    interpreted on your system. It also affects the  default values for
    46874687    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
    … …  
    47004700<code class="literal">testparm -v.</code></code>
    47014701</em></span>
    4702 </p></dd></dl></div></div><div class="section" title="printjob username (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2563250"></a>
     4702</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557268"></a>
    47034703
    47044704printjob username (S)
    4705 </h3></div></div></div><a class="indexterm" name="id2563251"></a><a name="PRINTJOBUSERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies which user information will be
     4705</h3></div></div></div><a class="indexterm" name="id2557269"></a><a name="PRINTJOBUSERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies which user information will be
    47064706    passed to the printing system. Usually, the username is sent,
    47074707    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>
    … …  
    47094709</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printjob username</code></em> = <code class="literal">%D\%U</code>
    47104710</em></span>
    4711 </p></dd></dl></div></div><div class="section" title="private dir (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2563311"></a>
     4711</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557329"></a>
    47124712
    47134713private dir (G)
    4714 </h3></div></div></div><a class="indexterm" name="id2563312"></a><a name="PRIVATEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters defines the directory
     4714</h3></div></div></div><a class="indexterm" name="id2557330"></a><a name="PRIVATEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters defines the directory
    47154715    smbd will use for storing such files as <code class="filename">smbpasswd</code>
    47164716    and <code class="filename">secrets.tdb</code>.
    47174717</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>private dir</code></em> = <code class="literal">${prefix}/private</code>
    47184718</em></span>
    4719 </p></dd></dl></div></div><div class="section" title="profile acls (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2563365"></a>
     4719</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557383"></a>
    47204720
    47214721profile acls (S)
    4722 </h3></div></div></div><a class="indexterm" name="id2563366"></a><a name="PROFILEACLS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4722</h3></div></div></div><a class="indexterm" name="id2557384"></a><a name="PROFILEACLS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    47234723        This boolean parameter was added to fix the problems that people have been
    47244724        having with storing user profiles on Samba shares from Windows 2000 or
    … …  
    47484748        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>profile acls</code></em> = <code class="literal">no</code>
    47494749</em></span>
    4750 </p></dd></dl></div></div><div class="section" title="queuepause command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2563438"></a>
     4750</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557456"></a>
    47514751
    47524752queuepause command (S)
    4753 </h3></div></div></div><a class="indexterm" name="id2563439"></a><a name="QUEUEPAUSECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     4753</h3></div></div></div><a class="indexterm" name="id2557457"></a><a name="QUEUEPAUSECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    47544754    executed on the server host in order to pause the printer queue.</p><p>This command should be a program or script which takes
    47554755    a printer name as its only parameter and stops the printer queue,
    … …  
    47624762        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>
    47634763</em></span>
    4764 </p></dd></dl></div></div><div class="section" title="queueresume command (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2563515"></a>
     4764</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557533"></a>
    47654765
    47664766queueresume command (S)
    4767 </h3></div></div></div><a class="indexterm" name="id2563516"></a><a name="QUEUERESUMECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     4767</h3></div></div></div><a class="indexterm" name="id2557534"></a><a name="QUEUERESUMECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    47684768    executed on the server host in order to resume the printer queue. It
    47694769    is the command to undo the behavior that is caused by the
    … …  
    47804780</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>queueresume command</code></em> = <code class="literal">enable %p</code>
    47814781</em></span>
    4782 </p></dd></dl></div></div><div class="section" title="read list (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2563618"></a>
     4782</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557636"></a>
    47834783
    47844784read list (S)
    4785 </h3></div></div></div><a class="indexterm" name="id2563619"></a><a name="READLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4785</h3></div></div></div><a class="indexterm" name="id2557637"></a><a name="READLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
    47864786        This is a list of users that are given read-only access to a service. If the connecting user is in this list
    47874787        then they will not be given write access, no matter what the <a class="link" href="smb.conf.5.html#READONLY" target="_top">read only</a> option is set
    … …  
    47934793</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>read list</code></em> = <code class="literal">mary, @students</code>
    47944794</em></span>
    4795 </p></dd></dl></div></div><div class="section" title="read only (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2563717"></a>
     4795</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557736"></a>
    47964796
    47974797read only (S)
    4798 </h3></div></div></div><a class="indexterm" name="id2563718"></a><a name="READONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>An inverted synonym is <a class="link" href="smb.conf.5.html#WRITEABLE" target="_top">writeable</a>.</p><p>If this parameter is <code class="constant">yes</code>, then users
     4798</h3></div></div></div><a class="indexterm" name="id2557737"></a><a name="READONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>An inverted synonym is <a class="link" href="smb.conf.5.html#WRITEABLE" target="_top">writeable</a>.</p><p>If this parameter is <code class="constant">yes</code>, then users
    47994799    of a service may not create or modify files in the service's
    48004800    directory.</p><p>Note that a printable service (<code class="literal">printable = yes</code>)
    … …  
    48024802    (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>
    48034803</em></span>
    4804 </p></dd></dl></div></div><div class="section" title="read raw (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2563793"></a>
     4804</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557812"></a>
    48054805
    48064806read raw (G)
    4807 </h3></div></div></div><a class="indexterm" name="id2563794"></a><a name="READRAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
     4807</h3></div></div></div><a class="indexterm" name="id2557814"></a><a name="READRAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
    48084808    will support the raw read SMB requests when transferring data
    48094809    to clients.</p><p>If enabled, raw reads allow reads of 65535 bytes in
    … …  
    48144814        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>
    48154815</em></span>
    4816 </p></dd></dl></div></div><div class="section" title="realm (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2563854"></a>
     4816</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557872"></a>
    48174817
    48184818realm (G)
    4819 </h3></div></div></div><a class="indexterm" name="id2563855"></a><a name="REALM"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the kerberos realm to use. The realm is
     4819</h3></div></div></div><a class="indexterm" name="id2557873"></a><a name="REALM"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the kerberos realm to use. The realm is
    48204820        used as the ADS equivalent of the NT4 <code class="literal">domain</code>. It
    48214821        is usually set to the DNS name of the kerberos server.
    … …  
    48244824</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>realm</code></em> = <code class="literal">mysambabox.mycompany.com</code>
    48254825</em></span>
    4826 </p></dd></dl></div></div><div class="section" title="registry shares (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2563918"></a>
     4826</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557937"></a>
    48274827
    48284828registry shares (G)
    4829 </h3></div></div></div><a class="indexterm" name="id2563920"></a><a name="REGISTRYSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4829</h3></div></div></div><a class="indexterm" name="id2557938"></a><a name="REGISTRYSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    48304830        This turns on or off support for share definitions read from
    48314831        registry. Shares defined in <span class="emphasis"><em>smb.conf</em></span> take
    … …  
    48424842</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>registry shares</code></em> = <code class="literal">yes</code>
    48434843</em></span>
    4844 </p></dd></dl></div></div><div class="section" title="remote announce (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2564005"></a>
     4844</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558024"></a>
    48454845
    48464846remote announce (G)
    4847 </h3></div></div></div><a class="indexterm" name="id2564006"></a><a name="REMOTEANNOUNCE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4847</h3></div></div></div><a class="indexterm" name="id2558025"></a><a name="REMOTEANNOUNCE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    48484848        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
    48494849        to arbitrary IP addresses with an arbitrary workgroup name.
    … …  
    48694869        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>remote announce</code></em> = <code class="literal"></code>
    48704870</em></span>
    4871 </p></dd></dl></div></div><div class="section" title="remote browse sync (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2564111"></a>
     4871</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558129"></a>
    48724872
    48734873remote browse sync (G)
    4874 </h3></div></div></div><a class="indexterm" name="id2564112"></a><a name="REMOTEBROWSESYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4874</h3></div></div></div><a class="indexterm" name="id2558130"></a><a name="REMOTEBROWSESYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    48754875        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
    48764876        synchronization of browse lists with the master browser of a Samba
    … …  
    49044904        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>remote browse sync</code></em> = <code class="literal"></code>
    49054905</em></span>
    4906 </p></dd></dl></div></div><div class="section" title="rename user script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2564224"></a>
     4906</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558242"></a>
    49074907
    49084908rename user script (G)
    4909 </h3></div></div></div><a class="indexterm" name="id2564225"></a><a name="RENAMEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4909</h3></div></div></div><a class="indexterm" name="id2558243"></a><a name="RENAMEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    49104910        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.
    49114911        </p><p>
    … …  
    49144914        <code class="literal">%unew</code>, will be substituted with the old and new usernames, respectively.  The script should
    49154915        return 0 upon successful completion, and nonzero otherwise.
    4916         </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
     4916        </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
    49174917        The script has all responsibility to rename all the necessary data that is accessible in this posix method.
    49184918        This can mean different requirements for different backends.  The tdbsam and smbpasswd backends will take care
    … …  
    49254925        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>rename user script</code></em> = <code class="literal">no</code>
    49264926</em></span>
    4927 </p></dd></dl></div></div><div class="section" title="reset on zero vc (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2564328"></a>
     4927</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558346"></a>
    49284928
    49294929reset on zero vc (G)
    4930 </h3></div></div></div><a class="indexterm" name="id2564329"></a><a name="RESETONZEROVC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4930</h3></div></div></div><a class="indexterm" name="id2558347"></a><a name="RESETONZEROVC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    49314931        This boolean option controls whether an incoming session setup
    49324932        should kill other connections coming from the same IP. This matches
    … …  
    49474947        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>reset on zero vc</code></em> = <code class="literal">no</code>
    49484948</em></span>
    4949 </p></dd></dl></div></div><div class="section" title="restrict anonymous (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2564380"></a>
     4949</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558399"></a>
    49504950
    49514951restrict anonymous (G)
    4952 </h3></div></div></div><a class="indexterm" name="id2564382"></a><a name="RESTRICTANONYMOUS"></a><div class="variablelist"><dl><dt></dt><dd><p>The setting of this parameter determines whether user and
     4952</h3></div></div></div><a class="indexterm" name="id2558400"></a><a name="RESTRICTANONYMOUS"></a><div class="variablelist"><dl><dt></dt><dd><p>The setting of this parameter determines whether user and
    49534953    group list information is returned for an anonymous connection.
    49544954    and mirrors the effects of the
    … …  
    49684968    as user and group list information can be obtained using other
    49694969        means.
    4970         </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
     4970        </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
    49714971    The security advantage of using restrict anonymous = 2 is removed
    49724972    by setting <a class="link" href="smb.conf.5.html#GUESTOK" target="_top">guest ok = yes</a> on any share.
    49734973        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>restrict anonymous</code></em> = <code class="literal">0</code>
    49744974</em></span>
    4975 </p></dd></dl></div></div><div class="section" title="root"><div class="titlepage"><div><div><h3 class="title"><a name="id2564465"></a>
     4975</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558483"></a>
    49764976
    49774977<a name="ROOT"></a>root
    4978 </h3></div></div></div><a class="indexterm" name="id2564466"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#ROOTDIRECTORY">root directory</a>.</p></dd></dl></div></div><div class="section" title="root dir"><div class="titlepage"><div><div><h3 class="title"><a name="id2564498"></a>
     4978</h3></div></div></div><a class="indexterm" name="id2558484"></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="id2558516"></a>
    49794979
    49804980<a name="ROOTDIR"></a>root dir
    4981 </h3></div></div></div><a class="indexterm" name="id2564499"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#ROOTDIRECTORY">root directory</a>.</p></dd></dl></div></div><div class="section" title="root directory (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2564529"></a>
     4981</h3></div></div></div><a class="indexterm" name="id2558517"></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="id2558548"></a>
    49824982
    49834983root directory (G)
    4984 </h3></div></div></div><a class="indexterm" name="id2564530"></a><a name="ROOTDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>The server will <code class="literal">chroot()</code> (i.e.
     4984</h3></div></div></div><a class="indexterm" name="id2558549"></a><a name="ROOTDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>The server will <code class="literal">chroot()</code> (i.e.
    49854985    Change its root directory) to this directory on startup. This is
    49864986    not strictly necessary for secure operation. Even without it the
    … …  
    50055005</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>root directory</code></em> = <code class="literal">/homes/smb</code>
    50065006</em></span>
    5007 </p></dd></dl></div></div><div class="section" title="root postexec (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2564653"></a>
     5007</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558672"></a>
    50085008
    50095009root postexec (S)
    5010 </h3></div></div></div><a class="indexterm" name="id2564654"></a><a name="ROOTPOSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5010</h3></div></div></div><a class="indexterm" name="id2558673"></a><a name="ROOTPOSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    50115011        This is the same as the <em class="parameter"><code>postexec</code></em>
    50125012        parameter except that the command is run as root. This is useful for
    … …  
    50145014        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>root postexec</code></em> = <code class="literal"></code>
    50155015</em></span>
    5016 </p></dd></dl></div></div><div class="section" title="root preexec close (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2564702"></a>
     5016</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558720"></a>
    50175017
    50185018root preexec close (S)
    5019 </h3></div></div></div><a class="indexterm" name="id2564703"></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
     5019</h3></div></div></div><a class="indexterm" name="id2558721"></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
    50205020        </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>
    50215021</em></span>
    5022 </p></dd></dl></div></div><div class="section" title="root preexec (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2564750"></a>
     5022</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558769"></a>
    50235023
    50245024root preexec (S)
    5025 </h3></div></div></div><a class="indexterm" name="id2564751"></a><a name="ROOTPREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5025</h3></div></div></div><a class="indexterm" name="id2558770"></a><a name="ROOTPREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    50265026        This is the same as the <em class="parameter"><code>preexec</code></em>
    50275027        parameter except that the command is run as root. This is useful for
    … …  
    50295029        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>root preexec</code></em> = <code class="literal"></code>
    50305030</em></span>
    5031 </p></dd></dl></div></div><div class="section" title="security mask (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2564799"></a>
     5031</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558817"></a>
    50325032
    50335033security mask (S)
    5034 </h3></div></div></div><a class="indexterm" name="id2564800"></a><a name="SECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5034</h3></div></div></div><a class="indexterm" name="id2558818"></a><a name="SECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
    50355035        This parameter controls what UNIX permission bits will be set when a Windows NT client is manipulating the
    50365036        UNIX permission on a file using the native NT security dialog box.
    … …  
    50515051</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>security mask</code></em> = <code class="literal">0770</code>
    50525052</em></span>
    5053 </p></dd></dl></div></div><div class="section" title="security (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2564905"></a>
     5053</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558923"></a>
    50545054
    50555055security (G)
    5056 </h3></div></div></div><a class="indexterm" name="id2564906"></a><a name="SECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option affects how clients respond to
     5056</h3></div></div></div><a class="indexterm" name="id2558924"></a><a name="SECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option affects how clients respond to
    50575057    Samba and is one of the most important settings in the <code class="filename">
    50585058    smb.conf</code> file.</p><p>The option sets the "security mode bit" in replies to
    … …  
    50935093    techniques to determine the correct UNIX user to use on behalf
    50945094    of the client.</p><p>A list of possible UNIX usernames to match with the given
    5095     client password is constructed using the following methods :</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>If the <a class="link" href="smb.conf.5.html#GUESTONLY" target="_top">guest only</a> parameter is set, then all the other
     5095    client password is constructed using the following methods :</p><div class="itemizedlist"><ul type="disc"><li><p>If the <a class="link" href="smb.conf.5.html#GUESTONLY" target="_top">guest only</a> parameter is set, then all the other
    50965096            stages are missed and only the <a class="link" href="smb.conf.5.html#GUESTACCOUNT" target="_top">guest account</a> username is checked.
    5097             </p></li><li class="listitem"><p>Is a username is sent with the share connection
     5097            </p></li><li><p>Is a username is sent with the share connection
    50985098            request, then this username (after mapping - see <a class="link" href="smb.conf.5.html#USERNAMEMAP" target="_top">username map</a>),
    50995099            is added as a potential username.
    5100             </p></li><li class="listitem"><p>If the client did a previous <span class="emphasis"><em>logon
     5100            </p></li><li><p>If the client did a previous <span class="emphasis"><em>logon
    51015101            </em></span> request (the SessionSetup SMB call) then the
    51025102            username sent in this SMB will be added as a potential username.
    5103             </p></li><li class="listitem"><p>The name of the service the client requested is
     5103            </p></li><li><p>The name of the service the client requested is
    51045104            added as a potential username.
    5105             </p></li><li class="listitem"><p>The NetBIOS name of the client is added to
     5105            </p></li><li><p>The NetBIOS name of the client is added to
    51065106            the list as a potential username.
    5107             </p></li><li class="listitem"><p>Any users on the <a class="link" href="smb.conf.5.html#USER" target="_top">user</a> list are added as potential usernames.
     5107            </p></li><li><p>Any users on the <a class="link" href="smb.conf.5.html#USER" target="_top">user</a> list are added as potential usernames.
    51085108            </p></li></ul></div><p>If the <em class="parameter"><code>guest only</code></em> parameter is
    51095109    not set, then this list is then tried with the supplied password.
    … …  
    51515151        revert back to checking the UNIX password file, it must have a valid <code class="filename">smbpasswd</code> file to check users against. See the chapter about the User Database in
    51525152        the Samba HOWTO Collection for details on how to set this up.
    5153 </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This mode of operation has
     5153</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This mode of operation has
    51545154    significant pitfalls since it is more vulnerable to
    51555155    man-in-the-middle attacks and server impersonation.  In particular,
    … …  
    51595159    there is no way to reestablish it, and futher authentications to the
    51605160    Samba server may fail (from a single client, till it disconnects).
    5161         </p></div><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>From the client's point of
     5161        </p></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>From the client's point of
    51625162    view, <code class="literal">security = server</code> is the
    51635163    same as <code class="literal">security = user</code>.  It
    … …  
    51785178</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>security</code></em> = <code class="literal">DOMAIN</code>
    51795179</em></span>
    5180 </p></dd></dl></div></div><div class="section" title="server schannel (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2565784"></a>
     5180</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559802"></a>
    51815181
    51825182server schannel (G)
    5183 </h3></div></div></div><a class="indexterm" name="id2565785"></a><a name="SERVERSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5183</h3></div></div></div><a class="indexterm" name="id2559803"></a><a name="SERVERSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    51845184        This controls whether the server offers or even demands the use of the netlogon schannel.
    51855185        <a class="link" href="smb.conf.5.html#SERVERSCHANNEL" target="_top">server schannel = no</a> does not offer the schannel, <a class="link" href="smb.conf.5.html#SERVERSCHANNEL" target="_top">server schannel = auto</a> offers the schannel but does not enforce it, and <a class="link" href="smb.conf.5.html#SERVERSCHANNEL" target="_top">server schannel = yes</a> denies access if the client is not able to speak netlogon schannel.
    … …  
    51925192</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>server schannel</code></em> = <code class="literal">yes</code>
    51935193</em></span>
    5194 </p></dd></dl></div></div><div class="section" title="server signing (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2565900"></a>
     5194</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559918"></a>
    51955195
    51965196server signing (G)
    5197 </h3></div></div></div><a class="indexterm" name="id2565901"></a><a name="SERVERSIGNING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether the client is allowed or required to use SMB signing. Possible values
     5197</h3></div></div></div><a class="indexterm" name="id2559919"></a><a name="SERVERSIGNING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether the client is allowed or required to use SMB signing. Possible values
    51985198    are <span class="emphasis"><em>auto</em></span>, <span class="emphasis"><em>mandatory</em></span>
    51995199    and <span class="emphasis"><em>disabled</em></span>.
    … …  
    52025202        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>
    52035203</em></span>
    5204 </p></dd></dl></div></div><div class="section" title="server string (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2565961"></a>
     5204</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559979"></a>
    52055205
    52065206server string (G)
    5207 </h3></div></div></div><a class="indexterm" name="id2565962"></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
     5207</h3></div></div></div><a class="indexterm" name="id2559980"></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
    52085208        manager and next to the IPC connection in <code class="literal">net view</code>. It
    52095209        can be any string that you wish to show to your users.</p><p>It also sets what will appear in browse lists next
    … …  
    52145214</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>server string</code></em> = <code class="literal">University of GNUs Samba Server</code>
    52155215</em></span>
    5216 </p></dd></dl></div></div><div class="section" title="set directory (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2566052"></a>
     5216</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560070"></a>
    52175217
    52185218set directory (S)
    5219 </h3></div></div></div><a class="indexterm" name="id2566053"></a><a name="SETDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5219</h3></div></div></div><a class="indexterm" name="id2560071"></a><a name="SETDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    52205220        If <code class="literal">set directory = no</code>, then        users of the
    52215221        service may not use the setdir command to change directory.
    … …  
    52265226        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>set directory</code></em> = <code class="literal">no</code>
    52275227</em></span>
    5228 </p></dd></dl></div></div><div class="section" title="set primary group script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2566112"></a>
     5228</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560130"></a>
    52295229
    52305230set primary group script (G)
    5231 </h3></div></div></div><a class="indexterm" name="id2566113"></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
     5231</h3></div></div></div><a class="indexterm" name="id2560131"></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
    52325232        primary group in addition to the auxiliary groups.  This script
    52335233        sets the primary group in the unix userdatase when an
    … …  
    52415241</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>
    52425242</em></span>
    5243 </p></dd></dl></div></div><div class="section" title="set quota command (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2566194"></a>
     5243</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560212"></a>
    52445244
    52455245set quota command (G)
    5246 </h3></div></div></div><a class="indexterm" name="id2566195"></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
     5246</h3></div></div></div><a class="indexterm" name="id2560213"></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
    52475247        whenever there is no operating system API available from the OS that
    52485248        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
    52495249        on linux when <code class="literal">./configure --with-quotas</code> was used and a working quota api
    52505250        was found in the system. Most packages are configured with these options already.</p><p>This parameter should specify the path to a script that
    5251         can set quota for the specified arguments.</p><p>The specified script should take the following arguments:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>1 - quota type
    5252                         </p><div class="itemizedlist"><ul class="itemizedlist" type="circle"><li class="listitem"><p>1 - user quotas</p></li><li class="listitem"><p>2 - user default quotas (uid = -1)</p></li><li class="listitem"><p>3 - group quotas</p></li><li class="listitem"><p>4 - group default quotas (gid = -1)</p></li></ul></div></li><li class="listitem"><p>2 - id (uid for user, gid for group, -1 if N/A)</p></li><li class="listitem"><p>3 - quota state (0 = disable, 1 = enable, 2 = enable and enforce)</p></li><li class="listitem"><p>4 - block softlimit</p></li><li class="listitem"><p>5 - block hardlimit</p></li><li class="listitem"><p>6 - inode softlimit</p></li><li class="listitem"><p>7 - inode hardlimit</p></li><li class="listitem"><p>8(optional) - block size, defaults to 1024</p></li></ul></div><p>The script should output at least one line of data on success. And nothing on failure.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>set quota command</code></em> = <code class="literal"></code>
     5251        can set quota for the specified arguments.</p><p>The specified script should take the following arguments:</p><div class="itemizedlist"><ul type="disc"><li><p>1 - quota type
     5252                        </p><div class="itemizedlist"><ul type="circle"><li><p>1 - user quotas</p></li><li><p>2 - user default quotas (uid = -1)</p></li><li><p>3 - group quotas</p></li><li><p>4 - group default quotas (gid = -1)</p></li></ul></div></li><li><p>2 - id (uid for user, gid for group, -1 if N/A)</p></li><li><p>3 - quota state (0 = disable, 1 = enable, 2 = enable and enforce)</p></li><li><p>4 - block softlimit</p></li><li><p>5 - block hardlimit</p></li><li><p>6 - inode softlimit</p></li><li><p>7 - inode hardlimit</p></li><li><p>8(optional) - block size, defaults to 1024</p></li></ul></div><p>The script should output at least one line of data on success. And nothing on failure.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>set quota command</code></em> = <code class="literal"></code>
    52535253</em></span>
    52545254</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>
    52555255</em></span>
    5256 </p></dd></dl></div></div><div class="section" title="share modes (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2566357"></a>
     5256</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560376"></a>
    52575257
    52585258share modes (S)
    5259 </h3></div></div></div><a class="indexterm" name="id2566358"></a><a name="SHAREMODES"></a><div class="variablelist"><dl><dt></dt><dd><p>This enables or disables the honoring of
     5259</h3></div></div></div><a class="indexterm" name="id2560377"></a><a name="SHAREMODES"></a><div class="variablelist"><dl><dt></dt><dd><p>This enables or disables the honoring of
    52605260        the <em class="parameter"><code>share modes</code></em> during a file open. These
    52615261        modes are used by clients to gain exclusive read or write access
    … …  
    52695269        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>
    52705270</em></span>
    5271 </p></dd></dl></div></div><div class="section" title="short preserve case (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2566434"></a>
     5271</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560452"></a>
    52725272
    52735273short preserve case (S)
    5274 </h3></div></div></div><a class="indexterm" name="id2566435"></a><a name="SHORTPRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5274</h3></div></div></div><a class="indexterm" name="id2560453"></a><a name="SHORTPRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    52755275        This boolean parameter controls if new files which conform to 8.3 syntax, that is all in upper case and of
    52765276        suitable length, are created upper case, or if they are forced to be the <a class="link" href="smb.conf.5.html#DEFAULTCASE" target="_top">default case</a>.
    … …  
    52795279        </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>
    52805280</em></span>
    5281 </p></dd></dl></div></div><div class="section" title="show add printer wizard (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2566514"></a>
     5281</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560532"></a>
    52825282
    52835283show add printer wizard (G)
    5284 </h3></div></div></div><a class="indexterm" name="id2566515"></a><a name="SHOWADDPRINTERWIZARD"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printing support
     5284</h3></div></div></div><a class="indexterm" name="id2560533"></a><a name="SHOWADDPRINTERWIZARD"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printing support
    52855285    for Windows NT/2000 client in Samba 2.2, a "Printers..." folder will
    52865286    appear on Samba hosts in the share listing.  Normally this folder will
    … …  
    52975297    parameter will always cause the OpenPrinterEx() on the server
    52985298        to fail.  Thus the APW icon will never be displayed.
    5299 </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This does not prevent the same user from having
     5299</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This does not prevent the same user from having
    53005300                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>
    53015301</em></span>
    5302 </p></dd></dl></div></div><div class="section" title="shutdown script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2566597"></a>
     5302</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560616"></a>
    53035303
    53045304shutdown script (G)
    5305 </h3></div></div></div><a class="indexterm" name="id2566598"></a><a name="SHUTDOWNSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This a full path name to a script called by
     5305</h3></div></div></div><a class="indexterm" name="id2560617"></a><a name="SHUTDOWNSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This a full path name to a script called by
    53065306         <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> that should
    53075307        start a shutdown procedure.</p><p>If the connected user posseses the <code class="constant">SeRemoteShutdownPrivilege</code>,
    5308         right, this command will be run as root.</p><p>The %z %t %r %f variables are expanded as follows:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="parameter"><code>%z</code></em> will be substituted with the
    5309                         shutdown message sent to the server.</p></li><li class="listitem"><p><em class="parameter"><code>%t</code></em> will be substituted with the
     5308        right, this command will be run as root.</p><p>The %z %t %r %f variables are expanded as follows:</p><div class="itemizedlist"><ul type="disc"><li><p><em class="parameter"><code>%z</code></em> will be substituted with the
     5309                        shutdown message sent to the server.</p></li><li><p><em class="parameter"><code>%t</code></em> will be substituted with the
    53105310                        number of seconds to wait before effectively starting the
    5311                         shutdown procedure.</p></li><li class="listitem"><p><em class="parameter"><code>%r</code></em> will be substituted with the
     5311                        shutdown procedure.</p></li><li><p><em class="parameter"><code>%r</code></em> will be substituted with the
    53125312                        switch <span class="emphasis"><em>-r</em></span>. It means reboot after shutdown
    5313                         for NT.</p></li><li class="listitem"><p><em class="parameter"><code>%f</code></em> will be substituted with the
     5313                        for NT.</p></li><li><p><em class="parameter"><code>%f</code></em> will be substituted with the
    53145314                        switch <span class="emphasis"><em>-f</em></span>. It means force the shutdown
    53155315                        even if applications do not respond for NT.</p></li></ul></div><p>Shutdown script example:
    … …  
    53295329</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>
    53305330</em></span>
    5331 </p></dd></dl></div></div><div class="section" title="smb encrypt (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2566751"></a>
     5331</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560770"></a>
    53325332
    53335333smb encrypt (S)
    5334 </h3></div></div></div><a class="indexterm" name="id2566752"></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
     5334</h3></div></div></div><a class="indexterm" name="id2560771"></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
    53355335    extension to the SMB/CIFS protocol negotiated as part of the UNIX extensions.
    53365336    SMB encryption uses the GSSAPI (SSPI on Windows) ability to encrypt
    … …  
    53605360    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>
    53615361</em></span>
    5362 </p></dd></dl></div></div><div class="section" title="smb passwd file (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2566858"></a>
     5362</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560876"></a>
    53635363
    53645364smb passwd file (G)
    5365 </h3></div></div></div><a class="indexterm" name="id2566859"></a><a name="SMBPASSWDFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option sets the path to the encrypted smbpasswd file. By
     5365</h3></div></div></div><a class="indexterm" name="id2560877"></a><a name="SMBPASSWDFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option sets the path to the encrypted smbpasswd file. By
    53665366    default the path to the smbpasswd file  is compiled into Samba.</p><p>
    53675367    An example of use is:
    … …  
    53715371    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>smb passwd file</code></em> = <code class="literal">${prefix}/private/smbpasswd</code>
    53725372</em></span>
    5373 </p></dd></dl></div></div><div class="section" title="smb ports (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2566911"></a>
     5373</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560929"></a>
    53745374
    53755375smb ports (G)
    5376 </h3></div></div></div><a class="indexterm" name="id2566912"></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>
    5377 </em></span>
    5378 </p></dd></dl></div></div><div class="section" title="socket address (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2566953"></a>
     5376</h3></div></div></div><a class="indexterm" name="id2560930"></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>
     5377</em></span>
     5378</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560971"></a>
    53795379
    53805380socket address (G)
    5381 </h3></div></div></div><a class="indexterm" name="id2566954"></a><a name="SOCKETADDRESS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to control what
     5381</h3></div></div></div><a class="indexterm" name="id2560972"></a><a name="SOCKETADDRESS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to control what
    53825382        address Samba will listen for connections on. This is used to
    53835383        support multiple virtual interfaces on the one server, each
    … …  
    53885388</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>socket address</code></em> = <code class="literal">192.168.2.20</code>
    53895389</em></span>
    5390 </p></dd></dl></div></div><div class="section" title="socket options (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2567023"></a>
     5390</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561041"></a>
    53915391
    53925392socket options (G)
    5393 </h3></div></div></div><a class="indexterm" name="id2567024"></a><a name="SOCKETOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to set socket options
     5393</h3></div></div></div><a class="indexterm" name="id2561042"></a><a name="SOCKETOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to set socket options
    53945394    to be used when talking with the client.</p><p>Socket options are controls on the networking layer
    53955395    of the operating systems which allow the connection to be
    … …  
    54075407    samba-technical@samba.org</a>.</p><p>Any of the supported socket options may be combined
    54085408    in any way you like, as long as your OS allows it.</p><p>This is the list of socket options currently settable
    5409     using this option:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>SO_KEEPALIVE</p></li><li class="listitem"><p>SO_REUSEADDR</p></li><li class="listitem"><p>SO_BROADCAST</p></li><li class="listitem"><p>TCP_NODELAY</p></li><li class="listitem"><p>IPTOS_LOWDELAY</p></li><li class="listitem"><p>IPTOS_THROUGHPUT</p></li><li class="listitem"><p>SO_SNDBUF *</p></li><li class="listitem"><p>SO_RCVBUF *</p></li><li class="listitem"><p>SO_SNDLOWAT *</p></li><li class="listitem"><p>SO_RCVLOWAT *</p></li></ul></div><p>Those marked with a <span class="emphasis"><em>'*'</em></span> take an integer
     5409    using this option:</p><div class="itemizedlist"><ul type="disc"><li><p>SO_KEEPALIVE</p></li><li><p>SO_REUSEADDR</p></li><li><p>SO_BROADCAST</p></li><li><p>TCP_NODELAY</p></li><li><p>IPTOS_LOWDELAY</p></li><li><p>IPTOS_THROUGHPUT</p></li><li><p>SO_SNDBUF *</p></li><li><p>SO_RCVBUF *</p></li><li><p>SO_SNDLOWAT *</p></li><li><p>SO_RCVLOWAT *</p></li></ul></div><p>Those marked with a <span class="emphasis"><em>'*'</em></span> take an integer
    54105410    argument. The others can optionally take a 1 or 0 argument to enable
    54115411    or disable the option, by default they will be enabled if you
    … …  
    54195419</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>socket options</code></em> = <code class="literal">IPTOS_LOWDELAY</code>
    54205420</em></span>
    5421 </p></dd></dl></div></div><div class="section" title="stat cache (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2567234"></a>
     5421</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561252"></a>
    54225422
    54235423stat cache (G)
    5424 </h3></div></div></div><a class="indexterm" name="id2567235"></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
     5424</h3></div></div></div><a class="indexterm" name="id2561253"></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
    54255425        speed up case insensitive name mappings. You should never need
    54265426        to change this parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>stat cache</code></em> = <code class="literal">yes</code>
    54275427</em></span>
    5428 </p></dd></dl></div></div><div class="section" title="store dos attributes (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2567285"></a>
     5428</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561303"></a>
    54295429
    54305430store dos attributes (S)
    5431 </h3></div></div></div><a class="indexterm" name="id2567286"></a><a name="STOREDOSATTRIBUTES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5431</h3></div></div></div><a class="indexterm" name="id2561304"></a><a name="STOREDOSATTRIBUTES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    54325432        If this parameter is set Samba attempts to first read DOS attributes (SYSTEM, HIDDEN, ARCHIVE or
    54335433        READ-ONLY) from a filesystem extended attribute, before mapping DOS attributes to UNIX permission bits (such
    … …  
    54415441        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>store dos attributes</code></em> = <code class="literal">no</code>
    54425442</em></span>
    5443 </p></dd></dl></div></div><div class="section" title="strict allocate (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2567407"></a>
     5443</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561425"></a>
    54445444
    54455445strict allocate (S)
    5446 </h3></div></div></div><a class="indexterm" name="id2567408"></a><a name="STRICTALLOCATE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean that controls the handling of
     5446</h3></div></div></div><a class="indexterm" name="id2561426"></a><a name="STRICTALLOCATE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean that controls the handling of
    54475447    disk space allocation in the server. When this is set to <code class="constant">yes</code>
    54485448    the server will change from UNIX behaviour of not committing real
    … …  
    54565456    of users.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>strict allocate</code></em> = <code class="literal">no</code>
    54575457</em></span>
    5458 </p></dd></dl></div></div><div class="section" title="strict locking (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2567477"></a>
     5458</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561495"></a>
    54595459
    54605460strict locking (S)
    5461 </h3></div></div></div><a class="indexterm" name="id2567478"></a><a name="STRICTLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5461</h3></div></div></div><a class="indexterm" name="id2561496"></a><a name="STRICTLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
    54625462        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>,
    54635463        the server will check every read and write access for file locks, and deny access if locks exist. This can be slow on
    … …  
    54755475        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>strict locking</code></em> = <code class="literal">Auto</code>
    54765476</em></span>
    5477 </p></dd></dl></div></div><div class="section" title="strict sync (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2567556"></a>
     5477</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561574"></a>
    54785478
    54795479strict sync (S)
    5480 </h3></div></div></div><a class="indexterm" name="id2567557"></a><a name="STRICTSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>Many Windows applications (including the Windows 98 explorer
     5480</h3></div></div></div><a class="indexterm" name="id2561576"></a><a name="STRICTSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>Many Windows applications (including the Windows 98 explorer
    54815481    shell) seem to confuse flushing buffer contents to disk with doing
    54825482    a sync to disk. Under UNIX, a sync call forces the process to be
    … …  
    54925492    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>
    54935493</em></span>
    5494 </p></dd></dl></div></div><div class="section" title="svcctl list (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2567621"></a>
     5494</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561639"></a>
    54955495
    54965496svcctl list (G)
    5497 </h3></div></div></div><a class="indexterm" name="id2567622"></a><a name="SVCCTLLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of init scripts that smbd
     5497</h3></div></div></div><a class="indexterm" name="id2561640"></a><a name="SVCCTLLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of init scripts that smbd
    54985498    will use for starting and stopping Unix services via the Win32
    54995499    ServiceControl API.  This allows Windows administrators to
    … …  
    55085508</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>svcctl list</code></em> = <code class="literal">cups postfix portmap httpd</code>
    55095509</em></span>
    5510 </p></dd></dl></div></div><div class="section" title="sync always (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2567707"></a>
     5510</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561725"></a>
    55115511
    55125512sync always (S)
    5513 </h3></div></div></div><a class="indexterm" name="id2567708"></a><a name="SYNCALWAYS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls
     5513</h3></div></div></div><a class="indexterm" name="id2561726"></a><a name="SYNCALWAYS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls
    55145514    whether writes will always be written to stable storage before
    55155515    the write call returns. If this is <code class="constant">no</code> then the server will be
    … …  
    55225522    any affect.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>sync always</code></em> = <code class="literal">no</code>
    55235523</em></span>
    5524 </p></dd></dl></div></div><div class="section" title="syslog only (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2567777"></a>
     5524</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561796"></a>
    55255525
    55265526syslog only (G)
    5527 </h3></div></div></div><a class="indexterm" name="id2567778"></a><a name="SYSLOGONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5527</h3></div></div></div><a class="indexterm" name="id2561797"></a><a name="SYSLOGONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    55285528    If this parameter is set then Samba debug messages are logged into the system
    55295529    syslog only, and not to the debug log files. There still will be some
    … …  
    55315531    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>syslog only</code></em> = <code class="literal">no</code>
    55325532</em></span>
    5533 </p></dd></dl></div></div><div class="section" title="syslog (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2567825"></a>
     5533</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561843"></a>
    55345534
    55355535syslog (G)
    5536 </h3></div></div></div><a class="indexterm" name="id2567826"></a><a name="SYSLOG"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5536</h3></div></div></div><a class="indexterm" name="id2561844"></a><a name="SYSLOG"></a><div class="variablelist"><dl><dt></dt><dd><p>
    55375537    This parameter maps how Samba debug messages are logged onto the system syslog logging levels.
    55385538    Samba debug level zero maps onto syslog <code class="constant">LOG_ERR</code>, debug level one maps onto
    … …  
    55455545    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>syslog</code></em> = <code class="literal">1</code>
    55465546</em></span>
    5547 </p></dd></dl></div></div><div class="section" title="template homedir (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2567895"></a>
     5547</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561914"></a>
    55485548
    55495549template homedir (G)
    5550 </h3></div></div></div><a class="indexterm" name="id2567896"></a><a name="TEMPLATEHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
     5550</h3></div></div></div><a class="indexterm" name="id2561915"></a><a name="TEMPLATEHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
    55515551        user, the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon  uses this
    55525552        parameter to fill in the home directory for that user. If the
    … …  
    55565556        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>
    55575557</em></span>
    5558 </p></dd></dl></div></div><div class="section" title="template shell (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2567961"></a>
     5558</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561979"></a>
    55595559
    55605560template shell (G)
    5561 </h3></div></div></div><a class="indexterm" name="id2567962"></a><a name="TEMPLATESHELL"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
     5561</h3></div></div></div><a class="indexterm" name="id2561980"></a><a name="TEMPLATESHELL"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
    55625562        user, the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon uses this
    5563         parameter to fill in the login shell for that user.</p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="time offset (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2568000"></a>
     5563        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="id2562018"></a>
    55645564
    55655565time offset (G)
    5566 </h3></div></div></div><a class="indexterm" name="id2568001"></a><a name="TIMEOFFSET"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a setting in minutes to add
     5566</h3></div></div></div><a class="indexterm" name="id2562019"></a><a name="TIMEOFFSET"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a setting in minutes to add
    55675567        to the normal GMT to local time conversion. This is useful if
    55685568        you are serving a lot of PCs that have incorrect daylight
    … …  
    55715571</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>time offset</code></em> = <code class="literal">60</code>
    55725572</em></span>
    5573 </p></dd></dl></div></div><div class="section" title="time server (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2568060"></a>
     5573</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562078"></a>
    55745574
    55755575time server (G)
    5576 </h3></div></div></div><a class="indexterm" name="id2568061"></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
     5576</h3></div></div></div><a class="indexterm" name="id2562079"></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
    55775577clients.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>time server</code></em> = <code class="literal">no</code>
    55785578</em></span>
    5579 </p></dd></dl></div></div><div class="section" title="unix charset (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2568110"></a>
     5579</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562129"></a>
    55805580
    55815581unix charset (G)
    5582 </h3></div></div></div><a class="indexterm" name="id2568112"></a><a name="UNIXCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the charset the unix machine
     5582</h3></div></div></div><a class="indexterm" name="id2562130"></a><a name="UNIXCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the charset the unix machine
    55835583                Samba runs on uses. Samba needs to know this in order to be able to
    55845584                convert text to the charsets other SMB clients use.
    … …  
    55895589</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>unix charset</code></em> = <code class="literal">ASCII</code>
    55905590</em></span>
    5591 </p></dd></dl></div></div><div class="section" title="unix extensions (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2568176"></a>
     5591</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562195"></a>
    55925592
    55935593unix extensions (G)
    5594 </h3></div></div></div><a class="indexterm" name="id2568178"></a><a name="UNIXEXTENSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
     5594</h3></div></div></div><a class="indexterm" name="id2562196"></a><a name="UNIXEXTENSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
    55955595    implements the CIFS UNIX extensions, as defined by HP.
    55965596    These extensions enable Samba to better serve UNIX CIFS clients
    55975597    by supporting features such as symbolic links, hard links, etc...
    55985598    These extensions require a similarly enabled client, and are of
    5599     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>
    5600 </em></span>
    5601 </p></dd></dl></div></div><div class="section" title="unix password sync (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2568224"></a>
     5599    no current use to Windows clients.</p><p>
     5600    Note if this parameter is turned on, the <a class="link" href="smb.conf.5.html#WIDELINKS" target="_top">wide links</a>
     5601    parameter will automatically be disabled.
     5602    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>unix extensions</code></em> = <code class="literal">yes</code>
     5603</em></span>
     5604</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562260"></a>
    56025605
    56035606unix password sync (G)
    5604 </h3></div></div></div><a class="indexterm" name="id2568225"></a><a name="UNIXPASSWORDSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
     5607</h3></div></div></div><a class="indexterm" name="id2562261"></a><a name="UNIXPASSWORDSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
    56055608    attempts to synchronize the UNIX password with the SMB password
    56065609    when the encrypted SMB password in the smbpasswd file is changed.
    … …  
    56115614        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>
    56125615</em></span>
    5613 </p></dd></dl></div></div><div class="section" title="update encrypted (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2568285"></a>
     5616</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562321"></a>
    56145617
    56155618update encrypted (G)
    5616 </h3></div></div></div><a class="indexterm" name="id2568286"></a><a name="UPDATEENCRYPTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5619</h3></div></div></div><a class="indexterm" name="id2562322"></a><a name="UPDATEENCRYPTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
    56175620        This boolean parameter allows a user logging on with a plaintext password to have their encrypted (hashed)
    56185621        password in the smbpasswd file to be updated automatically as they log on. This option allows a site to
    … …  
    56325635        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>update encrypted</code></em> = <code class="literal">no</code>
    56335636</em></span>
    5634 </p></dd></dl></div></div><div class="section" title="use client driver (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2568404"></a>
     5637</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562452"></a>
    56355638
    56365639use client driver (S)
    5637 </h3></div></div></div><a class="indexterm" name="id2568405"></a><a name="USECLIENTDRIVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter applies only to Windows NT/2000
     5640</h3></div></div></div><a class="indexterm" name="id2562453"></a><a name="USECLIENTDRIVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter applies only to Windows NT/2000
    56385641    clients.  It has no effect on Windows 95/98/ME clients.  When
    56395642    serving a printer to Windows NT/2000 clients without first installing
    … …  
    56605663        server.</em></span></p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use client driver</code></em> = <code class="literal">no</code>
    56615664</em></span>
    5662 </p></dd></dl></div></div><div class="section" title="use kerberos keytab (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2568484"></a>
     5665</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562533"></a>
    56635666
    56645667use kerberos keytab (G)
    5665 </h3></div></div></div><a class="indexterm" name="id2568486"></a><a name="USEKERBEROSKEYTAB"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5668</h3></div></div></div><a class="indexterm" name="id2562534"></a><a name="USEKERBEROSKEYTAB"></a><div class="variablelist"><dl><dt></dt><dd><p>
    56665669        Specifies whether Samba should attempt to maintain service principals in the systems
    56675670        keytab file for <code class="constant">host/FQDN</code> and <code class="constant">cifs/FQDN</code>.
    … …  
    56755678        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use kerberos keytab</code></em> = <code class="literal">False</code>
    56765679</em></span>
    5677 </p></dd></dl></div></div><div class="section" title="use mmap (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2568553"></a>
     5680</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562601"></a>
    56785681
    56795682use mmap (G)
    5680 </h3></div></div></div><a class="indexterm" name="id2568554"></a><a name="USEMMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>This global parameter determines if the tdb internals of Samba can
     5683</h3></div></div></div><a class="indexterm" name="id2562602"></a><a name="USEMMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>This global parameter determines if the tdb internals of Samba can
    56815684    depend on mmap working correctly on the running system. Samba requires a coherent
    56825685    mmap/read-write system memory cache. Currently only HPUX does not have such a
    … …  
    56875690    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use mmap</code></em> = <code class="literal">yes</code>
    56885691</em></span>
    5689 </p></dd></dl></div></div><div class="section" title="username level (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2568605"></a>
     5692</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562653"></a>
    56905693
    56915694username level (G)
    5692 </h3></div></div></div><a class="indexterm" name="id2568606"></a><a name="USERNAMELEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option helps Samba to try and 'guess' at
     5695</h3></div></div></div><a class="indexterm" name="id2562654"></a><a name="USERNAMELEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option helps Samba to try and 'guess' at
    56935696    the real UNIX username, as many DOS clients send an all-uppercase
    56945697    username. By default Samba tries all lowercase, followed by the
    … …  
    57055708</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>username level</code></em> = <code class="literal">5</code>
    57065709</em></span>
    5707 </p></dd></dl></div></div><div class="section" title="username map script (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2568687"></a>
     5710</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562735"></a>
    57085711
    57095712username map script (G)
    5710 </h3></div></div></div><a class="indexterm" name="id2568688"></a><a name="USERNAMEMAPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This script is a mutually exclusive alternative to the
     5713</h3></div></div></div><a class="indexterm" name="id2562736"></a><a name="USERNAMEMAPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This script is a mutually exclusive alternative to the
    57115714        <a class="link" href="smb.conf.5.html#USERNAMEMAP" target="_top">username map</a> parameter.  This parameter
    57125715        specifies and external program or script that must accept a single
    … …  
    57195722</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>
    57205723</em></span>
    5721 </p></dd></dl></div></div><div class="section" title="username map (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2568764"></a>
     5724</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562812"></a>
    57225725
    57235726username map (G)
    5724 </h3></div></div></div><a class="indexterm" name="id2568765"></a><a name="USERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5727</h3></div></div></div><a class="indexterm" name="id2562813"></a><a name="USERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    57255728        This option allows you to specify a file containing a mapping of usernames from the clients to the server.
    57265729        This can be used for several purposes. The most common is to map usernames that users use on DOS or Windows
    … …  
    58065809# no username map</code>
    58075810</em></span>
    5808 </p></dd></dl></div></div><div class="section" title="user"><div class="titlepage"><div><div><h3 class="title"><a name="id2569043"></a>
     5811</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563092"></a>
    58095812
    58105813<a name="USER"></a>user
    5811 </h3></div></div></div><a class="indexterm" name="id2569044"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#USERNAME">username</a>.</p></dd></dl></div></div><div class="section" title="users"><div class="titlepage"><div><div><h3 class="title"><a name="id2569075"></a>
     5814</h3></div></div></div><a class="indexterm" name="id2563093"></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="id2563124"></a>
    58125815
    58135816<a name="USERS"></a>users
    5814 </h3></div></div></div><a class="indexterm" name="id2569076"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#USERNAME">username</a>.</p></dd></dl></div></div><div class="section" title="username (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2569107"></a>
     5817</h3></div></div></div><a class="indexterm" name="id2563125"></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="id2563155"></a>
    58155818
    58165819username (S)
    5817 </h3></div></div></div><a class="indexterm" name="id2569108"></a><a name="USERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>Multiple users may be specified in a comma-delimited
     5820</h3></div></div></div><a class="indexterm" name="id2563156"></a><a name="USERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>Multiple users may be specified in a comma-delimited
    58185821    list, in which case the supplied password will be tested against
    58195822    each username in turn (left to right).</p><p>The <em class="parameter"><code>username</code></em> line is needed only when
    … …  
    58535856</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>username</code></em> = <code class="literal">fred, mary, jack, jane, @users, @pcgroup</code>
    58545857</em></span>
    5855 </p></dd></dl></div></div><div class="section" title="usershare allow guests (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2569277"></a>
     5858</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563326"></a>
    58565859
    58575860usershare allow guests (G)
    5858 </h3></div></div></div><a class="indexterm" name="id2569278"></a><a name="USERSHAREALLOWGUESTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether user defined shares are allowed
     5861</h3></div></div></div><a class="indexterm" name="id2563327"></a><a name="USERSHAREALLOWGUESTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether user defined shares are allowed
    58595862        to be accessed by non-authenticated users or not. It is the equivalent
    58605863        of allowing people who can create a share the option of setting
    … …  
    58635866        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>
    58645867</em></span>
    5865 </p></dd></dl></div></div><div class="section" title="usershare max shares (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2569330"></a>
     5868</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563378"></a>
    58665869
    58675870usershare max shares (G)
    5868 </h3></div></div></div><a class="indexterm" name="id2569331"></a><a name="USERSHAREMAXSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of user defined shares
     5871</h3></div></div></div><a class="indexterm" name="id2563379"></a><a name="USERSHAREMAXSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of user defined shares
    58695872        that are allowed to be created by users belonging to the group owning the
    58705873        usershare directory. If set to zero (the default) user defined shares are ignored.
    58715874        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare max shares</code></em> = <code class="literal">0</code>
    58725875</em></span>
    5873 </p></dd></dl></div></div><div class="section" title="usershare owner only (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2569375"></a>
     5876</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563423"></a>
    58745877
    58755878usershare owner only (G)
    5876 </h3></div></div></div><a class="indexterm" name="id2569376"></a><a name="USERSHAREOWNERONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether the pathname exported by
     5879</h3></div></div></div><a class="indexterm" name="id2563424"></a><a name="USERSHAREOWNERONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether the pathname exported by
    58775880        a user defined shares must be owned by the user creating the
    58785881        user defined share or not. If set to True (the default) then
    … …  
    58845887        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare owner only</code></em> = <code class="literal">True</code>
    58855888</em></span>
    5886 </p></dd></dl></div></div><div class="section" title="usershare path (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2569425"></a>
     5889</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563473"></a>
    58875890
    58885891usershare path (G)
    5889 </h3></div></div></div><a class="indexterm" name="id2569426"></a><a name="USERSHAREPATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the absolute path of the directory on the
     5892</h3></div></div></div><a class="indexterm" name="id2563474"></a><a name="USERSHAREPATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the absolute path of the directory on the
    58905893        filesystem used to store the user defined share definition files.
    58915894        This directory must be owned by root, and have no access for
    … …  
    59085911        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare path</code></em> = <code class="literal">NULL</code>
    59095912</em></span>
    5910 </p></dd></dl></div></div><div class="section" title="usershare prefix allow list (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2569496"></a>
     5913</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563544"></a>
    59115914
    59125915usershare prefix allow list (G)
    5913 </h3></div></div></div><a class="indexterm" name="id2569497"></a><a name="USERSHAREPREFIXALLOWLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
     5916</h3></div></div></div><a class="indexterm" name="id2563545"></a><a name="USERSHAREPREFIXALLOWLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
    59145917        the root of which are allowed to be exported by user defined share definitions.
    59155918        If the pathname to be exported doesn't start with one of the strings in this
    … …  
    59265929</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>usershare prefix allow list</code></em> = <code class="literal">/home /data /space</code>
    59275930</em></span>
    5928 </p></dd></dl></div></div><div class="section" title="usershare prefix deny list (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2569569"></a>
     5931</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563617"></a>
    59295932
    59305933usershare prefix deny list (G)
    5931 </h3></div></div></div><a class="indexterm" name="id2569570"></a><a name="USERSHAREPREFIXDENYLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
     5934</h3></div></div></div><a class="indexterm" name="id2563618"></a><a name="USERSHAREPREFIXDENYLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
    59325935        the root of which are NOT allowed to be exported by user defined share definitions.
    59335936        If the pathname exported starts with one of the strings in this
    … …  
    59455948</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>usershare prefix deny list</code></em> = <code class="literal">/etc /dev /private</code>
    59465949</em></span>
    5947 </p></dd></dl></div></div><div class="section" title="usershare template share (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2569643"></a>
     5950</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563691"></a>
    59485951
    59495952usershare template share (G)
    5950 </h3></div></div></div><a class="indexterm" name="id2569644"></a><a name="USERSHARETEMPLATESHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>User defined shares only have limited possible parameters
     5953</h3></div></div></div><a class="indexterm" name="id2563692"></a><a name="USERSHARETEMPLATESHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>User defined shares only have limited possible parameters
    59515954        such as path, guest ok, etc. This parameter allows usershares to
    59525955        "cloned" from an existing share. If "usershare template share"
    … …  
    59635966</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>usershare template share</code></em> = <code class="literal">template_share</code>
    59645967</em></span>
    5965 </p></dd></dl></div></div><div class="section" title="use sendfile (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2569716"></a>
     5968</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563764"></a>
    59665969
    59675970use sendfile (S)
    5968 </h3></div></div></div><a class="indexterm" name="id2569717"></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>
     5971</h3></div></div></div><a class="indexterm" name="id2563765"></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>
    59695972    system call is supported by the underlying operating system, then some SMB read calls
    59705973    (mainly ReadAndX and ReadRaw) will use the more efficient sendfile system call for files that
    … …  
    59755978    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use sendfile</code></em> = <code class="literal">false</code>
    59765979</em></span>
    5977 </p></dd></dl></div></div><div class="section" title="use spnego (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2569774"></a>
     5980</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563822"></a>
    59785981
    59795982use spnego (G)
    5980 </h3></div></div></div><a class="indexterm" name="id2569775"></a><a name="USESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p>This variable controls controls whether samba will try
     5983</h3></div></div></div><a class="indexterm" name="id2563823"></a><a name="USESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p>This variable controls controls whether samba will try
    59815984    to use Simple and Protected NEGOciation (as specified by rfc2478) with
    59825985    WindowsXP and Windows2000 clients to agree upon an authentication mechanism.
    … …  
    59865989        disabled.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use spnego</code></em> = <code class="literal">yes</code>
    59875990</em></span>
    5988 </p></dd></dl></div></div><div class="section" title="utmp directory (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2569823"></a>
     5991</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563871"></a>
    59895992
    59905993utmp directory (G)
    5991 </h3></div></div></div><a class="indexterm" name="id2569824"></a><a name="UTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only available if Samba has
     5994</h3></div></div></div><a class="indexterm" name="id2563872"></a><a name="UTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only available if Samba has
    59925995        been configured and compiled with the option <code class="literal">
    59935996        --with-utmp</code>. It specifies a directory pathname that is
    … …  
    60016004</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>utmp directory</code></em> = <code class="literal">/var/run/utmp</code>
    60026005</em></span>
    6003 </p></dd></dl></div></div><div class="section" title="utmp (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2569901"></a>
     6006</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563949"></a>
    60046007
    60056008utmp (G)
    6006 </h3></div></div></div><a class="indexterm" name="id2569902"></a><a name="UTMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6009</h3></div></div></div><a class="indexterm" name="id2563950"></a><a name="UTMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    60076010        This boolean parameter is only available if Samba has been configured and compiled 
    60086011        with the option <code class="literal">--with-utmp</code>. If set to
    … …  
    60166019        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>utmp</code></em> = <code class="literal">no</code>
    60176020</em></span>
    6018 </p></dd></dl></div></div><div class="section" title="valid users (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2569964"></a>
     6021</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564012"></a>
    60196022
    60206023valid users (S)
    6021 </h3></div></div></div><a class="indexterm" name="id2569965"></a><a name="VALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6024</h3></div></div></div><a class="indexterm" name="id2564013"></a><a name="VALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    60226025    This is a list of users that should be allowed to login to this service. Names starting with
    60236026    '@', '+' and  '&amp;' are interpreted using the same rules as described in the
    … …  
    60356038</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>valid users</code></em> = <code class="literal">greg, @pcusers</code>
    60366039</em></span>
    6037 </p></dd></dl></div></div><div class="section" title="-valid (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2570055"></a>
     6040</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564103"></a>
    60386041
    60396042-valid (S)
    6040 </h3></div></div></div><a class="indexterm" name="id2570056"></a><a name="-VALID"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter indicates whether a share is
     6043</h3></div></div></div><a class="indexterm" name="id2564104"></a><a name="-VALID"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter indicates whether a share is
    60416044        valid and thus can be used. When this parameter is set to false,
    60426045        the share will be in no way visible nor accessible.
    … …  
    60476050        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>-valid</code></em> = <code class="literal">yes</code>
    60486051</em></span>
    6049 </p></dd></dl></div></div><div class="section" title="veto files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2570105"></a>
     6052</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564153"></a>
    60506053
    60516054veto files (S)
    6052 </h3></div></div></div><a class="indexterm" name="id2570106"></a><a name="VETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6055</h3></div></div></div><a class="indexterm" name="id2564154"></a><a name="VETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    60536056        This is a list of files and directories that are neither visible nor accessible.  Each entry in
    60546057        the list must be separated by a '/', which allows spaces to be included in the entry. '*' and '?'
    … …  
    60816084        </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>
    60826085</em></span>
    6083 </p></dd></dl></div></div><div class="section" title="veto oplock files (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2570224"></a>
     6086</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564272"></a>
    60846087
    60856088veto oplock files (S)
    6086 </h3></div></div></div><a class="indexterm" name="id2570225"></a><a name="VETOOPLOCKFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6089</h3></div></div></div><a class="indexterm" name="id2564273"></a><a name="VETOOPLOCKFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    60876090        This parameter is only valid when the <a class="link" href="smb.conf.5.html#OPLOCKS" target="_top">oplocks</a>
    60886091        parameter is turned on for a share. It allows the Samba administrator
    … …  
    61056108# No files are vetoed for oplock grants</code>
    61066109</em></span>
    6107 </p></dd></dl></div></div><div class="section" title="vfs object"><div class="titlepage"><div><div><h3 class="title"><a name="id2570317"></a>
     6110</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564365"></a>
    61086111
    61096112<a name="VFSOBJECT"></a>vfs object
    6110 </h3></div></div></div><a class="indexterm" name="id2570318"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#VFSOBJECTS">vfs objects</a>.</p></dd></dl></div></div><div class="section" title="vfs objects (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2570349"></a>
     6113</h3></div></div></div><a class="indexterm" name="id2564366"></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="id2564397"></a>
    61116114
    61126115vfs objects (S)
    6113 </h3></div></div></div><a class="indexterm" name="id2570350"></a><a name="VFSOBJECTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the backend names which
     6116</h3></div></div></div><a class="indexterm" name="id2564398"></a><a name="VFSOBJECTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the backend names which
    61146117        are used for Samba VFS I/O operations.  By default, normal
    61156118        disk I/O operations are used but these can be overloaded
    … …  
    61186121</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>vfs objects</code></em> = <code class="literal">extd_audit recycle</code>
    61196122</em></span>
    6120 </p></dd></dl></div></div><div class="section" title="volume (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2570409"></a>
     6123</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564457"></a>
    61216124
    61226125volume (S)
    6123 </h3></div></div></div><a class="indexterm" name="id2570410"></a><a name="VOLUME"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the volume label
     6126</h3></div></div></div><a class="indexterm" name="id2564458"></a><a name="VOLUME"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the volume label
    61246127        returned for a share. Useful for CDROMs with installation programs
    61256128        that insist on a particular volume label.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>volume</code></em> = <code class="literal">
    61266129# the name of the share</code>
    61276130</em></span>
    6128 </p></dd></dl></div></div><div class="section" title="wide links (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2570452"></a>
     6131</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564501"></a>
    61296132
    61306133wide links (S)
    6131 </h3></div></div></div><a class="indexterm" name="id2570454"></a><a name="WIDELINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not links
     6134</h3></div></div></div><a class="indexterm" name="id2564502"></a><a name="WIDELINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not links
    61326135        in the UNIX file system may be followed by the server. Links
    61336136        that point to areas within the directory tree exported by the
    61346137        server are always allowed; this parameter controls access only
    6135         to areas that are outside the directory tree being exported.</p><p>Note that setting this parameter can have a negative
    6136         effect on your server performance due to the extra system calls
    6137         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>
    6138 </em></span>
    6139 </p></dd></dl></div></div><div class="section" title="winbind cache time (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2570505"></a>
     6138        to areas that are outside the directory tree being exported.</p><p>Note: Turning this parameter on when UNIX extensions are enabled
     6139        will allow UNIX clients to create symbolic links on the share that
     6140        can point to files or directories outside restricted path exported
     6141        by the share definition. This can cause access to areas outside of
     6142        the share. Due to this problem, this parameter will be automatically
     6143        disabled (with a message in the log file) if the
     6144        <a class="link" href="smb.conf.5.html#UNIXEXTENSIONS" target="_top">unix extensions</a> option is on.
     6145        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>wide links</code></em> = <code class="literal">no</code>
     6146</em></span>
     6147</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564569"></a>
    61406148
    61416149winbind cache time (G)
    6142 </h3></div></div></div><a class="indexterm" name="id2570506"></a><a name="WINBINDCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of
     6150</h3></div></div></div><a class="indexterm" name="id2564570"></a><a name="WINBINDCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of
    61436151        seconds the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon will cache
    61446152        user and group information before querying a Windows NT server
    … …  
    61486156        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind cache time</code></em> = <code class="literal">300</code>
    61496157</em></span>
    6150 </p></dd></dl></div></div><div class="section" title="winbind enum groups (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2570576"></a>
     6158</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564640"></a>
    61516159
    61526160winbind enum groups (G)
    6153 </h3></div></div></div><a class="indexterm" name="id2570577"></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
     6161</h3></div></div></div><a class="indexterm" name="id2564641"></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
    61546162        the enumeration of groups through the <code class="literal">setgrent()</code>,
    61556163        <code class="literal">getgrent()</code> and
    … …  
    61576165        the <em class="parameter"><code>winbind enum groups</code></em> parameter is
    61586166        <code class="constant">no</code>, calls to the <code class="literal">getgrent()</code> system
    6159         call will not return any data. </p><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>Turning off group enumeration may cause some programs to behave oddly.  </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind enum groups</code></em> = <code class="literal">no</code>
    6160 </em></span>
    6161 </p></dd></dl></div></div><div class="section" title="winbind enum users (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2570667"></a>
     6167        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>
     6168</em></span>
     6169</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564730"></a>
    61626170
    61636171winbind enum users (G)
    6164 </h3></div></div></div><a class="indexterm" name="id2570668"></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
     6172</h3></div></div></div><a class="indexterm" name="id2564731"></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
    61656173        necessary to suppress the enumeration of users through the <code class="literal">setpwent()</code>,
    61666174         <code class="literal">getpwent()</code> and
    … …  
    61686176        the <em class="parameter"><code>winbind enum users</code></em> parameter is
    61696177         <code class="constant">no</code>, calls to the <code class="literal">getpwent</code> system call
    6170         will not return any data. </p><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>Turning off user
     6178        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 user
    61716179        enumeration may cause some programs to behave oddly.  For
    61726180        example, the finger program relies on having access to the
    … …  
    61746182        usernames. </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind enum users</code></em> = <code class="literal">no</code>
    61756183</em></span>
    6176 </p></dd></dl></div></div><div class="section" title="winbind expand groups (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2570760"></a>
     6184</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564824"></a>
    61776185
    61786186winbind expand groups (G)
    6179 </h3></div></div></div><a class="indexterm" name="id2570761"></a><a name="WINBINDEXPANDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum depth that winbindd
     6187</h3></div></div></div><a class="indexterm" name="id2564825"></a><a name="WINBINDEXPANDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum depth that winbindd
    61806188              will traverse when flattening nested group memberships
    61816189              of Windows domain groups.  This is different from the
    … …  
    61896197         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>
    61906198</em></span>
    6191 </p></dd></dl></div></div><div class="section" title="winbind nested groups (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2570829"></a>
     6199</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564892"></a>
    61926200
    61936201winbind nested groups (G)
    6194 </h3></div></div></div><a class="indexterm" name="id2570830"></a><a name="WINBINDNESTEDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to yes, this parameter activates the support for nested
     6202</h3></div></div></div><a class="indexterm" name="id2564894"></a><a name="WINBINDNESTEDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to yes, this parameter activates the support for nested
    61956203                 groups. Nested groups are also called local groups or
    61966204                 aliases. They work like their counterparts in Windows: Nested
    … …  
    62006208                 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>
    62016209</em></span>
    6202 </p></dd></dl></div></div><div class="section" title="winbind normalize names (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2570888"></a>
     6210</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564943"></a>
    62036211
    62046212winbind normalize names (G)
    6205 </h3></div></div></div><a class="indexterm" name="id2570889"></a><a name="WINBINDNORMALIZENAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether winbindd will replace
     6213</h3></div></div></div><a class="indexterm" name="id2564944"></a><a name="WINBINDNORMALIZENAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether winbindd will replace
    62066214          whitespace in user and group names with an underscore (_) character.
    62076215          For example, whether the name "Space Kadet" should be
    … …  
    62176225          idmap and nss_info plugin for the specifics on how to configure
    62186226          name aliasing for a specific configuration.  Name aliasing takes
    6219           precendence (and is mutually exclusive) over the whitespace
     6227          precedence (and is mutually exclusive) over the whitespace
    62206228          replacement mechanism discussed previsouly.
    62216229          </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind normalize names</code></em> = <code class="literal">no</code>
    … …  
    62236231</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind normalize names</code></em> = <code class="literal">yes</code>
    62246232</em></span>
    6225 </p></dd></dl></div></div><div class="section" title="winbind nss info (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2570965"></a>
     6233</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565021"></a>
    62266234
    62276235winbind nss info (G)
    6228 </h3></div></div></div><a class="indexterm" name="id2570966"></a><a name="WINBINDNSSINFO"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control how Winbind retrieves Name
     6236</h3></div></div></div><a class="indexterm" name="id2565022"></a><a name="WINBINDNSSINFO"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control how Winbind retrieves Name
    62296237        Service Information to construct a user's home directory and login shell.
    62306238        Currently the following settings are available:
    62316239
    6232         </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="parameter"><code>template</code></em>
     6240        </p><div class="itemizedlist"><ul type="disc"><li><p><em class="parameter"><code>template</code></em>
    62336241                        - The default, using the parameters of <em class="parameter"><code>template
    62346242                        shell</code></em> and <em class="parameter"><code>template homedir</code></em>)
    6235                         </p></li><li class="listitem"><p><em class="parameter"><code>&lt;sfu | rfc2307 &gt;</code></em>
     6243                        </p></li><li><p><em class="parameter"><code>&lt;sfu | rfc2307 &gt;</code></em>
    62366244                        - When Samba is running in security = ads and your Active Directory
    62376245                        Domain Controller does support the Microsoft "Services for Unix" (SFU)
    … …  
    62486256</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind nss info</code></em> = <code class="literal">template sfu</code>
    62496257</em></span>
    6250 </p></dd></dl></div></div><div class="section" title="winbind offline logon (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2571085"></a>
     6258</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565140"></a>
    62516259
    62526260winbind offline logon (G)
    6253 </h3></div></div></div><a class="indexterm" name="id2571086"></a><a name="WINBINDOFFLINELOGON"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control whether Winbind should
     6261</h3></div></div></div><a class="indexterm" name="id2565141"></a><a name="WINBINDOFFLINELOGON"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control whether Winbind should
    62546262        allow to login with the <em class="parameter"><code>pam_winbind</code></em>
    62556263        module using Cached Credentials. If enabled, winbindd will store user credentials
    … …  
    62596267</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind offline logon</code></em> = <code class="literal">true</code>
    62606268</em></span>
    6261 </p></dd></dl></div></div><div class="section" title="winbind reconnect delay (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2571154"></a>
     6269</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565209"></a>
    62626270
    62636271winbind reconnect delay (G)
    6264 </h3></div></div></div><a class="indexterm" name="id2571155"></a><a name="WINBINDRECONNECTDELAY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of
     6272</h3></div></div></div><a class="indexterm" name="id2565210"></a><a name="WINBINDRECONNECTDELAY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of
    62656273        seconds the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon will wait between
    62666274        attempts to contact a Domain controller for a domain that is
    62676275        determined to be down or not contactable.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind reconnect delay</code></em> = <code class="literal">30</code>
    62686276</em></span>
    6269 </p></dd></dl></div></div><div class="section" title="winbind refresh tickets (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2571207"></a>
     6277</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565262"></a>
    62706278
    62716279winbind refresh tickets (G)
    6272 </h3></div></div></div><a class="indexterm" name="id2571208"></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
     6280</h3></div></div></div><a class="indexterm" name="id2565263"></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
    62736281        retrieved using the <em class="parameter"><code>pam_winbind</code></em> module.
    62746282
    … …  
    62776285</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind refresh tickets</code></em> = <code class="literal">true</code>
    62786286</em></span>
    6279 </p></dd></dl></div></div><div class="section" title="winbind rpc only (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2571274"></a>
     6287</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565329"></a>
    62806288
    62816289winbind rpc only (G)
    6282 </h3></div></div></div><a class="indexterm" name="id2571275"></a><a name="WINBINDRPCONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6290</h3></div></div></div><a class="indexterm" name="id2565330"></a><a name="WINBINDRPCONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    62836291        Setting this parameter to <code class="literal">yes</code> forces
    62846292        winbindd to use RPC instead of LDAP to retrieve information from Domain
    … …  
    62866294        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind rpc only</code></em> = <code class="literal">no</code>
    62876295</em></span>
    6288 </p></dd></dl></div></div><div class="section" title="winbind separator (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2571323"></a>
     6296</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565378"></a>
    62896297
    62906298winbind separator (G)
    6291 </h3></div></div></div><a class="indexterm" name="id2571324"></a><a name="WINBINDSEPARATOR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows an admin to define the character
     6299</h3></div></div></div><a class="indexterm" name="id2565379"></a><a name="WINBINDSEPARATOR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows an admin to define the character
    62926300        used when listing a username of the form of <em class="replaceable"><code>DOMAIN
    62936301        </code></em>\<em class="replaceable"><code>user</code></em>.  This parameter
    … …  
    63006308</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind separator</code></em> = <code class="literal">+</code>
    63016309</em></span>
    6302 </p></dd></dl></div></div><div class="section" title="winbind trusted domains only (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2571410"></a>
     6310</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565465"></a>
    63036311
    63046312winbind trusted domains only (G)
    6305 </h3></div></div></div><a class="indexterm" name="id2571411"></a><a name="WINBINDTRUSTEDDOMAINSONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6313</h3></div></div></div><a class="indexterm" name="id2565466"></a><a name="WINBINDTRUSTEDDOMAINSONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    63066314        This parameter is designed to allow Samba servers that are members
    63076315        of a Samba controlled domain to use UNIX accounts distributed via NIS,
    … …  
    63146322        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind trusted domains only</code></em> = <code class="literal">no</code>
    63156323</em></span>
    6316 </p></dd></dl></div></div><div class="section" title="winbind use default domain (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2571477"></a>
     6324</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565532"></a>
    63176325
    63186326winbind use default domain (G)
    6319 </h3></div></div></div><a class="indexterm" name="id2571478"></a><a name="WINBINDUSEDEFAULTDOMAIN"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether the
     6327</h3></div></div></div><a class="indexterm" name="id2565533"></a><a name="WINBINDUSEDEFAULTDOMAIN"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether the
    63206328         <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon should operate on users 
    63216329        without domain component in their username. Users without a domain
    … …  
    63276335</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind use default domain</code></em> = <code class="literal">yes</code>
    63286336</em></span>
    6329 </p></dd></dl></div></div><div class="section" title="wins hook (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2571550"></a>
     6337</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565605"></a>
    63306338
    63316339wins hook (G)
    6332 </h3></div></div></div><a class="indexterm" name="id2571551"></a><a name="WINSHOOK"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba is running as a WINS server this
     6340</h3></div></div></div><a class="indexterm" name="id2565606"></a><a name="WINSHOOK"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba is running as a WINS server this
    63336341        allows you to call an external program for all changes to the
    63346342        WINS database. The primary use for this option is to allow the
    63356343        dynamic update of external name resolution databases such as
    63366344        dynamic DNS.</p><p>The wins hook parameter specifies the name of a script
    6337         or executable that will be called as follows:</p><p><code class="literal">wins_hook operation name nametype ttl IP_list</code></p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>The first argument is the operation and is
     6345        or executable that will be called as follows:</p><p><code class="literal">wins_hook operation name nametype ttl IP_list</code></p><div class="itemizedlist"><ul type="disc"><li><p>The first argument is the operation and is
    63386346                        one  of "add", "delete", or
    63396347                        "refresh". In most cases the operation
    … …  
    63426350                        "refresh" may sometimes be called when
    63436351                        the  name has not previously been added, in that
    6344                         case it should be treated  as an add.</p></li><li class="listitem"><p>The second argument is the NetBIOS name. If the
     6352                        case it should be treated  as an add.</p></li><li><p>The second argument is the NetBIOS name. If the
    63456353                        name is not a legal name then the wins hook is not called.
    63466354                        Legal names contain only  letters, digits, hyphens, underscores
    6347                         and periods.</p></li><li class="listitem"><p>The third argument is the NetBIOS name
    6348                         type as a 2 digit hexadecimal number. </p></li><li class="listitem"><p>The fourth argument is the TTL (time to live)
    6349                         for the name in seconds.</p></li><li class="listitem"><p>The fifth and subsequent arguments are the IP
     6355                        and periods.</p></li><li><p>The third argument is the NetBIOS name
     6356                        type as a 2 digit hexadecimal number. </p></li><li><p>The fourth argument is the TTL (time to live)
     6357                        for the name in seconds.</p></li><li><p>The fifth and subsequent arguments are the IP
    63506358                        addresses currently registered for that name. If this list is
    63516359                        empty then the name should be deleted.</p></li></ul></div><p>An example script that calls the BIND dynamic DNS update
    63526360        program <code class="literal">nsupdate</code> is provided in the examples
    6353         directory of the Samba source code. </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" title="wins proxy (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2571656"></a>
     6361        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="id2565712"></a>
    63546362
    63556363wins proxy (G)
    6356 </h3></div></div></div><a class="indexterm" name="id2571657"></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
     6364</h3></div></div></div><a class="indexterm" name="id2565713"></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
    63576365        queries on behalf of  other hosts. You may need to set this
    63586366        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>
    63596367</em></span>
    6360 </p></dd></dl></div></div><div class="section" title="wins server (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2571711"></a>
     6368</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565766"></a>
    63616369
    63626370wins server (G)
    6363 </h3></div></div></div><a class="indexterm" name="id2571712"></a><a name="WINSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the IP address (or DNS name: IP
     6371</h3></div></div></div><a class="indexterm" name="id2565767"></a><a name="WINSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the IP address (or DNS name: IP
    63646372        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
    63656373        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
    … …  
    63686376        (working) server will be queried for a name. The tag should be
    63696377        separated from the ip address by a colon.
    6370         </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>You need to set up Samba to point
     6378        </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>You need to set up Samba to point
    63716379        to a WINS server if you have multiple subnets and wish cross-subnet
    63726380        browsing to work correctly.</p></div><p>See the chapter in the Samba3-HOWTO on Network Browsing.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>wins server</code></em> = <code class="literal"></code>
    … …  
    63806388</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>
    63816389</em></span>
    6382 </p></dd></dl></div></div><div class="section" title="wins support (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2571821"></a>
     6390</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565877"></a>
    63836391
    63846392wins support (G)
    6385 </h3></div></div></div><a class="indexterm" name="id2571822"></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
     6393</h3></div></div></div><a class="indexterm" name="id2565878"></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
    63866394        not set this to <code class="constant">yes</code> unless you have a multi-subnetted network and
    63876395        you wish a particular <code class="literal">nmbd</code> to be your WINS server.
    … …  
    63896397        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>
    63906398</em></span>
    6391 </p></dd></dl></div></div><div class="section" title="workgroup (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2571891"></a>
     6399</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565946"></a>
    63926400
    63936401workgroup (G)
    6394 </h3></div></div></div><a class="indexterm" name="id2571892"></a><a name="WORKGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what workgroup your server will
     6402</h3></div></div></div><a class="indexterm" name="id2565947"></a><a name="WORKGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what workgroup your server will
    63956403        appear to be in when queried by clients. Note that this parameter
    63966404        also controls the Domain name used with
    … …  
    64006408</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>workgroup</code></em> = <code class="literal">MYGROUP</code>
    64016409</em></span>
    6402 </p></dd></dl></div></div><div class="section" title="writable"><div class="titlepage"><div><div><h3 class="title"><a name="id2571963"></a>
     6410</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566018"></a>
    64036411
    64046412<a name="WRITABLE"></a>writable
    6405 </h3></div></div></div><a class="indexterm" name="id2571964"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#WRITEABLE">writeable</a>.</p></dd></dl></div></div><div class="section" title="writeable (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2571995"></a>
     6413</h3></div></div></div><a class="indexterm" name="id2566020"></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="id2566050"></a>
    64066414
    64076415writeable (S)
    6408 </h3></div></div></div><a class="indexterm" name="id2571996"></a><a name="WRITEABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>Inverted synonym for <a class="link" href="smb.conf.5.html#READONLY" target="_top">read only</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>writeable</code></em> = <code class="literal">no</code>
    6409 </em></span>
    6410 </p></dd></dl></div></div><div class="section" title="write cache size (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2572046"></a>
     6416</h3></div></div></div><a class="indexterm" name="id2566051"></a><a name="WRITEABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>Inverted synonym for <a class="link" href="smb.conf.5.html#READONLY" target="_top">read only</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>writeable</code></em> = <code class="literal">no</code>
     6417</em></span>
     6418</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566101"></a>
    64116419
    64126420write cache size (S)
    6413 </h3></div></div></div><a class="indexterm" name="id2572047"></a><a name="WRITECACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this integer parameter is set to non-zero value,
     6421</h3></div></div></div><a class="indexterm" name="id2566102"></a><a name="WRITECACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this integer parameter is set to non-zero value,
    64146422    Samba will create an in-memory cache for each oplocked file
    64156423    (it does <span class="emphasis"><em>not</em></span> do this for
    … …  
    64296437#  for a 256k cache size per file</code>
    64306438</em></span>
    6431 </p></dd></dl></div></div><div class="section" title="write list (S)"><div class="titlepage"><div><div><h3 class="title"><a name="id2572129"></a>
     6439</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566184"></a>
    64326440
    64336441write list (S)
    6434 </h3></div></div></div><a class="indexterm" name="id2572130"></a><a name="WRITELIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6442</h3></div></div></div><a class="indexterm" name="id2566185"></a><a name="WRITELIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
    64356443    This is a list of users that are given read-write access to a service. If the
    64366444    connecting user is in this list then they will be given write access, no matter
    … …  
    64476455</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>write list</code></em> = <code class="literal">admin, root, @staff</code>
    64486456</em></span>
    6449 </p></dd></dl></div></div><div class="section" title="write raw (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2572223"></a>
     6457</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566278"></a>
    64506458
    64516459write raw (G)
    6452 </h3></div></div></div><a class="indexterm" name="id2572224"></a><a name="WRITERAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
     6460</h3></div></div></div><a class="indexterm" name="id2566279"></a><a name="WRITERAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
    64536461    will support raw write SMB's when transferring data from clients.
    64546462    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>
    64556463</em></span>
    6456 </p></dd></dl></div></div><div class="section" title="wtmp directory (G)"><div class="titlepage"><div><div><h3 class="title"><a name="id2572266"></a>
     6464</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566322"></a>
    64576465
    64586466wtmp directory (G)
    6459 </h3></div></div></div><a class="indexterm" name="id2572268"></a><a name="WTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6467</h3></div></div></div><a class="indexterm" name="id2566323"></a><a name="WTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    64606468        This parameter is only available if Samba has been configured and compiled with the option <code class="literal">
    64616469        --with-utmp</code>. It specifies a directory pathname that is used to store the wtmp or wtmpx files (depending on
    … …  
    64696477</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>wtmp directory</code></em> = <code class="literal">/var/log/wtmp</code>
    64706478</em></span>
    6471 </p></dd></dl></div></div></div></div><div class="refsect1" title="WARNINGS"><a name="id2572350"></a><h2>WARNINGS</h2><p>
     6479</p></dd></dl></div></div></div></div><div class="refsect1" lang="en"><a name="id2566405"></a><h2>WARNINGS</h2><p>
    64726480        Although the configuration file permits service names to contain spaces, your client software may not.
    64736481        Spaces will be ignored in comparisons anyway, so it shouldn't be a problem - but be aware of the possibility.
    … …  
    64826490        care when designing these sections. In particular, ensure that the permissions on spool directories are
    64836491        correct.
    6484         </p></div><div class="refsect1" title="VERSION"><a name="id2572400"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2572411"></a><h2>SEE ALSO</h2><p>
    6485         <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>, <a class="citerefentry" href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a>, <a class="citerefentry" href="swat.8.html"><span class="citerefentry"><span class="refentrytitle">swat</span>(8)</span></a>, <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>, <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>, <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>, <a class="citerefentry" href="nmblookup.1.html"><span class="citerefentry"><span class="refentrytitle">nmblookup</span>(1)</span></a>, <a class="citerefentry" href="testparm.1.html"><span class="citerefentry"><span class="refentrytitle">testparm</span>(1)</span></a>, <a class="citerefentry" href="testprns.1.html"><span class="citerefentry"><span class="refentrytitle">testprns</span>(1)</span></a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id2572490"></a><h2>AUTHOR</h2><p>
     6492        </p></div><div class="refsect1" lang="en"><a name="id2566455"></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="id2566466"></a><h2>SEE ALSO</h2><p>
     6493        <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="id2566546"></a><h2>AUTHOR</h2><p>
    64866494        The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed
    64876495        by the Samba Team as an Open Source project similar to the way the Linux kernel is developed.

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbcacls</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbcacls"><a name="smbcacls.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbcacls &#8212; Set or get ACLs on an NT file or directory names</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbcacls</code> {//server/share} {filename} [-D acls] [-M acls] [-a acls] [-S acls] [-C name] [-G name] [--numeric] [-t] [-U username] [-h] [-d]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2489366"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">smbcacls</code> program manipulates NT Access Control
    2         Lists (ACLs) on SMB file shares. </p></div><div class="refsect1" title="OPTIONS"><a name="id2489516"></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.74.0"></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="id2483383"></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="id2483533"></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" title="ACL FORMAT"><a name="id2487581"></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="id2481601"></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;
    … …  
    7171        access granted to the SID. </p><p>The type can be either ALLOWED or     DENIED to allow/deny access
    7272        to the SID. The flags values are generally zero for file ACLs and
    73         either 9 or 2 for directory ACLs.  Some common flags are: </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="constant">#define SEC_ACE_FLAG_OBJECT_INHERIT         0x1</code></p></li><li class="listitem"><p><code class="constant">#define SEC_ACE_FLAG_CONTAINER_INHERIT        0x2</code></p></li><li class="listitem"><p><code class="constant">#define SEC_ACE_FLAG_NO_PROPAGATE_INHERIT     0x4</code></p></li><li class="listitem"><p><code class="constant">#define SEC_ACE_FLAG_INHERIT_ONLY             0x8</code></p></li></ul></div><p>At present flags can only be specified as decimal or
     73        either 9 or 2 for directory ACLs.  Some common flags are: </p><div class="itemizedlist"><ul type="disc"><li><p><code class="constant">#define SEC_ACE_FLAG_OBJECT_INHERIT       0x1</code></p></li><li><p><code class="constant">#define SEC_ACE_FLAG_CONTAINER_INHERIT         0x2</code></p></li><li><p><code class="constant">#define SEC_ACE_FLAG_NO_PROPAGATE_INHERIT     0x4</code></p></li><li><p><code class="constant">#define SEC_ACE_FLAG_INHERIT_ONLY               0x8</code></p></li></ul></div><p>At present flags can only be specified as decimal or
    7474        hexadecimal values.</p><p>The mask is a value which expresses the access right
    7575        granted to the SID. It can be given as a decimal or hexadecimal value,
    7676        or by using one of the following text strings which map to the NT
    77         file permissions of the same name. </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><span class="emphasis"><em>R</em></span> - Allow read access </p></li><li class="listitem"><p><span class="emphasis"><em>W</em></span> - Allow write access</p></li><li class="listitem"><p><span class="emphasis"><em>X</em></span> - Execute permission on the object</p></li><li class="listitem"><p><span class="emphasis"><em>D</em></span> - Delete the object</p></li><li class="listitem"><p><span class="emphasis"><em>P</em></span> - Change permissions</p></li><li class="listitem"><p><span class="emphasis"><em>O</em></span> - Take ownership</p></li></ul></div><p>The following combined permissions can be specified:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><span class="emphasis"><em>READ</em></span> -  Equivalent to 'RX'
    78                 permissions</p></li><li class="listitem"><p><span class="emphasis"><em>CHANGE</em></span> - Equivalent to 'RXWD' permissions
    79                 </p></li><li class="listitem"><p><span class="emphasis"><em>FULL</em></span> - Equivalent to 'RWXDPO'
    80                 permissions</p></li></ul></div></div><div class="refsect1" title="EXIT STATUS"><a name="id2487745"></a><h2>EXIT STATUS</h2><p>The <code class="literal">smbcacls</code> program sets the exit status
     77        file permissions of the same name. </p><div class="itemizedlist"><ul type="disc"><li><p><span class="emphasis"><em>R</em></span> - Allow read access </p></li><li><p><span class="emphasis"><em>W</em></span> - Allow write access</p></li><li><p><span class="emphasis"><em>X</em></span> - Execute permission on the object</p></li><li><p><span class="emphasis"><em>D</em></span> - Delete the object</p></li><li><p><span class="emphasis"><em>P</em></span> - Change permissions</p></li><li><p><span class="emphasis"><em>O</em></span> - Take ownership</p></li></ul></div><p>The following combined permissions can be specified:</p><div class="itemizedlist"><ul type="disc"><li><p><span class="emphasis"><em>READ</em></span> -  Equivalent to 'RX'
     78                permissions</p></li><li><p><span class="emphasis"><em>CHANGE</em></span> - Equivalent to 'RXWD' permissions
     79                </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="id2481766"></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" title="VERSION"><a name="id2487778"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id2487789"></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="id2481798"></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="id2481809"></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.3.x/docs/htmldocs/manpages/smbclient.1.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbclient</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbclient"><a name="smbclient.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbclient &#8212; ftp-like client to access SMB/CIFS resources
    2         on servers</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbclient</code> [-b &lt;buffer size&gt;] [-d debuglevel] [-e] [-L &lt;netbios name&gt;] [-U username] [-I destinationIP] [-M &lt;netbios name&gt;] [-m maxprotocol] [-A authfile] [-N] [-g] [-i scope] [-O &lt;socket options&gt;] [-p port] [-R &lt;name resolve order&gt;] [-s &lt;smb config file&gt;] [-k] [-P] [-c &lt;command&gt;]</p></div><div class="cmdsynopsis"><p><code class="literal">smbclient</code> {servicename} [password] [-b &lt;buffer size&gt;] [-d debuglevel] [-e] [-D Directory] [-U username] [-W workgroup] [-M &lt;netbios name&gt;] [-m maxprotocol] [-A authfile] [-N] [-g] [-l log-basename] [-I destinationIP] [-E] [-c &lt;command string&gt;] [-i scope] [-O &lt;socket options&gt;] [-p port] [-R &lt;name resolve order&gt;] [-s &lt;smb config file&gt;] [-T&lt;c|x&gt;IXFqgbNan] [-k]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2489739"></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
     1<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.74.0"></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] [-g] [-i scope] [-O &lt;socket options&gt;] [-p port] [-R &lt;name resolve order&gt;] [-s &lt;smb config file&gt;] [-k] [-P] [-c &lt;command&gt;]</p></div><div class="cmdsynopsis"><p><code class="literal">smbclient</code> {servicename} [password] [-b &lt;buffer size&gt;] [-d debuglevel] [-e] [-D Directory] [-U username] [-W workgroup] [-M &lt;netbios name&gt;] [-m maxprotocol] [-A authfile] [-N] [-g] [-l log-basename] [-I destinationIP] [-E] [-c &lt;command string&gt;] [-i scope] [-O &lt;socket options&gt;] [-p port] [-R &lt;name resolve order&gt;] [-s &lt;smb config file&gt;] [-T&lt;c|x&gt;IXFqgbNan] [-k]</p></div></div><div class="refsect1" lang="en"><a name="id2483756"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbclient</code> is a client that can
    33        'talk' to an SMB/CIFS server. It offers an interface
    44        similar to that of the ftp program (see <a class="citerefentry" href="ftp.1.html"><span class="citerefentry"><span class="refentrytitle">ftp</span>(1)</span></a>). 
    … …  
    66        to the local machine, putting files from the local machine to
    77        the server, retrieving directory information from the server
    8         and so on. </p></div><div class="refsect1" title="OPTIONS"><a name="id2489779"></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="id2483795"></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
    … …  
    4141                host names to IP addresses. The option takes a space-separated
    4242                string of different name resolution options.</p><p>The options are :"lmhosts", "host", "wins" and "bcast". They
    43                 cause names to be resolved as follows:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="constant">lmhosts</code>: Lookup an IP
     43                cause names to be resolved as follows:</p><div class="itemizedlist"><ul type="disc"><li><p><code class="constant">lmhosts</code>: Lookup an IP
    4444                        address in the Samba lmhosts file. If the line in lmhosts has
    4545                        no name type attached to the NetBIOS name (see
    4646                        the <a class="citerefentry" href="lmhosts.5.html"><span class="citerefentry"><span class="refentrytitle">lmhosts</span>(5)</span></a> for details) then
    47                         any name type matches for lookup.</p></li><li class="listitem"><p><code class="constant">host</code>: Do a standard host
     47                        any name type matches for lookup.</p></li><li><p><code class="constant">host</code>: Do a standard host
    4848                        name to IP address resolution, using the system <code class="filename">/etc/hosts
    4949                        </code>, NIS, or DNS lookups. This method of name resolution
    … …  
    5252                        file).  Note that this method is only used if the NetBIOS name
    5353                        type being queried is the 0x20 (server) name type, otherwise
    54                         it is ignored.</p></li><li class="listitem"><p><code class="constant">wins</code>: Query a name with
     54                        it is ignored.</p></li><li><p><code class="constant">wins</code>: Query a name with
    5555                        the IP address listed in the <em class="parameter"><code>wins server</code></em>
    5656                        parameter.  If no WINS server has
    57                         been specified this method will be ignored.</p></li><li class="listitem"><p><code class="constant">bcast</code>: Do a broadcast on
     57                        been specified this method will be ignored.</p></li><li><p><code class="constant">bcast</code>: Do a broadcast on
    5858                        each of the known local interfaces listed in the
    5959                        <em class="parameter"><code>interfaces</code></em>
    … …  
    162162Try to authenticate with kerberos. Only useful in
    163163an Active Directory environment.
     164</p></dd><dt><span class="term">-C|--use-ccache</span></dt><dd><p>
     165Try to use the credentials cached by winbind.
    164166</p></dd><dt><span class="term">-A|--authentication-file=filename</span></dt><dd><p>This option allows
    165167you to specify a file from which to read the username and
    … …  
    205207                </code> compatible backups of all the files on an SMB/CIFS
    206208                share. The secondary tar flags that can be given to this option
    207                 are : </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="parameter"><code>c</code></em> - Create a tar file on UNIX.
     209                are : </p><div class="itemizedlist"><ul type="disc"><li><p><em class="parameter"><code>c</code></em> - Create a tar file on UNIX.
    208210                        Must be followed by the name of a tar file, tape device
    209211                        or "-" for standard output. If using standard output you must
    210212                        turn the log level to its lowest value -d0 to avoid corrupting
    211213                        your tar file. This flag is mutually exclusive with the
    212                         <em class="parameter"><code>x</code></em> flag. </p></li><li class="listitem"><p><em class="parameter"><code>x</code></em> - Extract (restore) a local
     214                        <em class="parameter"><code>x</code></em> flag. </p></li><li><p><em class="parameter"><code>x</code></em> - Extract (restore) a local
    213215                        tar file back to a share. Unless the -D option is given, the tar
    214216                        files will be restored from the top level of the share. Must be
    … …  
    217219                        Restored files have their creation times (mtime) set to the
    218220                        date saved in the tar file. Directories currently do not get
    219                         their creation dates restored properly. </p></li><li class="listitem"><p><em class="parameter"><code>I</code></em> - Include files and directories.
     221                        their creation dates restored properly. </p></li><li><p><em class="parameter"><code>I</code></em> - Include files and directories.
    220222                        Is the default behavior when filenames are specified above. Causes
    221223                        files to be included in an extract or create (and therefore
    222224                        everything else to be excluded). See example below.  Filename globbing
    223                         works  in one of two ways.  See <em class="parameter"><code>r</code></em> below. </p></li><li class="listitem"><p><em class="parameter"><code>X</code></em> - Exclude files and directories.
     225                        works  in one of two ways.  See <em class="parameter"><code>r</code></em> below. </p></li><li><p><em class="parameter"><code>X</code></em> - Exclude files and directories.
    224226                        Causes files to be excluded from an extract or create. See
    225227                        example below.  Filename globbing works in one of two ways now.
    226                         See <em class="parameter"><code>r</code></em> below. </p></li><li class="listitem"><p><em class="parameter"><code>F</code></em> - File containing a list of files and directories.
     228                        See <em class="parameter"><code>r</code></em> below. </p></li><li><p><em class="parameter"><code>F</code></em> - File containing a list of files and directories.
    227229                        The <em class="parameter"><code>F</code></em> causes the name following the tarfile to
    228230                        create to be read as a filename that contains a list of files and directories to
    … …  
    230232                        See example below. Filename globbing works in one of two ways.
    231233                        See <em class="parameter"><code>r</code></em> below.
    232                         </p></li><li class="listitem"><p><em class="parameter"><code>b</code></em> - Blocksize. Must be followed
     234                        </p></li><li><p><em class="parameter"><code>b</code></em> - Blocksize. Must be followed
    233235                        by a valid (greater than zero) blocksize.  Causes tar file to be
    234236                        written out in blocksize*TBLOCK (usually 512 byte) blocks.
    235                         </p></li><li class="listitem"><p><em class="parameter"><code>g</code></em> - Incremental. Only back up
     237                        </p></li><li><p><em class="parameter"><code>g</code></em> - Incremental. Only back up
    236238                        files that have the archive bit set. Useful only with the
    237                         <em class="parameter"><code>c</code></em> flag. </p></li><li class="listitem"><p><em class="parameter"><code>q</code></em> - Quiet. Keeps tar from printing
     239                        <em class="parameter"><code>c</code></em> flag. </p></li><li><p><em class="parameter"><code>q</code></em> - Quiet. Keeps tar from printing
    238240                        diagnostics as it works.  This is the same as tarmode quiet.
    239                         </p></li><li class="listitem"><p><em class="parameter"><code>r</code></em> - Regular expression include
     241                        </p></li><li><p><em class="parameter"><code>r</code></em> - Regular expression include
    240242                        or exclude.  Uses regular  expression matching for
    241243                        excluding or excluding files if  compiled with HAVE_REGEX_H.
    242244                        However this mode can be very slow. If  not compiled with
    243245                        HAVE_REGEX_H, does a limited wildcard match on '*' and  '?'.
    244                         </p></li><li class="listitem"><p><em class="parameter"><code>N</code></em> - Newer than. Must be followed
     246                        </p></li><li><p><em class="parameter"><code>N</code></em> - Newer than. Must be followed
    245247                        by the name of a file whose date is compared against files found
    246248                        on the share during a create. Only files newer than the file
    247249                        specified are backed up to the tar file. Useful only with the
    248                         <em class="parameter"><code>c</code></em> flag. </p></li><li class="listitem"><p><em class="parameter"><code>a</code></em> - Set archive bit. Causes the
     250                        <em class="parameter"><code>c</code></em> flag. </p></li><li><p><em class="parameter"><code>a</code></em> - Set archive bit. Causes the
    249251                        archive bit to be reset when a file is backed up. Useful with the
    250252                        <em class="parameter"><code>g</code></em> and <em class="parameter"><code>c</code></em> flags.
    … …  
    271273                commands to be executed instead of prompting from stdin. <em class="parameter"><code>
    272274                -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
    273                 to the server, e.g. <code class="literal">-c 'print -'</code>. </p></dd></dl></div></div><div class="refsect1" title="OPERATIONS"><a name="id2539288"></a><h2>OPERATIONS</h2><p>Once the client is running, the user is presented with
     275                to the server, e.g. <code class="literal">-c 'print -'</code>. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2533317"></a><h2>OPERATIONS</h2><p>Once the client is running, the user is presented with
    274276        a prompt : </p><p><code class="prompt">smb:\&gt; </code></p><p>The backslash ("\\") indicates the current working directory
    275277        on the server, and will change if the current working directory
    … …  
    469471                the given arbitrary number. Without an argument prints out the current
    470472                vuid being used. Used for internal Samba testing purposes.
    471                 </p></dd></dl></div></div><div class="refsect1" title="NOTES"><a name="id2487394"></a><h2>NOTES</h2><p>Some servers are fussy about the case of supplied usernames,
     473                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2534408"></a><h2>NOTES</h2><p>Some servers are fussy about the case of supplied usernames,
    472474        passwords, share names (AKA service names) and machine names.
    473475        If you fail to connect try giving all parameters in uppercase.
    … …  
    476478        on a valid NetBIOS name being used, so you need to supply a valid
    477479        name that would be known to the server.</p><p>smbclient supports long file names where the server
    478         supports the LANMAN2 protocol or above. </p></div><div class="refsect1" title="ENVIRONMENT VARIABLES"><a name="id2487420"></a><h2>ENVIRONMENT VARIABLES</h2><p>The variable <code class="envar">USER</code> may contain the
     480        supports the LANMAN2 protocol or above. </p></div><div class="refsect1" lang="en"><a name="id2534433"></a><h2>ENVIRONMENT VARIABLES</h2><p>The variable <code class="envar">USER</code> may contain the
    479481        username of the person  using the client. This information is
    480482        used only if the protocol  level is high enough to support
    … …  
    486488        to instead of connecting to a server.  This functionality is primarily
    487489        intended as a development aid, and works best when using a LMHOSTS
    488         file</p></div><div class="refsect1" title="INSTALLATION"><a name="id2540580"></a><h2>INSTALLATION</h2><p>The location of the client program is a matter for
     490        file</p></div><div class="refsect1" lang="en"><a name="id2534469"></a><h2>INSTALLATION</h2><p>The location of the client program is a matter for
    489491        individual system administrators. The following are thus
    490492        suggestions only. </p><p>It is recommended that the smbclient software be installed
    … …  
    497499        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
    498500        on a user-accessible port (typically any port number over 1024)
    499         would provide a suitable test server. </p></div><div class="refsect1" title="DIAGNOSTICS"><a name="id2540633"></a><h2>DIAGNOSTICS</h2><p>Most diagnostics issued by the client are logged in a
     501        would provide a suitable test server. </p></div><div class="refsect1" lang="en"><a name="id2534522"></a><h2>DIAGNOSTICS</h2><p>Most diagnostics issued by the client are logged in a
    500502        specified log file. The log file name is specified at compile time,
    501503        but may be overridden on the command line. </p><p>The number and nature of diagnostics available depends
    502504        on the debug level used by the client. If you have problems,
    503         set the debug level to 3 and peruse the log files. </p></div><div class="refsect1" title="VERSION"><a name="id2540652"></a><h2>VERSION</h2><p>This man page is correct for version 3.2 of the Samba suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id2540663"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     505        set the debug level to 3 and peruse the log files. </p></div><div class="refsect1" lang="en"><a name="id2534540"></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="id2534551"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    504506        were created by Andrew Tridgell. Samba is now developed
    505507        by the Samba Team as an Open Source project similar

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbcontrol</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbcontrol"><a name="smbcontrol.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbcontrol &#8212; send messages to smbd, nmbd or winbindd processes</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbcontrol</code> [-i] [-s]</p></div><div class="cmdsynopsis"><p><code class="literal">smbcontrol</code> [destination] [message-type] [parameter]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2489314"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbcontrol</code> is a very small program, which
    2         sends messages to a <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>, a <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>, or a <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon running on the system.</p></div><div class="refsect1" title="OPTIONS"><a name="id2489365"></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.74.0"></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="id2483336"></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="id2483387"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    33</p></dd><dt><span class="term">-s|--configfile &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the
    44configuration details required by the server.  The
    … …  
    2323                to only that process.</p></dd><dt><span class="term">message-type</span></dt><dd><p>Type of message to send. See
    2424                the section <code class="constant">MESSAGE-TYPES</code> for details.
    25                 </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" title="MESSAGE-TYPES"><a name="id2489674"></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
     25                </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="id2483690"></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
    2626        connections to the named share. Note that this doesn't affect client
    2727        connections to any other shares. This message-type takes an argument of the
    … …  
    5858        event has occured.  It doesn't actually cause the
    5959        event to happen.
    60         </p><p>This message can only be sent to <code class="constant">smbd</code>. </p></dd><dt><span class="term">samsync</span></dt><dd><p>Order smbd to synchronise sam database from PDC (being BDC). Can only be sent to <code class="constant">smbd</code>. </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Not working at the moment</p></div></dd><dt><span class="term">samrepl</span></dt><dd><p>Send sam replication message, with specified serial. Can only be sent to <code class="constant">smbd</code>. Should not be used manually.</p></dd><dt><span class="term">dmalloc-mark</span></dt><dd><p>Set a mark for dmalloc. Can be sent to both smbd and nmbd. Only available if samba is built with dmalloc support. </p></dd><dt><span class="term">dmalloc-log-changed</span></dt><dd><p>
     60        </p><p>This message can only be sent to <code class="constant">smbd</code>. </p></dd><dt><span class="term">samsync</span></dt><dd><p>Order smbd to synchronise sam database from PDC (being BDC). Can only be sent to <code class="constant">smbd</code>. </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Not working at the moment</p></div></dd><dt><span class="term">samrepl</span></dt><dd><p>Send sam replication message, with specified serial. Can only be sent to <code class="constant">smbd</code>. Should not be used manually.</p></dd><dt><span class="term">dmalloc-mark</span></dt><dd><p>Set a mark for dmalloc. Can be sent to both smbd and nmbd. Only available if samba is built with dmalloc support. </p></dd><dt><span class="term">dmalloc-log-changed</span></dt><dd><p>
    6161        Dump the pointers that have changed since the mark set by dmalloc-mark.
    6262        Can be sent to both smbd and nmbd. Only available if samba is built with dmalloc support. </p></dd><dt><span class="term">shutdown</span></dt><dd><p>Shut down specified daemon. Can be sent to both smbd and nmbd.</p></dd><dt><span class="term">pool-usage</span></dt><dd><p>Print a human-readable description of all
    … …  
    6666        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
    6767        to <code class="constant">smbd</code>, <code class="constant">nmbd</code>, or <code class="constant">winbindd</code>.
    68         </p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id2487682"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    69         the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2487694"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> and <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id2487718"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     68        </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481702"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     69        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2481714"></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="id2481738"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    7070        were created by Andrew Tridgell. Samba is now developed
    7171        by the Samba Team as an Open Source project similar

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbcquotas</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbcquotas"><a name="smbcquotas.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbcquotas &#8212; Set or get QUOTAs of NTFS 5 shares</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbcquotas</code> {//server/share} [-u user] [-L] [-F] [-S QUOTA_SET_COMMAND] [-n] [-t] [-v] [-d debuglevel] [-s configfile] [-l logdir] [-V] [-U username] [-N] [-k] [-A]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2489517"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">smbcquotas</code> program manipulates NT Quotas on SMB file shares. </p></div><div class="refsect1" title="OPTIONS"><a name="id2489546"></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.74.0"></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="id2483533"></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="id2483561"></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
    … …  
    4141Try to authenticate with kerberos. Only useful in
    4242an Active Directory environment.
     43</p></dd><dt><span class="term">-C|--use-ccache</span></dt><dd><p>
     44Try to use the credentials cached by winbind.
    4345</p></dd><dt><span class="term">-A|--authentication-file=filename</span></dt><dd><p>This option allows
    4446you to specify a file from which to read the username and
    … …  
    6365via the <code class="literal">ps</code> command.  To be safe always allow
    6466<code class="literal">rpcclient</code> to prompt for a password and type
    65 it in directly. </p></dd></dl></div></div><div class="refsect1" title="QUOTA_SET_COMAND"><a name="id2487660"></a><h2>QUOTA_SET_COMAND</h2><p>The format of an the QUOTA_SET_COMMAND is an operation
     67it in directly. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481691"></a><h2>QUOTA_SET_COMAND</h2><p>The format of an the QUOTA_SET_COMMAND is an operation
    6668        name followed by a set of parameters specific to that operation.
    6769        </p><p>To set user quotas for the user specified by -u or for the
    … …  
    7577        </p><p><strong class="userinput"><code>
    7678        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" title="EXIT STATUS"><a name="id2487711"></a><h2>EXIT STATUS</h2><p>The <code class="literal">smbcquotas</code> program sets the exit status
     79        </code></strong></p><p>All limits are specified as a number of bytes.</p></div><div class="refsect1" lang="en"><a name="id2481743"></a><h2>EXIT STATUS</h2><p>The <code class="literal">smbcquotas</code> program sets the exit status
    7880        depending on the success or otherwise of the operations performed.
    7981        The exit status may be one of the following values. </p><p>If the operation succeeded, smbcquotas returns an exit
    … …  
    8183        or when there was an error getting or setting the quota(s), an exit status
    8284        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" title="VERSION"><a name="id2487744"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id2487755"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     85        arguments, an exit status of 2 is returned. </p></div><div class="refsect1" lang="en"><a name="id2481776"></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="id2481787"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    8486        were created by Andrew Tridgell. Samba is now developed
    8587        by the Samba Team as an Open Source project similar

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

    r368 r411  
    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.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbd"><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" title="Synopsis"><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" title="DESCRIPTION"><a name="id2489652"></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.74.0"></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="id2483383"></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" title="OPTIONS"><a name="id2489739"></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="id2483594"></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
    … …  
    4545                server to run "interactively", not as a daemon, even if the
    4646                server is executed on the command line of a shell. Setting this
    47                 parameter negates the implicit deamon mode when run from the
     47                parameter negates the implicit daemon mode when run from the
    4848                command line. <code class="literal">smbd</code> also logs to standard
    4949                output, as if the <code class="literal">-S</code> parameter had been
    … …  
    8383                0 turns off profiling, 1 turns on counter profiling only,
    8484                2 turns on complete profiling, and 3 resets all profiling data.
    85                 </p></dd></dl></div></div><div class="refsect1" title="FILES"><a name="id2487662"></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="id2481680"></a><h2>FILES</h2><div class="variablelist"><dl><dt><span class="term"><code class="filename">/etc/inetd.conf</code></span></dt><dd><p>If the server is to be run by the
    8686                <code class="literal">inetd</code> meta-daemon, this file
    8787                must contain suitable startup information for the
    … …  
    9797                install this file are <code class="filename">/usr/samba/lib/smb.conf</code>
    9898                and <code class="filename">/etc/samba/smb.conf</code>.</p><p>This file describes all the services the server
    99                 is to make available to clients. See <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> for more information.</p></dd></dl></div></div><div class="refsect1" title="LIMITATIONS"><a name="id2487788"></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="id2481806"></a><h2>LIMITATIONS</h2><p>On some systems <code class="literal">smbd</code> cannot change uid back
    100100        to root after a setuid() call.  Such systems are called
    101101        trapdoor uid systems. If you have such a system,
    … …  
    103103        two different users at once. Attempts to connect the
    104104        second user will result in access denied or
    105         similar.</p></div><div class="refsect1" title="ENVIRONMENT VARIABLES"><a name="id2487809"></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="id2481827"></a><h2>ENVIRONMENT VARIABLES</h2><div class="variablelist"><dl><dt><span class="term"><code class="envar">PRINTER</code></span></dt><dd><p>If no printer name is specified to
    106106                printable services, most systems will use the value of
    107107                this variable (or <code class="constant">lp</code> if this variable is
    108108                not defined) as the name of the printer to use. This
    109                 is not specific to the server, however.</p></dd></dl></div></div><div class="refsect1" title="PAM INTERACTION"><a name="id2487838"></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="id2481856"></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
    112112        by the limitations of the SMB protocol and the <a class="link" href="smb.conf.5.html#OBEYPAMRESTRICTIONS" target="_top">obey pam restrictions</a> <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> paramater.  When this is set, the following restrictions apply:
    113         </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><span class="emphasis"><em>Account Validation</em></span>:  All accesses to a
     113        </p><div class="itemizedlist"><ul type="disc"><li><p><span class="emphasis"><em>Account Validation</em></span>:  All accesses to a
    114114        samba server are checked
    115115        against PAM to see if the account is vaild, not disabled and is permitted to
    116116        login at this time.  This also applies to encrypted logins.
    117         </p></li><li class="listitem"><p><span class="emphasis"><em>Session Management</em></span>:  When not using share
     117        </p></li><li><p><span class="emphasis"><em>Session Management</em></span>:  When not using share
    118118        level secuirty, users must pass PAM's session checks before access
    119119        is granted.  Note however, that this is bypassed in share level secuirty. 
    120120        Note also that some older pam configuration files may need a line
    121121        added for session support.
    122         </p></li></ul></div></div><div class="refsect1" title="VERSION"><a name="id2487897"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    123         the Samba suite.</p></div><div class="refsect1" title="DIAGNOSTICS"><a name="id2487908"></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="id2481915"></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="id2481926"></a><h2>DIAGNOSTICS</h2><p>Most diagnostics issued by the server are logged
    124124        in a specified log file. The log file name is specified
    125125        at compile time, but may be overridden on the command line.</p><p>The number and nature of diagnostics available depends
    … …  
    130130        diagnostic. At this stage your best bet is still to grep the
    131131        source code and inspect the conditions that gave rise to the
    132         diagnostics you are seeing.</p></div><div class="refsect1" title="TDB FILES"><a name="id2487936"></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="id2481954"></a><h2>TDB FILES</h2><p>Samba stores it's data in several TDB (Trivial Database) files, usually located in <code class="filename">/var/lib/samba</code>.</p><p>
    133133        (*) information persistent across restarts (but not
    134134        necessarily important to backup).
    135         </p><div class="variablelist"><dl><dt><span class="term">account_policy.tdb*</span></dt><dd><p>NT account policy settings such as pw expiration, etc...</p></dd><dt><span class="term">brlock.tdb</span></dt><dd><p>byte range locks</p></dd><dt><span class="term">browse.dat</span></dt><dd><p>browse lists</p></dd><dt><span class="term">connections.tdb</span></dt><dd><p>share connections (used to enforce max connections, etc...)</p></dd><dt><span class="term">gencache.tdb</span></dt><dd><p>generic caching db</p></dd><dt><span class="term">group_mapping.tdb*</span></dt><dd><p>group mapping information</p></dd><dt><span class="term">locking.tdb</span></dt><dd><p>share modes &amp; oplocks</p></dd><dt><span class="term">login_cache.tdb*</span></dt><dd><p>bad pw attempts</p></dd><dt><span class="term">messages.tdb</span></dt><dd><p>Samba messaging system</p></dd><dt><span class="term">netsamlogon_cache.tdb*</span></dt><dd><p>cache of user net_info_3 struct from net_samlogon() request (as a domain member)</p></dd><dt><span class="term">ntdrivers.tdb*</span></dt><dd><p>installed printer drivers</p></dd><dt><span class="term">ntforms.tdb*</span></dt><dd><p>installed printer forms</p></dd><dt><span class="term">ntprinters.tdb*</span></dt><dd><p>installed printer information</p></dd><dt><span class="term">printing/</span></dt><dd><p>directory containing tdb per print queue of cached lpq output</p></dd><dt><span class="term">registry.tdb</span></dt><dd><p>Windows registry skeleton (connect via regedit.exe)</p></dd><dt><span class="term">sessionid.tdb</span></dt><dd><p>session information (e.g. support for 'utmp = yes')</p></dd><dt><span class="term">share_info.tdb*</span></dt><dd><p>share acls</p></dd><dt><span class="term">winbindd_cache.tdb</span></dt><dd><p>winbindd's cache of user lists, etc...</p></dd><dt><span class="term">winbindd_idmap.tdb*</span></dt><dd><p>winbindd's local idmap db</p></dd><dt><span class="term">wins.dat*</span></dt><dd><p>wins database when 'wins support = yes'</p></dd></dl></div></div><div class="refsect1" title="SIGNALS"><a name="id2538635"></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="id2532649"></a><h2>SIGNALS</h2><p>Sending the <code class="literal">smbd</code> a SIGHUP will cause it to
    136136        reload its <code class="filename">smb.conf</code> configuration
    137137        file within a short period of time.</p><p>To shut down a user's <code class="literal">smbd</code> process it is recommended
    … …  
    148148        issuing them. It is possible to make the signal handlers safe
    149149        by un-blocking the signals before the select call and re-blocking
    150         them after, however this would affect performance.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2538722"></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="id2532737"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="hosts_access.5.html"><span class="citerefentry"><span class="refentrytitle">hosts_access</span>(5)</span></a>, <a class="citerefentry" href="inetd.8.html"><span class="citerefentry"><span class="refentrytitle">inetd</span>(8)</span></a>, <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>, <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>, <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>, <a class="citerefentry" href="testparm.1.html"><span class="citerefentry"><span class="refentrytitle">testparm</span>(1)</span></a>, <a class="citerefentry" href="testprns.1.html"><span class="citerefentry"><span class="refentrytitle">testprns</span>(1)</span></a>, and the
    151151        Internet RFC's  <code class="filename">rfc1001.txt</code>, <code class="filename">rfc1002.txt</code>.
    152152        In addition the CIFS (formerly SMB) specification is available
    153153        as a link from the Web page <a class="ulink" href="http://samba.org/cifs/" target="_top">
    154         http://samba.org/cifs/</a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id2538803"></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="id2532817"></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.3.x/docs/htmldocs/manpages/smbget.1.html

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

    r368 r411  
    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.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbgetrc"><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" title="Synopsis"><h2>Synopsis</h2><p><code class="filename">smbgetrc</code></p></div><div class="refsect1" title="DESCRIPTION"><a name="id2528893"></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.74.0"></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="id2522912"></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" title="OPTIONS"><a name="id2528926"></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="id2522945"></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" title="VERSION"><a name="id2489541"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    13         the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2489552"></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" title="AUTHOR"><a name="id2489576"></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="id2483557"></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="id2483568"></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="id2483593"></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.3.x/docs/htmldocs/manpages/smbpasswd.5.html

    r368 r411  
    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.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbpasswd"><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" title="Synopsis"><h2>Synopsis</h2><p><code class="filename">smbpasswd</code></p></div><div class="refsect1" title="DESCRIPTION"><a name="id2528893"></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.74.0"></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="id2522912"></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" title="FILE FORMAT"><a name="id2528920"></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="id2522939"></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
    … …  
    5959                (including the '[' and ']' characters).
    6060                The contents of this field may be any of the following characters:
    61                 </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><span class="emphasis"><em>U</em></span> - This means
    62                         this is a "User" account, i.e. an ordinary user.</p></li><li class="listitem"><p><span class="emphasis"><em>N</em></span> - This means the
     61                </p><div class="itemizedlist"><ul type="disc"><li><p><span class="emphasis"><em>U</em></span> - This means
     62                        this is a "User" account, i.e. an ordinary user.</p></li><li><p><span class="emphasis"><em>N</em></span> - This means the
    6363                        account has no password (the passwords in the fields LANMAN
    6464                        Password Hash and NT Password Hash are ignored). Note that this
    6565                        will only allow users to log on with no password if the <em class="parameter"><code>
    6666                        null passwords</code></em> parameter is set in the
    67                         <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> config file. </p></li><li class="listitem"><p><span class="emphasis"><em>D</em></span> - This means the account
    68                         is disabled and no SMB/CIFS logins  will be allowed for this user. </p></li><li class="listitem"><p><span class="emphasis"><em>X</em></span> - This means the password
    69                         does not expire. </p></li><li class="listitem"><p><span class="emphasis"><em>W</em></span> - This means this account
     67                        <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> config file. </p></li><li><p><span class="emphasis"><em>D</em></span> - This means the account
     68                        is disabled and no SMB/CIFS logins  will be allowed for this user. </p></li><li><p><span class="emphasis"><em>X</em></span> - This means the password
     69                        does not expire. </p></li><li><p><span class="emphasis"><em>W</em></span> - This means this account
    7070                        is a "Workstation Trust" account. This kind of account is used
    7171                        in the Samba PDC code stream to allow Windows NT Workstations
    … …  
    7777                "Last Change Time") followed by a numeric encoding of the UNIX time
    7878                in seconds since the epoch (1970) that the last change was made.
    79                 </p></dd></dl></div><p>All other colon separated fields are ignored at this time.</p></div><div class="refsect1" title="VERSION"><a name="id2489674"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    80         the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2489685"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a>, <a class="citerefentry" href="Samba.7.html"><span class="citerefentry"><span class="refentrytitle">Samba</span>(7)</span></a>, and
     79                </p></dd></dl></div><p>All other colon separated fields are ignored at this time.</p></div><div class="refsect1" lang="en"><a name="id2483689"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     80        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2483700"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a>, <a class="citerefentry" href="Samba.7.html"><span class="citerefentry"><span class="refentrytitle">Samba</span>(7)</span></a>, and
    8181        the Internet RFC1321 for details on the MD4 algorithm.
    82         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489711"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     82        </p></div><div class="refsect1" lang="en"><a name="id2483726"></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.3.x/docs/htmldocs/manpages/smbpasswd.8.html

    r368 r411  
    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.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbpasswd"><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" title="Synopsis"><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" title="DESCRIPTION"><a name="id2489528"></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.74.0"></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="id2483543"></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" title="OPTIONS"><a name="id2489650"></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="id2483665"></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
    … …  
    9393                what name resolution services to use when looking up the NetBIOS
    9494                name of the host being connected to. </p><p>The options are :"lmhosts", "host", "wins" and "bcast". They
    95                  cause names to be resolved as follows: </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="constant">lmhosts</code>: Lookup an IP
     95                 cause names to be resolved as follows: </p><div class="itemizedlist"><ul type="disc"><li><p><code class="constant">lmhosts</code>: Lookup an IP
    9696            address in the Samba lmhosts file. If the line in lmhosts has
    9797            no name type attached to the NetBIOS name (see the <a class="citerefentry" href="lmhosts.5.html"><span class="citerefentry"><span class="refentrytitle">lmhosts</span>(5)</span></a> for details) then
    98             any name type matches for lookup.</p></li><li class="listitem"><p><code class="constant">host</code>: Do a standard host
     98            any name type matches for lookup.</p></li><li><p><code class="constant">host</code>: Do a standard host
    9999            name to IP address resolution, using the system <code class="filename">/etc/hosts
    100100            </code>, NIS, or DNS lookups. This method of name resolution
    … …  
    103103            file).  Note that this method is only used if the NetBIOS name
    104104            type being queried is the 0x20 (server) name type, otherwise
    105             it is ignored.</p></li><li class="listitem"><p><code class="constant">wins</code>: Query a name with
     105            it is ignored.</p></li><li><p><code class="constant">wins</code>: Query a name with
    106106            the IP address listed in the <em class="parameter"><code>wins server</code></em>
    107107            parameter.  If no WINS server has been specified this method
    108             will be ignored.</p></li><li class="listitem"><p><code class="constant">bcast</code>: Do a broadcast on
     108            will be ignored.</p></li><li><p><code class="constant">bcast</code>: Do a broadcast on
    109109            each of the known local interfaces listed in the
    110110            <em class="parameter"><code>interfaces</code></em> parameter. This is the least
    … …  
    152152                can specify this parameter as only root has the permission needed
    153153                to modify attributes directly in the local smbpasswd file.
    154                 </p></dd></dl></div></div><div class="refsect1" title="NOTES"><a name="id2538538"></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="id2532556"></a><h2>NOTES</h2><p>Since <code class="literal">smbpasswd</code> works in client-server
    155155        mode communicating  with a local smbd for a non-root user then
    156156        the smbd daemon must be running for this to work. A common problem
    … …  
    160160        the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file and neglecting to
    161161        allow "localhost" access to the smbd. </p><p>In addition, the smbpasswd command is only useful if Samba
    162         has been set up to use encrypted passwords. </p></div><div class="refsect1" title="VERSION"><a name="id2538587"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2538597"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbpasswd.5.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(5)</span></a>, <a class="citerefentry" href="Samba.7.html"><span class="citerefentry"><span class="refentrytitle">Samba</span>(7)</span></a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id2538621"></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="id2532604"></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="id2532615"></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="id2532638"></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.3.x/docs/htmldocs/manpages/smbspool.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbspool</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbspool"><a name="smbspool.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbspool &#8212; send a print file to an SMB printer</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbspool</code> {job} {user} {title} {copies} {options} [filename]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2489310"></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.74.0"></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="id2483327"></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
    … …  
    55        or from a program or script.</p><p><span class="emphasis"><em>DEVICE URI</em></span></p><p>smbspool specifies the destination using a Uniform Resource
    66        Identifier ("URI") with a method of "smb". This string can take
    7         a number of forms:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>smb://server[:port]/printer</p></li><li class="listitem"><p>smb://workgroup/server[:port]/printer</p></li><li class="listitem"><p>smb://username:password@server[:port]/printer</p></li><li class="listitem"><p>smb://username:password@workgroup/server[:port]/printer</p></li></ul></div><p>smbspool tries to get the URI from the environment variable
     7        a number of forms:</p><div class="itemizedlist"><ul type="disc"><li><p>smb://server[:port]/printer</p></li><li><p>smb://workgroup/server[:port]/printer</p></li><li><p>smb://username:password@server[:port]/printer</p></li><li><p>smb://username:password@workgroup/server[:port]/printer</p></li></ul></div><p>smbspool tries to get the URI from the environment variable
    88        <code class="envar">DEVICE_URI</code>. If <code class="envar">DEVICE_URI</code> is not present,
    9         smbspool will use argv[0] if that starts with <span class="quote">&#8220;<span class="quote">smb://</span>&#8221;</span>
     9        smbspool will use argv[0] if that starts with &#8220;<span class="quote">smb://</span>&#8221;
    1010        or argv[1] if that is not the case.</p><p>Programs using the <code class="literal">exec(2)</code> functions can
    1111        pass the URI in argv[0], while shell scripts must set the
    1212        <code class="envar">DEVICE_URI</code> environment variable prior to
    13         running smbspool.</p></div><div class="refsect1" title="OPTIONS"><a name="id2489524"></a><h2>OPTIONS</h2><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>The job argument (argv[1]) contains the
     13        running smbspool.</p></div><div class="refsect1" lang="en"><a name="id2483540"></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.
    15                 </p></li><li class="listitem"><p>The user argument (argv[2]) contains the
     15                </p></li><li><p>The user argument (argv[2]) contains the
    1616                print user's name and is presently not used by smbspool.
    17                 </p></li><li class="listitem"><p>The title argument (argv[3]) contains the
     17                </p></li><li><p>The title argument (argv[3]) contains the
    1818                job title string and is passed as the remote file name
    19                 when sending the print job.</p></li><li class="listitem"><p>The copies argument (argv[4]) contains
     19                when sending the print job.</p></li><li><p>The copies argument (argv[4]) contains
    2020                the number of copies to be printed of the named file. If
    2121                no filename is provided then this argument is not used by
    22                 smbspool.</p></li><li class="listitem"><p>The options argument (argv[5]) contains
     22                smbspool.</p></li><li><p>The options argument (argv[5]) contains
    2323                the print options in a single string and is currently
    24                 not used by smbspool.</p></li><li class="listitem"><p>The filename argument (argv[6]) contains the
     24                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" title="VERSION"><a name="id2489574"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2489585"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> and <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id2489610"></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="id2483591"></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="id2483602"></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="id2483626"></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.3.x/docs/htmldocs/manpages/smbstatus.1.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbstatus</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbstatus"><a name="smbstatus.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbstatus &#8212; report on current Samba connections</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbstatus</code> [-P] [-b] [-d &lt;debug level&gt;] [-v] [-L] [-B] [-p] [-S] [-s &lt;configuration file&gt;] [-u &lt;username&gt;]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2489344"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbstatus</code> is a very simple program to
    2         list the current Samba connections.</p></div><div class="refsect1" title="OPTIONS"><a name="id2489371"></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.74.0"></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="id2483361"></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="id2483388"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-P|--profile</span></dt><dd><p>If samba has been compiled with the
    33                profiling option, print only the contents of the profiling
    44                shared memory area.</p></dd><dt><span class="term">-b|--brief</span></dt><dd><p>gives brief output.</p></dd><dt><span class="term">-d|--debuglevel=level</span></dt><dd><p><em class="replaceable"><code>level</code></em> is an integer
    … …  
    2929                </p></dd><dt><span class="term">-p|--processes</span></dt><dd><p>print a list of <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> processes and exit.
    3030                Useful for scripting.</p></dd><dt><span class="term">-S|--shares</span></dt><dd><p>causes smbstatus to only list shares.</p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    31 </p></dd><dt><span class="term">-u|--user=&lt;username&gt;</span></dt><dd><p>selects information relevant to <em class="parameter"><code>username</code></em> only.</p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id2487503"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    32         the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2487514"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> and <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>.</p></div><div class="refsect1" title="AUTHOR"><a name="id2487539"></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="id2481524"></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="id2481535"></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="id2481560"></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.3.x/docs/htmldocs/manpages/smbtar.1.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbtar</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbtar"><a name="smbtar.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbtar &#8212; shell script for backing up SMB/CIFS shares
    2         directly to UNIX tape drives</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbtar</code> [-r] [-i] [-a] [-v] {-s server} [-p password] [-x services] [-X] [-N filename] [-b blocksize] [-d directory] [-l loglevel] [-u user] [-t tape] {filenames}</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2489665"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbtar</code> is a very small shell script on top
    3         of <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a> which dumps SMB shares directly to tape.</p></div><div class="refsect1" title="OPTIONS"><a name="id2489699"></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
     1<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.74.0"></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="id2483521"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbtar</code> is a very small shell script on top
     3        of <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a> which dumps SMB shares directly to tape.</p></div><div class="refsect1" lang="en"><a name="id2483555"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-s server</span></dt><dd><p>The SMB/CIFS server that the share resides
    44                upon.</p></dd><dt><span class="term">-x service</span></dt><dd><p>The share name on the server to connect to.
    55                The default is "backup".</p></dd><dt><span class="term">-X</span></dt><dd><p>Exclude mode. Exclude filenames... from tar
    … …  
    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" title="ENVIRONMENT VARIABLES"><a name="id2489918"></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="id2483774"></a><h2>ENVIRONMENT VARIABLES</h2><p>The <em class="parameter"><code>$TAPE</code></em> variable specifies the
    2121        default tape device to write to. May be overridden
    22         with the -t option. </p></div><div class="refsect1" title="BUGS"><a name="id2489936"></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" title="CAVEATS"><a name="id2487461"></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="id2483791"></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="id2481478"></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" title="DIAGNOSTICS"><a name="id2487475"></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" title="VERSION"><a name="id2487498"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    27         the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2487510"></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" title="AUTHOR"><a name="id2487544"></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="id2481492"></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="id2481516"></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="id2481527"></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="id2481561"></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.3.x/docs/htmldocs/manpages/smbtree.1.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbtree</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbtree"><a name="smbtree.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbtree &#8212; A text based smb network browser
    2         </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbtree</code> [-b] [-D] [-S]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528919"></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
     1<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.74.0"></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="id2522938"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbtree</code> is a smb browser program
    33        in text mode. It is similar to the "Network Neighborhood" found
    44        on Windows computers. It prints a tree with all
    55        the known domains, the servers in those domains and
    66        the shares on the servers.
    7         </p></div><div class="refsect1" title="OPTIONS"><a name="id2489317"></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="id2483334"></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
    … …  
    4545Try to authenticate with kerberos. Only useful in
    4646an Active Directory environment.
     47</p></dd><dt><span class="term">-C|--use-ccache</span></dt><dd><p>
     48Try to use the credentials cached by winbind.
    4749</p></dd><dt><span class="term">-A|--authentication-file=filename</span></dt><dd><p>This option allows
    4850you to specify a file from which to read the username and
    … …  
    6870<code class="literal">rpcclient</code> to prompt for a password and type
    6971it 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" title="VERSION"><a name="id2487500"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
    71         suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id2487511"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     72</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481533"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
     73        suite.</p></div><div class="refsect1" lang="en"><a name="id2481544"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    7274        were created by Andrew Tridgell. Samba is now developed
    7375        by the Samba Team as an Open Source project similar

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>swat</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="swat"><a name="swat.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>swat &#8212; Samba Web Administration Tool</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">swat</code> [-s &lt;smb config file&gt;] [-a] [-P]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528884"></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.74.0"></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="id2522936"></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" title="OPTIONS"><a name="id2489635"></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="id2483366"></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" title="INSTALLATION"><a name="id2487458"></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="id2481475"></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 class="itemizedlist" type="disc"><li class="listitem"><p>/usr/local/samba/sbin/swat</p></li><li class="listitem"><p>/usr/local/samba/swat/images/*</p></li><li class="listitem"><p>/usr/local/samba/swat/help/*</p></li></ul></div><div class="refsect2" title="Inetd Installation"><a name="id2487504"></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="id2481522"></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" title="LAUNCHING"><a name="id2487616"></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="id2481634"></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" title="FILES"><a name="id2487635"></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="id2481652"></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" title="WARNINGS"><a name="id2487716"></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="id2481733"></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" title="VERSION"><a name="id2487760"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2487770"></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" title="AUTHOR"><a name="id2487801"></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="id2481777"></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="id2481788"></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="id2481818"></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.3.x/docs/htmldocs/manpages/tdbbackup.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>tdbbackup</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="tdbbackup"><a name="tdbbackup.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>tdbbackup &#8212; tool for backing up and for validating the integrity of samba .tdb files</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">tdbbackup</code> [-s suffix] [-v] [-h]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528921"></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.74.0"></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="id2522939"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.1.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(1)</span></a> suite.</p><p><code class="literal">tdbbackup</code> is a tool that may be used to backup samba .tdb
    22        files. This tool may also be used to verify the integrity of the .tdb files prior
    33        to samba startup or during normal operation. If it finds file damage and it finds
    44        a prior backup the backup file will be restored.
    5         </p></div><div class="refsect1" title="OPTIONS"><a name="id2489320"></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="id2483336"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h</span></dt><dd><p>
    66                Get help information.
    77                </p></dd><dt><span class="term">-s suffix</span></dt><dd><p>
    … …  
    1212                The <code class="literal">-v</code> will check the database for damages (currupt data)
    1313                which if detected causes the backup to be restored.
    14                 </p></dd></dl></div></div><div class="refsect1" title="COMMANDS"><a name="id2489503"></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="id2483396"></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
    … …  
    2121        Samba .tdb files are stored in various locations, be sure to run backup all
    2222        .tdb file on the system. Important files includes:
    23         </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     23        </p><div class="itemizedlist"><ul type="disc"><li><p>
    2424                <code class="literal">secrets.tdb</code> - usual location is in the /usr/local/samba/private
    2525                directory, or on some systems in /etc/samba.
    26                 </p></li><li class="listitem"><p>
     26                </p></li><li><p>
    2727                <code class="literal">passdb.tdb</code> - usual location is in the /usr/local/samba/private
    2828                directory, or on some systems in /etc/samba.
    29                 </p></li><li class="listitem"><p>
     29                </p></li><li><p>
    3030                <code class="literal">*.tdb</code> located in the /usr/local/samba/var directory or on some
    3131                systems in the /var/cache or /var/lib/samba directories.
    32                 </p></li></ul></div></div><div class="refsect1" title="VERSION"><a name="id2489583"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id2489594"></a><h2>AUTHOR</h2><p>
     32                </p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2483598"></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="id2483609"></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.3.x/docs/htmldocs/manpages/tdbdump.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>tdbdump</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="tdbdump"><a name="tdbdump.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>tdbdump &#8212; tool for printing the contents of a TDB file</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">tdbdump</code> {filename}</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528905"></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.74.0"></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="id2522923"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.1.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(1)</span></a> suite.</p><p><code class="literal">tdbdump</code> is a very simple utility that 'dumps' the
    22                contents of a TDB (Trivial DataBase) file to standard output in a
    33                human-readable format.
    44        </p><p>This tool can be used when debugging problems with TDB files. It is
    55                intended for those who are somewhat familiar with Samba internals.
    6         </p></div><div class="refsect1" title="VERSION"><a name="id2489308"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id2489318"></a><h2>AUTHOR</h2><p>
     6        </p></div><div class="refsect1" lang="en"><a name="id2483324"></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="id2483334"></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.3.x/docs/htmldocs/manpages/tdbtool.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>tdbtool</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="tdbtool"><a name="tdbtool.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>tdbtool &#8212; manipulate the contents TDB files</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">tdbtool</code></p></div><div class="cmdsynopsis"><p><code class="literal">tdbtool</code> 
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>tdbtool</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="tdbtool.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>tdbtool &#8212; manipulate the contents TDB files</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">tdbtool</code></p></div><div class="cmdsynopsis"><p><code class="literal">tdbtool</code> 
    22                <em class="replaceable"><code>TDBFILE</code></em>
    33                  [
    44                <em class="replaceable"><code>COMMANDS</code></em>
    5                 ...]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528930"></a><h2>DESCRIPTION</h2><p>This tool is part of the
     5                ...]</p></div></div><div class="refsect1" lang="en"><a name="id2522948"></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" title="COMMANDS"><a name="id2489327"></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="id2483343"></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>.
    … …  
    6060                <code class="option">quit</code>
    6161                </span></dt><dd><p>Exit <code class="literal">tdbtool</code>.
    62                 </p></dd></dl></div></div><div class="refsect1" title="CAVEATS"><a name="id2487452"></a><h2>CAVEATS</h2><p>The contents of the Samba TDB files are private
     62                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481471"></a><h2>CAVEATS</h2><p>The contents of the Samba TDB files are private
    6363        to the implementation and should not be altered with
    6464        <code class="literal">tdbtool</code>.
    65         </p></div><div class="refsect1" title="VERSION"><a name="id2487469"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id2487480"></a><h2>AUTHOR</h2><p> The original Samba software and related utilities were
     65        </p></div><div class="refsect1" lang="en"><a name="id2481488"></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="id2481500"></a><h2>AUTHOR</h2><p> The original Samba software and related utilities were
    6666        created by Andrew Tridgell.  Samba is now developed by the
    6767        Samba Team as an Open Source project similar to the way the

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>testparm</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="testparm"><a name="testparm.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>testparm &#8212; check an smb.conf configuration file for
    2         internal correctness</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">testparm</code> [-s] [-h] [-v] [-L &lt;servername&gt;] [-t &lt;encoding&gt;] {config filename} [hostname hostIP]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2489321"></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
     1<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.74.0"></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="id2483338"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">testparm</code> is a very simple test program
    33        to check an <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> configuration file for
    44        internal correctness. If this program reports no problems, you
    … …  
    1212        smb.conf</code> file it returns an exit code of 1 to the calling
    1313        program, else it returns an exit code of 0. This allows shell scripts
    14         to test the output from <code class="literal">testparm</code>.</p></div><div class="refsect1" title="OPTIONS"><a name="id2489528"></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="id2483545"></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.
    … …  
    4242                be supplied.</p></dd><dt><span class="term">hostIP</span></dt><dd><p>This is the IP address of the host specified
    4343                in the previous parameter.  This address must be supplied
    44                 if the hostname parameter is supplied. </p></dd></dl></div></div><div class="refsect1" title="FILES"><a name="id2489738"></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
     44                if the hostname parameter is supplied. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483755"></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" title="DIAGNOSTICS"><a name="id2489773"></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="id2483790"></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" title="VERSION"><a name="id2487456"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    51         the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2487467"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>, <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a></p></div><div class="refsect1" title="AUTHOR"><a name="id2487493"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     50        to stdout. </p></div><div class="refsect1" lang="en"><a name="id2481477"></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="id2481488"></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="id2481513"></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.3.x/docs/htmldocs/manpages/umount.cifs.8.html

    r368 r411  
    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.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="umount.cifs"><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" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">umount.cifs</code> {mount-point} [-nVvhfle]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528921"></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.74.0"></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="id2522933"></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" title="OPTIONS"><a name="id2489342"></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" title="NOTES"><a name="id2489377"></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" title="CONFIGURATION"><a name="id2489523"></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="id2483365"></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="id2483524"></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="id2483539"></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" title="BUGS"><a name="id2489551"></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="id2483566"></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" title="VERSION"><a name="id2489584"></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" title="SEE ALSO"><a name="id2489596"></a><h2>SEE ALSO</h2><p>
     27</p></div><div class="refsect1" lang="en"><a name="id2483600"></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="id2483612"></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" title="AUTHOR"><a name="id2489617"></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="id2483633"></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.3.x/docs/htmldocs/manpages/vfs_acl_tdb.8.html

    r374 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_acl_tdb</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_acl_tdb"><a name="vfs_acl_tdb.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_acl_tdb &#8212; Save NTFS-ACLs in a tdb file</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = acl_tdb</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528903"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_acl_tdb</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="vfs_acl_tdb.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_acl_tdb &#8212; Save NTFS-ACLs in a tdb file</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = acl_tdb</code></p></div></div><div class="refsect1" lang="en"><a name="id2522915"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_acl_tdb</code> VFS module stores
    33        NTFS Access Control Lists (ACLs) in a tdb file.
    … …  
    99        </p><p>Please note that this module is
    1010        <span class="emphasis"><em>experimental</em></span>!
    11         </p><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id2489310"></a><h2>OPTIONS</h2><p>
     11        </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2483333"></a><h2>OPTIONS</h2><p>
    1212        There are no options for <code class="literal">vfs_acl_tdb</code>.
    13         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489326"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     13        </p></div><div class="refsect1" lang="en"><a name="id2483348"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    1414        were created by Andrew Tridgell. Samba is now developed
    1515        by the Samba Team as an Open Source project similar

  • branches/samba-3.3.x/docs/htmldocs/manpages/vfs_acl_xattr.8.html

    r374 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_acl_xattr</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_acl_xattr"><a name="vfs_acl_xattr.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_acl_xattr &#8212; Save NTFS-ACLs in Extended Attributes (EAs)</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = acl_xattr</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528903"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_acl_xattr</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="vfs_acl_xattr.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_acl_xattr &#8212; Save NTFS-ACLs in Extended Attributes (EAs)</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = acl_xattr</code></p></div></div><div class="refsect1" lang="en"><a name="id2522914"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_acl_xattr</code> VFS module stores
    33        NTFS Access Control Lists (ACLs) in Extended Attributes (EAs).
    … …  
    1313        </p><p>Please note that this module is
    1414        <span class="emphasis"><em>experimental</em></span>!
    15         </p><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id2489340"></a><h2>OPTIONS</h2><p>
     15        </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2483362"></a><h2>OPTIONS</h2><p>
    1616        There are no options for <code class="literal">vfs_acl_xattr</code>.
    17         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489355"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     17        </p></div><div class="refsect1" lang="en"><a name="id2483378"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    1818        were created by Andrew Tridgell. Samba is now developed
    1919        by the Samba Team as an Open Source project similar

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_audit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_audit"><a name="vfs_audit.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_audit &#8212; record selected Samba VFS operations in the system log</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = audit</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528897"></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.74.0"></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="id2522916"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_audit</code> VFS module records selected
    33        client operations to the system log using
    4         <a class="citerefentry" href="syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>.</p><p>The following Samba VFS operations are recorded:</p><table border="0" summary="Simple list" class="simplelist"><tr><td>connect</td></tr><tr><td>disconnect</td></tr><tr><td>opendir</td></tr><tr><td>mkdir</td></tr><tr><td>rmdir</td></tr><tr><td>open</td></tr><tr><td>close</td></tr><tr><td>rename</td></tr><tr><td>unlink</td></tr><tr><td>chmod</td></tr><tr><td>fchmod</td></tr><tr><td>chmod_acl</td></tr><tr><td>fchmod_acl</td></tr></table><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id2489359"></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="id2483375"></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" title="EXAMPLES"><a name="id2489533"></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="id2483550"></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>
    … …  
    1313        <a class="link" href="smb.conf.5.html#AUDIT:FACILITY" target="_top">audit:facility = LOCAL1</a>
    1414        <a class="link" href="smb.conf.5.html#AUDIT:PRIORITY" target="_top">audit:priority = NOTICE</a>
    15 </pre></div><div class="refsect1" title="VERSION"><a name="id2489690"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    16         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489700"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     15</pre></div><div class="refsect1" lang="en"><a name="id2483705"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
     16        </p></div><div class="refsect1" lang="en"><a name="id2483716"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    1717        were created by Andrew Tridgell. Samba is now developed
    1818        by the Samba Team as an Open Source project similar

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_cacheprime</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_cacheprime"><a name="vfs_cacheprime.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_cacheprime &#8212; prime the kernel file data cache</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = cacheprime</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528903"></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.74.0"></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="id2522914"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_cacheprime</code> VFS module reads chunks
    33        of file data near the range requested by clients in order to
    … …  
    88        on boundaries that are a multiple of this size. Each range of
    99        the file data is primed at most once during the time the client
    10         has the file open. </p><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id2489313"></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 class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">K</code> - BYTES is a number of kilobytes</p></li><li class="listitem"><p><code class="literal">M</code> - BYTES is a number of megabytes</p></li><li class="listitem"><p><code class="literal">G</code> - BYTES is a number of gigabytes</p></li></ul></div></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id2489371"></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="id2483334"></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="id2483392"></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" target="_top">vfs objects = cacheprime</a>
    1717        <a class="link" href="smb.conf.5.html#CACHEPRIME:RSIZE" target="_top">cacheprime:rsize = 1M</a>
    18 </pre></div><div class="refsect1" title="CAVEATS"><a name="id2489645"></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="id2483662"></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" title="VERSION"><a name="id2489663"></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" title="AUTHOR"><a name="id2489674"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     22        </p></div><div class="refsect1" lang="en"><a name="id2483680"></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="id2483691"></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.3.x/docs/htmldocs/manpages/vfs_cap.8.html

    r368 r411  
    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.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_cap"><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" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = cap</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528896"></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.74.0"></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="id2522915"></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" title="EXAMPLES"><a name="id2528935"></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="id2522953"></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>
    … …  
    1111        <a class="link" href="smb.conf.5.html#DOSCHARSET" target="_top">dos charset = CP932</a>
    1212        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = cap</a>
    13 </pre></div><div class="refsect1" title="VERSION"><a name="id2489356"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    14         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489367"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     13</pre></div><div class="refsect1" lang="en"><a name="id2483372"></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="id2483383"></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.3.x/docs/htmldocs/manpages/vfs_catia.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_catia</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_catia"><a name="vfs_catia.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_catia &#8212; translate illegal characters in Catia filenames</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = catia</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528897"></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.74.0"></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="id2522915"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The Catia CAD package commonly creates filenames that
    33        use characters that are illegal in CIFS filenames. The
    44        <code class="literal">vfs_catia</code> VFS module implements a fixed character
    55        mapping so that these files can be shared with CIFS clients.
    6         </p><p>This module is stackable.</p></div><div class="refsect1" title="EXAMPLES"><a name="id2528931"></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="id2522949"></a><h2>EXAMPLES</h2><p>Map Catia filenames on the [CAD] share:</p><pre class="programlisting">
    77        <em class="parameter"><code>[CAD]</code></em>
    88        <a class="link" href="smb.conf.5.html#PATH" target="_top">path = /data/cad</a>
    99        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = catia</a>
    10 </pre></div><div class="refsect1" title="VERSION"><a name="id2489342"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    11         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489353"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     10</pre></div><div class="refsect1" lang="en"><a name="id2483358"></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="id2483369"></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.3.x/docs/htmldocs/manpages/vfs_commit.8.html

    r368 r411  
    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.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_commit"><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" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = commit</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528903"></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.74.0"></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="id2522915"></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" title="OPTIONS"><a name="id2489307"></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="id2483329"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">commit:dthresh = BYTES</span></dt><dd><p>Synchronize file data each time the specified
    1111                number of bytes has been written.
    12                 </p><p>The following suffixes may be applied to BYTES:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">K</code> - BYTES is a number of kilobytes</p></li><li class="listitem"><p><code class="literal">M</code> - BYTES is a number of megabytes</p></li><li class="listitem"><p><code class="literal">G</code> - BYTES is a number of gigabytes</p></li></ul></div></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id2489366"></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="id2483388"></a><h2>EXAMPLES</h2><p>Synchronize the file data on the [precious] share after
    1313        every 512 kilobytes (524288 bytes) of data is written:</p><pre class="programlisting">
    1414        <em class="parameter"><code>[precious]</code></em>
    … …  
    1616        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = commit</a>
    1717        <a class="link" href="smb.conf.5.html#COMMIT:DTHRESH" target="_top">commit:dthresh = 512K</a>
    18 </pre></div><div class="refsect1" title="CAVEATS"><a name="id2489652"></a><h2>CAVEATS</h2><p>On some systems, the data synchronization performed by
     18</pre></div><div class="refsect1" lang="en"><a name="id2483669"></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" title="VERSION"><a name="id2489669"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    21         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489680"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     20        </p></div><div class="refsect1" lang="en"><a name="id2483685"></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="id2483696"></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.3.x/docs/htmldocs/manpages/vfs_default_quota.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_default_quota</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_default_quota"><a name="vfs_default_quota.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_default_quota &#8212; store default quota records for Windows clients</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = default_quota</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528904"></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.74.0"></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="id2522915"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>
    33        suite.</p><p>Many common quota implementations only store
    … …  
    1010        the default quota to the quota record of a user. By default the
    1111        root user is taken because quota limits for root are typically
    12         not enforced.</p><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id2489315"></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="id2483335"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">default_quota:uid = UID</span></dt><dd><p>UID specifies the user ID of the quota record where the
    1313                default user quota values are stored.
    1414                </p></dd><dt><span class="term">default_quota:gid = GID</span></dt><dd><p>GID specifies the group ID of the quota record where the
    … …  
    2222                be reported as having a quota of NO_LIMIT. Otherwise,
    2323                the stored values will be reported.
    24                 </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id2489507"></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="id2483526"></a><h2>EXAMPLES</h2><p>Store the default quota record in the quota record for
    2525        the user with ID 65535 and report that user as having no quota
    2626        limits:</p><pre class="programlisting">
    … …  
    2929        <a class="link" href="smb.conf.5.html#DEFAULT_QUOTA:UID" target="_top">default_quota:uid = 65535</a>
    3030        <a class="link" href="smb.conf.5.html#DEFAULT_QUOTA:UIDNOLIMIT" target="_top">default_quota:uid nolimit = yes</a>
    31 </pre></div><div class="refsect1" title="VERSION"><a name="id2489662"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    32         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489673"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     31</pre></div><div class="refsect1" lang="en"><a name="id2483680"></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="id2483691"></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.3.x/docs/htmldocs/manpages/vfs_dirsort.8.html

    r374 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_dirsort</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_dirsort"><a name="vfs_dirsort.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_dirsort &#8212; Sort directory contents</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = dirsort</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528903"></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_dirsort</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="vfs_dirsort.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_dirsort &#8212; Sort directory contents</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = dirsort</code></p></div></div><div class="refsect1" lang="en"><a name="id2522915"></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_dirsort</code> module sorts directory
    33        entries alphabetically before sending them to the client.</p><p>Please be aware that adding this module might have negative
    4         performance implications for large directories.</p></div><div class="refsect1" title="EXAMPLES"><a name="id2528937"></a><h2>EXAMPLES</h2><p>Sort directories for all shares:</p><pre class="programlisting">
     4        performance implications for large directories.</p></div><div class="refsect1" lang="en"><a name="id2522948"></a><h2>EXAMPLES</h2><p>Sort directories for all shares:</p><pre class="programlisting">
    55        <em class="parameter"><code>[global]</code></em>
    66        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = dirsort</a>
    7 </pre></div><div class="refsect1" title="VERSION"><a name="id2489326"></a><h2>VERSION</h2><p>This man page is correct for version 3.3 of the Samba suite.
    8         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489337"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     7</pre></div><div class="refsect1" lang="en"><a name="id2483348"></a><h2>VERSION</h2><p>This man page is correct for version 3.3 of the Samba suite.
     8        </p></div><div class="refsect1" lang="en"><a name="id2483359"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    99        were created by Andrew Tridgell. Samba is now developed
    1010        by the Samba Team as an Open Source project similar

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_extd_audit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_extd_audit"><a name="vfs_extd_audit.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_extd_audit &#8212; record selected Samba VFS operations</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = extd_audit</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528903"></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.74.0"></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="id2522914"></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" title="VERSION"><a name="id2489334"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    11         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489345"></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="id2483357"></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="id2483368"></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.3.x/docs/htmldocs/manpages/vfs_fake_perms.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_fake_perms</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_fake_perms"><a name="vfs_fake_perms.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_fake_perms &#8212; enable read only Roaming Profiles</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = fake_perms</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528903"></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.74.0"></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="id2522914"></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" title="EXAMPLES"><a name="id2528940"></a><h2>EXAMPLES</h2><pre class="programlisting">
     9        </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2522951"></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" target="_top">path = /profiles</a>
    1212        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = fake_perms</a>
    13 </pre></div><div class="refsect1" title="VERSION"><a name="id2489335"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    14         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489346"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     13</pre></div><div class="refsect1" lang="en"><a name="id2483358"></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="id2483369"></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.3.x/docs/htmldocs/manpages/vfs_fileid.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_fileid</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_fileid"><a name="vfs_fileid.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_fileid &#8212; Generates file_id structs with unique device id values for
    2         cluster setups</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = fileid</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528904"></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_fileid</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="vfs_fileid.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_fileid &#8212; Generates file_id structs with unique device id values for
     2        cluster setups</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = fileid</code></p></div></div><div class="refsect1" lang="en"><a name="id2522916"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    33        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>
    44        suite.</p><p>Samba uses file_id structs to uniquely identify files
    … …  
    1010        generates the device number based on the configured algorithm
    1111        (see the "fileid:algorithm" option).
    12         </p></div><div class="refsect1" title="OPTIONS"><a name="id2528944"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">fileid:algorithm = ALGORITHM</span></dt><dd><p>Available algorithms are <code class="literal">fsname</code>
     12        </p></div><div class="refsect1" lang="en"><a name="id2483325"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">fileid:algorithm = ALGORITHM</span></dt><dd><p>Available algorithms are <code class="literal">fsname</code>
    1313                and <code class="literal">fsid</code>. The default value is
    1414                <code class="literal">fsname</code>.
    … …  
    2121                <code class="literal">fileid:algorithm</code> option, which was used in earlier
    2222                versions of fileid mapping feature in custom Samba 3.0 versions.
    23                 </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id2489528"></a><h2>EXAMPLES</h2><p>Usage of the <code class="literal">fileid</code> module with the
     23                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483544"></a><h2>EXAMPLES</h2><p>Usage of the <code class="literal">fileid</code> module with the
    2424        <code class="literal">fsid</code> algorithm:</p><pre class="programlisting">
    2525        <em class="parameter"><code>[global]</code></em>
    2626        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = fileid</a>
    2727        <a class="link" href="smb.conf.5.html#FILEID:ALGORITHM" target="_top">fileid:algorithm = fsid</a>
    28 </pre></div><div class="refsect1" title="VERSION"><a name="id2489685"></a><h2>VERSION</h2><p>This man page is correct for version 3.2 of the Samba suite.
    29         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489695"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     28</pre></div><div class="refsect1" lang="en"><a name="id2483700"></a><h2>VERSION</h2><p>This man page is correct for version 3.2 of the Samba suite.
     29        </p></div><div class="refsect1" lang="en"><a name="id2483711"></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.3.x/docs/htmldocs/manpages/vfs_full_audit.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_full_audit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_full_audit"><a name="vfs_full_audit.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_full_audit &#8212; record Samba VFS operations in the system log</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = full_audit</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528904"></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.74.0"></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="id2522915"></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
    44        <a class="citerefentry" href="syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>.</p><p><code class="literal">vfs_full_audit</code> is able to record the
    5         complete set of Samba VFS operations:</p><table border="0" summary="Simple list" class="simplelist"><tr><td>aio_cancel</td></tr><tr><td>aio_error</td></tr><tr><td>aio_fsync</td></tr><tr><td>aio_read</td></tr><tr><td>aio_return</td></tr><tr><td>aio_suspend</td></tr><tr><td>aio_write</td></tr><tr><td>chdir</td></tr><tr><td>chflags</td></tr><tr><td>chmod</td></tr><tr><td>chmod_acl</td></tr><tr><td>chown</td></tr><tr><td>close</td></tr><tr><td>closedir</td></tr><tr><td>connect</td></tr><tr><td>disconnect</td></tr><tr><td>disk_free</td></tr><tr><td>fchmod</td></tr><tr><td>fchmod_acl</td></tr><tr><td>fchown</td></tr><tr><td>fget_nt_acl</td></tr><tr><td>fgetxattr</td></tr><tr><td>flistxattr</td></tr><tr><td>fremovexattr</td></tr><tr><td>fset_nt_acl</td></tr><tr><td>fsetxattr</td></tr><tr><td>fstat</td></tr><tr><td>fsync</td></tr><tr><td>ftruncate</td></tr><tr><td>get_nt_acl</td></tr><tr><td>get_quota</td></tr><tr><td>get_shadow_copy_data</td></tr><tr><td>getlock</td></tr><tr><td>getwd</td></tr><tr><td>getxattr</td></tr><tr><td>kernel_flock</td></tr><tr><td>lgetxattr</td></tr><tr><td>link</td></tr><tr><td>linux_setlease</td></tr><tr><td>listxattr</td></tr><tr><td>llistxattr</td></tr><tr><td>lock</td></tr><tr><td>lremovexattr</td></tr><tr><td>lseek</td></tr><tr><td>lsetxattr</td></tr><tr><td>lstat</td></tr><tr><td>mkdir</td></tr><tr><td>mknod</td></tr><tr><td>open</td></tr><tr><td>opendir</td></tr><tr><td>pread</td></tr><tr><td>pwrite</td></tr><tr><td>read</td></tr><tr><td>readdir</td></tr><tr><td>readlink</td></tr><tr><td>realpath</td></tr><tr><td>removexattr</td></tr><tr><td>rename</td></tr><tr><td>rewinddir</td></tr><tr><td>rmdir</td></tr><tr><td>seekdir</td></tr><tr><td>sendfile</td></tr><tr><td>set_nt_acl</td></tr><tr><td>set_quota</td></tr><tr><td>setxattr</td></tr><tr><td>stat</td></tr><tr><td>statvfs</td></tr><tr><td>symlink</td></tr><tr><td>sys_acl_add_perm</td></tr><tr><td>sys_acl_clear_perms</td></tr><tr><td>sys_acl_create_entry</td></tr><tr><td>sys_acl_delete_def_file</td></tr><tr><td>sys_acl_free_acl</td></tr><tr><td>sys_acl_free_qualifier</td></tr><tr><td>sys_acl_free_text</td></tr><tr><td>sys_acl_get_entry</td></tr><tr><td>sys_acl_get_fd</td></tr><tr><td>sys_acl_get_file</td></tr><tr><td>sys_acl_get_perm</td></tr><tr><td>sys_acl_get_permset</td></tr><tr><td>sys_acl_get_qualifier</td></tr><tr><td>sys_acl_get_tag_type</td></tr><tr><td>sys_acl_init</td></tr><tr><td>sys_acl_set_fd</td></tr><tr><td>sys_acl_set_file</td></tr><tr><td>sys_acl_set_permset</td></tr><tr><td>sys_acl_set_qualifier</td></tr><tr><td>sys_acl_set_tag_type</td></tr><tr><td>sys_acl_to_text</td></tr><tr><td>sys_acl_valid</td></tr><tr><td>telldir</td></tr><tr><td>unlink</td></tr><tr><td>utime</td></tr><tr><td>write</td></tr></table><p>In addition to these operations,
     5        complete set of Samba VFS operations:</p><table class="simplelist" border="0" summary="Simple list"><tr><td>aio_cancel</td></tr><tr><td>aio_error</td></tr><tr><td>aio_fsync</td></tr><tr><td>aio_read</td></tr><tr><td>aio_return</td></tr><tr><td>aio_suspend</td></tr><tr><td>aio_write</td></tr><tr><td>chdir</td></tr><tr><td>chflags</td></tr><tr><td>chmod</td></tr><tr><td>chmod_acl</td></tr><tr><td>chown</td></tr><tr><td>close</td></tr><tr><td>closedir</td></tr><tr><td>connect</td></tr><tr><td>disconnect</td></tr><tr><td>disk_free</td></tr><tr><td>fchmod</td></tr><tr><td>fchmod_acl</td></tr><tr><td>fchown</td></tr><tr><td>fget_nt_acl</td></tr><tr><td>fgetxattr</td></tr><tr><td>flistxattr</td></tr><tr><td>fremovexattr</td></tr><tr><td>fset_nt_acl</td></tr><tr><td>fsetxattr</td></tr><tr><td>fstat</td></tr><tr><td>fsync</td></tr><tr><td>ftruncate</td></tr><tr><td>get_nt_acl</td></tr><tr><td>get_quota</td></tr><tr><td>get_shadow_copy_data</td></tr><tr><td>getlock</td></tr><tr><td>getwd</td></tr><tr><td>getxattr</td></tr><tr><td>kernel_flock</td></tr><tr><td>lgetxattr</td></tr><tr><td>link</td></tr><tr><td>linux_setlease</td></tr><tr><td>listxattr</td></tr><tr><td>llistxattr</td></tr><tr><td>lock</td></tr><tr><td>lremovexattr</td></tr><tr><td>lseek</td></tr><tr><td>lsetxattr</td></tr><tr><td>lstat</td></tr><tr><td>mkdir</td></tr><tr><td>mknod</td></tr><tr><td>open</td></tr><tr><td>opendir</td></tr><tr><td>pread</td></tr><tr><td>pwrite</td></tr><tr><td>read</td></tr><tr><td>readdir</td></tr><tr><td>readlink</td></tr><tr><td>realpath</td></tr><tr><td>removexattr</td></tr><tr><td>rename</td></tr><tr><td>rewinddir</td></tr><tr><td>rmdir</td></tr><tr><td>seekdir</td></tr><tr><td>sendfile</td></tr><tr><td>set_nt_acl</td></tr><tr><td>set_quota</td></tr><tr><td>setxattr</td></tr><tr><td>stat</td></tr><tr><td>statvfs</td></tr><tr><td>symlink</td></tr><tr><td>sys_acl_add_perm</td></tr><tr><td>sys_acl_clear_perms</td></tr><tr><td>sys_acl_create_entry</td></tr><tr><td>sys_acl_delete_def_file</td></tr><tr><td>sys_acl_free_acl</td></tr><tr><td>sys_acl_free_qualifier</td></tr><tr><td>sys_acl_free_text</td></tr><tr><td>sys_acl_get_entry</td></tr><tr><td>sys_acl_get_fd</td></tr><tr><td>sys_acl_get_file</td></tr><tr><td>sys_acl_get_perm</td></tr><tr><td>sys_acl_get_permset</td></tr><tr><td>sys_acl_get_qualifier</td></tr><tr><td>sys_acl_get_tag_type</td></tr><tr><td>sys_acl_init</td></tr><tr><td>sys_acl_set_fd</td></tr><tr><td>sys_acl_set_file</td></tr><tr><td>sys_acl_set_permset</td></tr><tr><td>sys_acl_set_qualifier</td></tr><tr><td>sys_acl_set_tag_type</td></tr><tr><td>sys_acl_to_text</td></tr><tr><td>sys_acl_valid</td></tr><tr><td>telldir</td></tr><tr><td>unlink</td></tr><tr><td>utime</td></tr><tr><td>write</td></tr></table><p>In addition to these operations,
    66        <code class="literal">vfs_full_audit</code> recognizes the special operation
    77        names "all" and "none ", which refer to all
    … …  
    1111        format is: </p><pre class="programlisting">
    1212                smbd_audit: PREFIX|OPERATION|RESULT|FILE
    13         </pre><p>The record fields are:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">PREFIX</code> - the result of the full_audit:prefix string after variable substitutions</p></li><li class="listitem"><p><code class="literal">OPERATION</code> - the name of the VFS operation</p></li><li class="listitem"><p><code class="literal">RESULT</code> - whether the operation succeeded or failed</p></li><li class="listitem"><p><code class="literal">FILE</code> - the name of the file or directory the operation was performed on</p></li></ul></div><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id2487512"></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="id2481531"></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" title="EXAMPLES"><a name="id2487618"></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="id2481637"></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" target="_top">full_audit:facility = LOCAL7</a>
    3737        <a class="link" href="smb.conf.5.html#FULL_AUDIT:PRIORITY" target="_top">full_audit:priority = ALERT</a>
    38 </pre></div><div class="refsect1" title="VERSION"><a name="id2487822"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    39         </p></div><div class="refsect1" title="AUTHOR"><a name="id2487833"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     38</pre></div><div class="refsect1" lang="en"><a name="id2481840"></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="id2481850"></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.3.x/docs/htmldocs/manpages/vfs_gpfs.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_gpfs</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_gpfs"><a name="vfs_gpfs.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_gpfs &#8212; gpfs specific samba extensions like acls and prealloc</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = gpfs</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528897"></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.74.0"></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="id2522916"></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
    44        with GPFS. It uses the GPL library interfaces provided by GPFS.
    55        </p><p>Currently the gpfs vfs module provides extensions in following areas :
    6         </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>NFSv4 ACL Interfaces with configurable options for GPFS</p></li><li class="listitem"><p>Kernel oplock support on GPFS</p></li><li class="listitem"><p>Lease support on GPFS</p></li></ul></div><p>
     6        </p><div class="itemizedlist"><ul type="disc"><li><p>NFSv4 ACL Interfaces with configurable options for GPFS</p></li><li><p>Kernel oplock support on GPFS</p></li><li><p>Lease support on GPFS</p></li></ul></div><p>
    77        </p><p><code class="literal">NOTE:</code>This module follows the posix-acl behaviour
    88        and hence allows permission stealing via chown. Samba might allow at a later
    99        point in time, to restrict the chown via this module as such restrictions
    1010        are the responsibility of the underlying filesystem than of Samba.
    11         </p><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id2489333"></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="id2483349"></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
    1414                sets the special IDs - OWNER@ and GROUP@ ( mappings to simple uids )
    1515                that are relevant to GPFS.
    16                 </p><p>The following MODEs are understood by the module:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">simple(default)</code> - do not use special IDs in GPFS ACEs</p></li><li class="listitem"><p><code class="literal">special</code> - use special IDs in GPFS ACEs. </p></li></ul></div></dd><dt><span class="term">nfs4:acedup = [dontcare|reject|ignore|merge]</span></dt><dd><p>
     16                </p><p>The following MODEs are understood by the module:</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">simple(default)</code> - do not use special IDs in GPFS ACEs</p></li><li><p><code class="literal">special</code> - use special IDs in GPFS ACEs. </p></li></ul></div></dd><dt><span class="term">nfs4:acedup = [dontcare|reject|ignore|merge]</span></dt><dd><p>
    1717                This parameter configures how Samba handles duplicate ACEs encountered in GPFS ACLs.
    1818                GPFS allows/creates duplicate ACE for different bits for same ID.
    19                 </p><p>Following is the behaviour of Samba for different values :</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">dontcare (default)</code> - copy the ACEs as they come</p></li><li class="listitem"><p><code class="literal">reject</code> - stop operation and exit with error on ACL set op</p></li><li class="listitem"><p><code class="literal">ignore</code> - don't include the second matching ACE</p></li><li class="listitem"><p><code class="literal">merge</code> - bitwise OR the 2 ace.flag fields and 2 ace.mask fields of the 2 duplicate ACEs into 1 ACE</p></li></ul></div></dd><dt><span class="term">nfs4:chown = [yes|no]</span></dt><dd><p>This parameter allows enabling or disabling the chown supported
     19                </p><p>Following is the behaviour of Samba for different values :</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">dontcare (default)</code> - copy the ACEs as they come</p></li><li><p><code class="literal">reject</code> - stop operation and exit with error on ACL set op</p></li><li><p><code class="literal">ignore</code> - don't include the second matching ACE</p></li><li><p><code class="literal">merge</code> - bitwise OR the 2 ace.flag fields and 2 ace.mask fields of the 2 duplicate ACEs into 1 ACE</p></li></ul></div></dd><dt><span class="term">nfs4:chown = [yes|no]</span></dt><dd><p>This parameter allows enabling or disabling the chown supported
    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 class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">yes</code> - Enable chown if as supported by the under filesystem</p></li><li class="listitem"><p><code class="literal">no (default)</code> - Disable chown</p></li></ul></div></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id2489622"></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="id2483636"></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" target="_top">vfs objects = gpfs</a>
    … …  
    2626        <a class="link" href="smb.conf.5.html#NFS4:MODE" target="_top">nfs4: mode = special</a>
    2727        <a class="link" href="smb.conf.5.html#NFS4:ACEDUP" target="_top">nfs4: acedup = merge</a>
    28 </pre></div><div class="refsect1" title="CAVEATS"><a name="id2487454"></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="id2481472"></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" title="VERSION"><a name="id2487471"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    32         </p></div><div class="refsect1" title="AUTHOR"><a name="id2487482"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     31        </p></div><div class="refsect1" lang="en"><a name="id2481489"></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="id2481500"></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.3.x/docs/htmldocs/manpages/vfs_netatalk.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_netatalk</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_netatalk"><a name="vfs_netatalk.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_netatalk &#8212; hide .AppleDouble files from CIFS clients</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = netatalk</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528903"></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.74.0"></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="id2522914"></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" title="EXAMPLES"><a name="id2528937"></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="id2522948"></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" target="_top">vfs objects = netatalk</a>
    8 </pre></div><div class="refsect1" title="CAVEATS"><a name="id2489327"></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="id2483350"></a><h2>CAVEATS</h2><p>This module is largely historic and unlikely to be of use
    99        in modern networks since current Apple systems are able to mount CIFS
    1010        shares natively.
    11         </p></div><div class="refsect1" title="VERSION"><a name="id2489339"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    12         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489350"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     11        </p></div><div class="refsect1" lang="en"><a name="id2483362"></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="id2483373"></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.3.x/docs/htmldocs/manpages/vfs_notify_fam.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_notify_fam</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_notify_fam"><a name="vfs_notify_fam.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_notify_fam &#8212; FAM support for file change notifications</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = notify_fam</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528903"></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.74.0"></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="id2522914"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_notify_fam</code> module makes use of
    33        the system FAM (File Alteration Monitor) daemon to implement
    44        file change notifications for Windows clients. FAM is generally
    5         present only on IRIX and some BSD systems.</p><p>This module is not stackable.</p></div><div class="refsect1" title="EXAMPLES"><a name="id2528936"></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="id2522948"></a><h2>EXAMPLES</h2><p>Support FAM notifications globally:</p><pre class="programlisting">
    66        <em class="parameter"><code>[global]</code></em>
    77        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = notify_fam</a>
    8 </pre></div><div class="refsect1" title="VERSION"><a name="id2489326"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    9         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489337"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     8</pre></div><div class="refsect1" lang="en"><a name="id2483348"></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="id2483359"></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.3.x/docs/htmldocs/manpages/vfs_prealloc.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_prealloc</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_prealloc"><a name="vfs_prealloc.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_prealloc &#8212; preallocate matching files to a predetermined size</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = prealloc</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528904"></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.74.0"></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="id2522915"></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" title="OPTIONS"><a name="id2528938"></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="id2522950"></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 class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">K</code> - BYTES is a number of kilobytes</p></li><li class="listitem"><p><code class="literal">M</code> - BYTES is a number of megabytes</p></li><li class="listitem"><p><code class="literal">G</code> - BYTES is a number of gigabytes</p></li></ul></div></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id2489356"></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="id2483378"></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" target="_top">vfs objects = prealloc</a>
    1414        <a class="link" href="smb.conf.5.html#PREALLOC:TIFF" target="_top">prealloc:tiff = 4M</a>
    15 </pre></div><div class="refsect1" title="CAVEATS"><a name="id2489643"></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="id2483658"></a><h2>CAVEATS</h2><p><code class="literal">vfs_prealloc</code> is not supported on all
    1616        platforms and filesystems. Currently only XFS filesystems on
    1717        Linux and IRIX are supported.
    18         </p></div><div class="refsect1" title="VERSION"><a name="id2489659"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    19         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489670"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     18        </p></div><div class="refsect1" lang="en"><a name="id2483674"></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="id2483685"></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.3.x/docs/htmldocs/manpages/vfs_preopen.8.html

    r374 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_preopen</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_preopen"><a name="vfs_preopen.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_preopen &#8212; Hide read latencies for applications reading numbered files</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = preopen</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528904"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_preopen</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="vfs_preopen.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_preopen &#8212; Hide read latencies for applications reading numbered files</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = preopen</code></p></div></div><div class="refsect1" lang="en"><a name="id2522916"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>This module assists applications that want to read numbered
    33        files in sequence with very strict latency requirements. One area
    … …  
    66        started that speculatively open files and read a number of bytes to
    77        prime the file system cache, so that later on when the real
    8         application's request comes along, no disk access is necessary.</p><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id2528940"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">preopen:names = /pattern/</span></dt><dd><p>
     8        application's request comes along, no disk access is necessary.</p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2522951"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">preopen:names = /pattern/</span></dt><dd><p>
    99                preopen:names specifies the file name pattern which should
    1010                trigger the preopen helpers to do their work. We assume that
    … …  
    2020                Number of files that should be speculatively opened. Defaults
    2121                to the 10 subsequent files.
    22                 </p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id2489374"></a><h2>VERSION</h2><p>This man page is correct for version 3.3 of the Samba suite.
    23         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489516"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     22                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483396"></a><h2>VERSION</h2><p>This man page is correct for version 3.3 of the Samba suite.
     23        </p></div><div class="refsect1" lang="en"><a name="id2483532"></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.3.x/docs/htmldocs/manpages/vfs_readahead.8.html

    r368 r411  
    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.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_readahead"><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" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = readahead</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528903"></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.74.0"></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="id2522914"></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" title="OPTIONS"><a name="id2489321"></a><h2>OPTIONS</h2><div class="variablelist"><p>The following suffixes may be applied to BYTES:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">K</code> - BYTES is a number of kilobytes</p></li><li class="listitem"><p><code class="literal">M</code> - BYTES is a number of megabytes</p></li><li class="listitem"><p><code class="literal">G</code> - BYTES is a number of gigabytes</p></li></ul></div><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="id2483344"></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" title="EXAMPLES"><a name="id2489525"></a><h2>EXAMPLES</h2><pre class="programlisting">
     18                readahead call.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483542"></a><h2>EXAMPLES</h2><pre class="programlisting">
    1919        <em class="parameter"><code>[hypothetical]</code></em>
    2020        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = readahead</a>
    21 </pre></div><div class="refsect1" title="VERSION"><a name="id2489655"></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" title="AUTHOR"><a name="id2489666"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     21</pre></div><div class="refsect1" lang="en"><a name="id2483672"></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="id2483683"></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.3.x/docs/htmldocs/manpages/vfs_readonly.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_readonly</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_readonly"><a name="vfs_readonly.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_readonly &#8212; make a Samba share read only for a specified time period</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = readonly</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528904"></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.74.0"></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="id2522915"></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" title="OPTIONS"><a name="id2528938"></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="id2522950"></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" title="EXAMPLES"><a name="id2489333"></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="id2483355"></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" target="_top">vfs objects = readonly</a>
    … …  
    1818        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = readonly</a>
    1919        <a class="link" href="smb.conf.5.html#READONLY:PERIOD" target="_top">readonly:period = readonly:period = "today 9:00","today 17:00"</a>
    20 </pre></div><div class="refsect1" title="VERSION"><a name="id2489643"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    21         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489654"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     20</pre></div><div class="refsect1" lang="en"><a name="id2483658"></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="id2483669"></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.3.x/docs/htmldocs/manpages/vfs_recycle.8.html

    r368 r411  
    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.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_recycle"><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" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = recycle</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528903"></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.74.0"></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="id2522915"></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" title="OPTIONS"><a name="id2489308"></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="id2483330"></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" title="EXAMPLES"><a name="id2489646"></a><h2>EXAMPLES</h2><p>Move files "deleted" on <em class="parameter"><code>share</code></em> to
     50                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483662"></a><h2>EXAMPLES</h2><p>Move files "deleted" on <em class="parameter"><code>share</code></em> to
    5151        <em class="parameter"><code>/data/share/.recycle</code></em> instead of deleting them:
    5252        </p><pre class="programlisting">
    … …  
    5757        <a class="link" href="smb.conf.5.html#RECYCLE:KEEPTREE" target="_top">recycle:keeptree = yes</a>
    5858        <a class="link" href="smb.conf.5.html#RECYCLE:VERSIONS" target="_top">recycle:versions = yes</a>
    59 </pre></div><div class="refsect1" title="VERSION"><a name="id2487495"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    60         </p></div><div class="refsect1" title="AUTHOR"><a name="id2487506"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     59</pre></div><div class="refsect1" lang="en"><a name="id2481514"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
     60        </p></div><div class="refsect1" lang="en"><a name="id2481525"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    6161        were created by Andrew Tridgell. Samba is now developed
    6262        by the Samba Team as an Open Source project similar

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_shadow_copy</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_shadow_copy"><a name="vfs_shadow_copy.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_shadow_copy &#8212; Make a Samba share read only for a specified time period</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = shadow_copy</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528905"></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.74.0"></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="id2522915"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_shadow_copy</code> VFS module functionality
    33        that is similar to Microsoft Shadow Copy services. When setup properly,
    44        this module allows Microsoft Shadow Copy clients to browse
    55        "shadow copies" on Samba shares.
    6         </p><p>This module is stackable.</p></div><div class="refsect1" title="CONFIGURATION"><a name="id2528939"></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="id2522949"></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.
    … …  
    1212        be immediate children of a the directory being shared.</p><p>The snapshot naming convention is @GMT-YYYY.MM.DD-hh.mm.ss,
    1313        where:
    14         </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">YYYY</code> is the 4 digit year</p></li><li class="listitem"><p><code class="literal">MM</code> is the 2 digit month</p></li><li class="listitem"><p><code class="literal">DD</code> is the 2 digit day</p></li><li class="listitem"><p><code class="literal">hh</code> is the 2 digit hour</p></li><li class="listitem"><p><code class="literal">mm</code> is the 2 digit minute</p></li><li class="listitem"><p><code class="literal">ss</code> is the 2 digit second.</p></li></ul></div><p>
     14        </p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">YYYY</code> is the 4 digit year</p></li><li><p><code class="literal">MM</code> is the 2 digit month</p></li><li><p><code class="literal">DD</code> is the 2 digit day</p></li><li><p><code class="literal">hh</code> is the 2 digit hour</p></li><li><p><code class="literal">mm</code> is the 2 digit minute</p></li><li><p><code class="literal">ss</code> is the 2 digit second.</p></li></ul></div><p>
    1515        </p><p>The <code class="literal">vfs_shadow_copy</code> snapshot naming convention can be produced with the following
    1616        <a class="citerefentry" href="date.1.html"><span class="citerefentry"><span class="refentrytitle">date</span>(1)</span></a> command:
    1717        </p><pre class="programlisting">
    1818        TZ=GMT date +@GMT-%Y.%m.%d-%H.%M.%S
    19         </pre></div><div class="refsect1" title="EXAMPLES"><a name="id2489536"></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="id2483556"></a><h2>EXAMPLES</h2><p>Add shadow copy support to user home directories:</p><pre class="programlisting">
    2020        <em class="parameter"><code>[homes]</code></em>
    2121        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = shadow_copy</a>
    22 </pre></div><div class="refsect1" title="CAVEATS"><a name="id2489671"></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="id2483690"></a><h2>CAVEATS</h2><p>This is not a backup, archival, or version control solution.
    2323        </p><p>With Samba or Windows servers,
    2424        <code class="literal">vfs_shadow_copy</code> is designed to be an end-user
    … …  
    2626        archival solutions and should in no way be considered as
    2727        such. Additionally, if you need version control, implement a
    28         version control system.</p></div><div class="refsect1" title="VERSION"><a name="id2489695"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    29         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489706"></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="id2483714"></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="id2483725"></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.3.x/docs/htmldocs/manpages/vfs_shadow_copy2.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_shadow_copy2</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_shadow_copy2"><a name="vfs_shadow_copy2.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_shadow_copy2 &#8212; Expose snapshots to Windows clients as shadow copies.</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = shadow_copy2</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528905"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_shadow_copy2</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="vfs_shadow_copy2.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_shadow_copy2 &#8212; Expose snapshots to Windows clients as shadow copies.</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = shadow_copy2</code></p></div></div><div class="refsect1" lang="en"><a name="id2522915"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_shadow_copy2</code> VFS module functionality
    33        that is similar to Microsoft Shadow Copy services. When setup properly,
    … …  
    55        "shadow copies" on Samba shares.
    66        </p><p>This is a 2nd implementation of a shadow copy module. This
    7         version has the following features:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>You don't need to populate your shares with symlinks to the
     7        version has the following features:</p><div class="orderedlist"><ol type="1"><li><p>You don't need to populate your shares with symlinks to the
    88        snapshots. This can be very important when you have thousands of
    9         shares, or use [homes].</p></li><li class="listitem"><p>The inode number of the files is altered so it is different
     9        shares, or use [homes].</p></li><li><p>The inode number of the files is altered so it is different
    1010        from the original. This allows the 'restore' button to work
    11         without a sharing violation.</p></li></ol></div><p>This module is stackable.</p></div><div class="refsect1" title="CONFIGURATION"><a name="id2489330"></a><h2>CONFIGURATION</h2><p><code class="literal">vfs_shadow_copy2</code> relies on a filesystem
     11        without a sharing violation.</p></li></ol></div><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2483350"></a><h2>CONFIGURATION</h2><p><code class="literal">vfs_shadow_copy2</code> relies on a filesystem
    1212        snapshot implementation. Many common filesystems have native
    1313        support for this.
    … …  
    1717        be immediate children of a the directory being shared.</p><p>The snapshot naming convention is @GMT-YYYY.MM.DD-hh.mm.ss,
    1818        where:
    19         </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">YYYY</code> is the 4 digit year</p></li><li class="listitem"><p><code class="literal">MM</code> is the 2 digit month</p></li><li class="listitem"><p><code class="literal">DD</code> is the 2 digit day</p></li><li class="listitem"><p><code class="literal">hh</code> is the 2 digit hour</p></li><li class="listitem"><p><code class="literal">mm</code> is the 2 digit minute</p></li><li class="listitem"><p><code class="literal">ss</code> is the 2 digit second.</p></li></ul></div><p>
     19        </p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">YYYY</code> is the 4 digit year</p></li><li><p><code class="literal">MM</code> is the 2 digit month</p></li><li><p><code class="literal">DD</code> is the 2 digit day</p></li><li><p><code class="literal">hh</code> is the 2 digit hour</p></li><li><p><code class="literal">mm</code> is the 2 digit minute</p></li><li><p><code class="literal">ss</code> is the 2 digit second.</p></li></ul></div><p>
    2020        </p><p>The <code class="literal">vfs_shadow_copy2</code> snapshot naming convention can be
    2121        produced with the following <a class="citerefentry" href="date.1.html"><span class="citerefentry"><span class="refentrytitle">date</span>(1)</span></a> command:
    2222        </p><pre class="programlisting">
    2323        TZ=GMT date +@GMT-%Y.%m.%d-%H.%M.%S
    24         </pre></div><div class="refsect1" title="OPTIONS"><a name="id2489565"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">shadow:snapdir = SNAPDIR
     24        </pre></div><div class="refsect1" lang="en"><a name="id2483583"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">shadow:snapdir = SNAPDIR
    2525                </span></dt><dd><p>Path to the directory where snapshots are kept.
    2626                </p></dd><dt><span class="term">shadow:basedir = BASEDIR
    … …  
    3535                this option then the 'restore' button in the shadow copy UI
    3636                will fail with a sharing violation.
    37                 </p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id2489631"></a><h2>EXAMPLES</h2><p>Add shadow copy support to user home directories:</p><pre class="programlisting">
     37                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483650"></a><h2>EXAMPLES</h2><p>Add shadow copy support to user home directories:</p><pre class="programlisting">
    3838        <em class="parameter"><code>[homes]</code></em>
    3939        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = shadow_copy2</a>
    4040        <a class="link" href="smb.conf.5.html#SHADOW:SNAPDIR" target="_top">shadow:snapdir = /data/snaphots</a>
    4141        <a class="link" href="smb.conf.5.html#SHADOW:BASEDIR" target="_top">shadow:basedir = /data/home</a>
    42 </pre></div><div class="refsect1" title="CAVEATS"><a name="id2487458"></a><h2>CAVEATS</h2><p>This is not a backup, archival, or version control solution.
     42</pre></div><div class="refsect1" lang="en"><a name="id2481475"></a><h2>CAVEATS</h2><p>This is not a backup, archival, or version control solution.
    4343        </p><p>With Samba or Windows servers,
    4444        <code class="literal">vfs_shadow_copy2</code> is designed to be an end-user
    … …  
    4646        archival solutions and should in no way be considered as
    4747        such. Additionally, if you need version control, implement a
    48         version control system.</p></div><div class="refsect1" title="VERSION"><a name="id2487481"></a><h2>VERSION</h2><p>This man page is correct for version 3.2.7 of the Samba suite.
    49         </p></div><div class="refsect1" title="AUTHOR"><a name="id2487492"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     48        version control system.</p></div><div class="refsect1" lang="en"><a name="id2481498"></a><h2>VERSION</h2><p>This man page is correct for version 3.2.7 of the Samba suite.
     49        </p></div><div class="refsect1" lang="en"><a name="id2481509"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    5050        were created by Andrew Tridgell. Samba is now developed
    5151        by the Samba Team as an Open Source project similar

  • branches/samba-3.3.x/docs/htmldocs/manpages/vfs_smb_traffic_analyzer.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smb_traffic_analyzer</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smb_traffic_analyzer"><a name="vfs_smb_traffic_analyzer.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_smb_traffic_analyzer &#8212; log Samba VFS read and write operations through a socket
    2         to a helper application</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = smb_traffic_analyzer</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528899"></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>smb_traffic_analyzer</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="vfs_smb_traffic_analyzer.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_smb_traffic_analyzer &#8212; log Samba VFS read and write operations through a socket
     2        to a helper application</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = smb_traffic_analyzer</code></p></div></div><div class="refsect1" lang="en"><a name="id2522910"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    33        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_smb_traffic_analyzer</code> VFS module logs
    44        client write and read operations on a Samba server and sends this data
    … …  
    88        http://holger123.wordpress.com/smb-traffic-analyzer/
    99        </p><p><code class="literal">vfs_smb_traffic_analyzer</code> currently is aware
    10         of the following VFS operations:</p><table border="0" summary="Simple list" class="simplelist"><tr><td>write</td></tr><tr><td>pwrite</td></tr><tr><td>read</td></tr><tr><td>pread</td></tr></table><p><code class="literal">vfs_smb_traffic_analyzer</code> sends the following data
     10        of the following VFS operations:</p><table class="simplelist" border="0" summary="Simple list"><tr><td>write</td></tr><tr><td>pwrite</td></tr><tr><td>read</td></tr><tr><td>pread</td></tr></table><p><code class="literal">vfs_smb_traffic_analyzer</code> sends the following data
    1111        in a fixed format seperated by a comma through either an internet or a
    1212        unix domain socket:</p><pre class="programlisting">
    … …  
    1414        </pre><p>Description of the records:
    1515
    16         </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">BYTES</code> - the length in bytes of the VFS operation</p></li><li class="listitem"><p><code class="literal">USER</code> - the user who initiated the operation</p></li><li class="listitem"><p><code class="literal">DOMAIN</code> - the domain of the user</p></li><li class="listitem"><p><code class="literal">READ/WRITE</code> - either "W" for a write operation or "R" for read</p></li><li class="listitem"><p><code class="literal">SHARE</code> - the name of the share on which the VFS operation occured</p></li><li class="listitem"><p><code class="literal">FILENAME</code> - the name of the file that was used by the VFS operation</p></li><li class="listitem"><p><code class="literal">TIMESTAMP</code> - a timestamp, formatted as "yyyy-mm-dd hh-mm-ss.ms" indicating when the VFS operation occured</p></li></ul></div><p>
     16        </p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">BYTES</code> - the length in bytes of the VFS operation</p></li><li><p><code class="literal">USER</code> - the user who initiated the operation</p></li><li><p><code class="literal">DOMAIN</code> - the domain of the user</p></li><li><p><code class="literal">READ/WRITE</code> - either "W" for a write operation or "R" for read</p></li><li><p><code class="literal">SHARE</code> - the name of the share on which the VFS operation occured</p></li><li><p><code class="literal">FILENAME</code> - the name of the file that was used by the VFS operation</p></li><li><p><code class="literal">TIMESTAMP</code> - a timestamp, formatted as "yyyy-mm-dd hh-mm-ss.ms" indicating when the VFS operation occured</p></li></ul></div><p>
    1717
    18         </p><p>This module is stackable.</p></div><div class="refsect1" title="OPTIONS"><a name="id2489544"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">smb_traffic_analyzer:mode = STRING</span></dt><dd><p>If STRING matches to "unix_domain_socket", the module will
     18        </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2483552"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">smb_traffic_analyzer:mode = STRING</span></dt><dd><p>If STRING matches to "unix_domain_socket", the module will
    1919                use a unix domain socket located at /var/tmp/stadsocket, if
    2020                STRING contains an different string or is not defined, the module will
    … …  
    2929                an additional hash number. This means that any transfer data
    3030                will be mapped to a single user, leading to a total
    31                 anonymization of user related data.</p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id2489635"></a><h2>EXAMPLES</h2><p>The module running on share "example_share", using a unix domain socket</p><pre class="programlisting">
     31                anonymization of user related data.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483643"></a><h2>EXAMPLES</h2><p>The module running on share "example_share", using a unix domain socket</p><pre class="programlisting">
    3232        <em class="parameter"><code>[example_share]</code></em>
    3333        <a class="link" href="smb.conf.5.html#PATH" target="_top">path = /data/example</a>
    … …  
    5050        <a class="link" href="smb.conf.5.html#SMB_TRAFFIC_ANALYZER:PORT" target="_top">smb_traffic_analyzer:port = 3491</a>
    5151        <a class="link" href="smb.conf.5.html#SMB_TRAFFIC_ANALYZER:ANONYMIZE_PREFIX" target="_top">smb_traffic_analyzer:anonymize_prefix = User</a>
    52         </pre></div><div class="refsect1" title="VERSION"><a name="id2487582"></a><h2>VERSION</h2><p>This man page is correct for version 3.3 of the Samba suite.
    53         </p></div><div class="refsect1" title="AUTHOR"><a name="id2487592"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     52        </pre></div><div class="refsect1" lang="en"><a name="id2481601"></a><h2>VERSION</h2><p>This man page is correct for version 3.3 of the Samba suite.
     53        </p></div><div class="refsect1" lang="en"><a name="id2481612"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    5454        were created by Andrew Tridgell. Samba is now developed
    5555        by the Samba Team as an Open Source project similar

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_streams_depot</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_streams_depot"><a name="vfs_streams_depot.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_streams_depot &#8212; EXPERIMENTAL module to store alternate data streams in a
     1<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.74.0"></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" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = streams_depot</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528905"></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="id2522915"></a><h2>DESCRIPTION</h2><p>This <span class="emphasis"><em>EXPERIMENTAL</em></span> VFS module is part of the
    44        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_streams_depot</code> enables storing of NTFS
    55        alternate data streams in the file system. As a normal posix file
    66        system does not support the concept of multiple data streams per file,
    77        the streams_depot module stores the data in files in a separate
    8         directory.</p></div><div class="refsect1" title="OPTIONS"><a name="id2528941"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">streams_depot:directory = PATH</span></dt><dd><p>Path of the directory where the alternate data streams
    9                 should be stored. Defaults to the sharepath/.streams.</p></dd></dl></div></div><div class="refsect1" title="EXAMPLES"><a name="id2489329"></a><h2>EXAMPLES</h2><pre class="programlisting">
     8        directory.</p></div><div class="refsect1" lang="en"><a name="id2522951"></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="id2483349"></a><h2>EXAMPLES</h2><pre class="programlisting">
    1010        <em class="parameter"><code>[share]</code></em>
    1111        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = streams_depot</a>
    12 </pre></div><div class="refsect1" title="AUTHOR"><a name="id2489356"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     12</pre></div><div class="refsect1" lang="en"><a name="id2483376"></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.3.x/docs/htmldocs/manpages/vfs_streams_xattr.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_streams_xattr</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_streams_xattr"><a name="vfs_streams_xattr.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_streams_xattr &#8212; Store alternate data streams in posix xattrs</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = streams_xattr</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528904"></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.74.0"></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="id2522915"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_streams_xattr</code> enables storing of NTFS
    33        alternate data streams in the file system. As a normal posix file
    … …  
    99        the size of xattrs. So this module might work for applications like IE
    1010        that stores small zone information in streams but will fail for
    11         applications that store serious amounts of data in ADSs.</p></div><div class="refsect1" title="EXAMPLES"><a name="id2489314"></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="id2483335"></a><h2>EXAMPLES</h2><pre class="programlisting">
    1212        <em class="parameter"><code>[share]</code></em>
    1313        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = streams_xattr</a>
    14 </pre></div><div class="refsect1" title="AUTHOR"><a name="id2489339"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     14</pre></div><div class="refsect1" lang="en"><a name="id2483360"></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.3.x/docs/htmldocs/manpages/vfs_xattr_tdb.8.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_xattr_tdb</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfs_xattr_tdb"><a name="vfs_xattr_tdb.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_xattr_tdb &#8212; Save Extended Attributes (EAs) in a tdb file</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = xattr_tdb</code></p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528904"></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.74.0"></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="id2522915"></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" title="OPTIONS"><a name="id2528937"></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="id2522949"></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" title="AUTHOR"><a name="id2489326"></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="id2483348"></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.3.x/docs/htmldocs/manpages/vfstest.1.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfstest</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vfstest"><a name="vfstest.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfstest &#8212; tool for testing samba VFS modules </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfstest</code> [-d debuglevel] [-c command] [-l logdir] [-h]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2528927"></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.74.0"></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="id2522946"></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" title="OPTIONS"><a name="id2489325"></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="id2483342"></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" title="COMMANDS"><a name="id2489705"></a><h2>COMMANDS</h2><p><span class="emphasis"><em>VFS COMMANDS</em></span></p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">load &lt;module.so&gt;</code> - Load specified VFS module </p></li><li class="listitem"><p><code class="literal">populate &lt;char&gt; &lt;size&gt;</code> - Populate a data buffer with the specified data
    36                 </p></li><li class="listitem"><p><code class="literal">showdata [&lt;offset&gt; &lt;len&gt;]</code> - Show data currently in data buffer
    37                 </p></li><li class="listitem"><p><code class="literal">connect</code> - VFS connect()</p></li><li class="listitem"><p><code class="literal">disconnect</code> - VFS disconnect()</p></li><li class="listitem"><p><code class="literal">disk_free</code> - VFS disk_free()</p></li><li class="listitem"><p><code class="literal">opendir</code> - VFS opendir()</p></li><li class="listitem"><p><code class="literal">readdir</code> - VFS readdir()</p></li><li class="listitem"><p><code class="literal">mkdir</code> - VFS mkdir()</p></li><li class="listitem"><p><code class="literal">rmdir</code> - VFS rmdir()</p></li><li class="listitem"><p><code class="literal">closedir</code> - VFS closedir()</p></li><li class="listitem"><p><code class="literal">open</code> - VFS open()</p></li><li class="listitem"><p><code class="literal">close</code> - VFS close()</p></li><li class="listitem"><p><code class="literal">read</code> - VFS read()</p></li><li class="listitem"><p><code class="literal">write</code> - VFS write()</p></li><li class="listitem"><p><code class="literal">lseek</code> - VFS lseek()</p></li><li class="listitem"><p><code class="literal">rename</code> - VFS rename()</p></li><li class="listitem"><p><code class="literal">fsync</code> - VFS fsync()</p></li><li class="listitem"><p><code class="literal">stat</code> - VFS stat()</p></li><li class="listitem"><p><code class="literal">fstat</code> - VFS fstat()</p></li><li class="listitem"><p><code class="literal">lstat</code> - VFS lstat()</p></li><li class="listitem"><p><code class="literal">unlink</code> - VFS unlink()</p></li><li class="listitem"><p><code class="literal">chmod</code> - VFS chmod()</p></li><li class="listitem"><p><code class="literal">fchmod</code> - VFS fchmod()</p></li><li class="listitem"><p><code class="literal">chown</code> - VFS chown()</p></li><li class="listitem"><p><code class="literal">fchown</code> - VFS fchown()</p></li><li class="listitem"><p><code class="literal">chdir</code> - VFS chdir()</p></li><li class="listitem"><p><code class="literal">getwd</code> - VFS getwd()</p></li><li class="listitem"><p><code class="literal">utime</code> - VFS utime()</p></li><li class="listitem"><p><code class="literal">ftruncate</code> - VFS ftruncate()</p></li><li class="listitem"><p><code class="literal">lock</code> - VFS lock()</p></li><li class="listitem"><p><code class="literal">symlink</code> - VFS symlink()</p></li><li class="listitem"><p><code class="literal">readlink</code> - VFS readlink()</p></li><li class="listitem"><p><code class="literal">link</code> - VFS link()</p></li><li class="listitem"><p><code class="literal">mknod</code> - VFS mknod()</p></li><li class="listitem"><p><code class="literal">realpath</code> - VFS realpath()</p></li></ul></div><p><span class="emphasis"><em>GENERAL COMMANDS</em></span></p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><code class="literal">conf &lt;smb.conf&gt;</code> - Load a different configuration file</p></li><li class="listitem"><p><code class="literal">help [&lt;command&gt;]</code> - Get list of commands or info about specified command</p></li><li class="listitem"><p><code class="literal">debuglevel &lt;level&gt;</code> - Set debug level</p></li><li class="listitem"><p><code class="literal">freemem</code> - Free memory currently in use</p></li><li class="listitem"><p><code class="literal">exit</code> - Exit vfstest</p></li></ul></div></div><div class="refsect1" title="VERSION"><a name="id2487782"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
    38         suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id2487793"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     35</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483722"></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
     36                </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="id2481803"></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="id2481814"></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.3.x/docs/htmldocs/manpages/wbinfo.1.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>wbinfo</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="wbinfo"><a name="wbinfo.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>wbinfo &#8212; Query information from winbind daemon</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">wbinfo</code> [-a user%password] [--all-domains] [--allocate-gid] [--allocate-uid] [-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] [--remove-uid-mapping uid,sid] [--remove-gid-mapping gid,sid] [-s sid] [--separator] [--sequence] [--set-auth-user user%password] [--set-uid-mapping uid,sid] [--set-gid-mapping gid,sid] [-S sid] [-t] [-u] [--uid-info uid] [--user-domgroups sid] [--user-sids sid] [-U uid] [-V] [-Y sid] [--verbose]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2489842"></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.74.0"></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] [--remove-uid-mapping uid,sid] [--remove-gid-mapping gid,sid] [-s sid] [--separator] [--sequence] [--set-auth-user user%password] [--set-uid-mapping uid,sid] [--set-gid-mapping gid,sid] [-S sid] [-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="id2483696"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">wbinfo</code> program queries and returns information
    22        created and used by the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon. </p><p>The <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon must be configured
    33        and running for the <code class="literal">wbinfo</code> program to be able
    4         to return information.</p></div><div class="refsect1" title="OPTIONS"><a name="id2489897"></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="id2483752"></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.
    6                 </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Do not be tempted to use this
     6                </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
    77                functionality for authentication in third-party
    88                applications.  Instead use <a class="citerefentry" href="ntlm_auth.1.html"><span class="citerefentry"><span class="refentrytitle">ntlm_auth</span>(1)</span></a>.</p></div></dd><dt><span class="term">--allocate-gid</span></dt><dd><p>Get a new GID out of idmap
    … …  
    8787                mapping in the IDmap backend.</p></dd><dt><span class="term">-V|--version</span></dt><dd><p>Prints the program version number.
    8888</p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    89 </p></dd></dl></div></div><div class="refsect1" title="EXIT STATUS"><a name="id2538666"></a><h2>EXIT STATUS</h2><p>The wbinfo program returns 0 if the operation
     89</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2532678"></a><h2>EXIT STATUS</h2><p>The wbinfo program returns 0 if the operation
    9090        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
    91         failure. </p></div><div class="refsect1" title="VERSION"><a name="id2538692"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    92         the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2538702"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> and <a class="citerefentry" href="ntlm_auth.1.html"><span class="citerefentry"><span class="refentrytitle">ntlm_auth</span>(1)</span></a></p></div><div class="refsect1" title="AUTHOR"><a name="id2538725"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     91        failure. </p></div><div class="refsect1" lang="en"><a name="id2532704"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     92        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2532714"></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="id2532737"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    9393        were created by Andrew Tridgell. Samba is now developed
    9494        by the Samba Team as an Open Source project similar

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>winbind_krb5_locator</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="winbind_krb5_locator"><a name="winbind_krb5_locator.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>winbind_krb5_locator &#8212; A plugin for MIT and Heimdal Kerberos for detecting KDCs using Windows semantics.</p></div><div class="refsect1" title="DESCRIPTION"><a name="id2528888"></a><h2>DESCRIPTION</h2><p>
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>winbind_krb5_locator</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="winbind_krb5_locator.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>winbind_krb5_locator &#8212; A plugin for MIT and Heimdal Kerberos for detecting KDCs using Windows semantics.</p></div><div class="refsect1" lang="en"><a name="id2522896"></a><h2>DESCRIPTION</h2><p>
    22        This plugin is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.
    33        </p><p>
    … …  
    99                The plugin uses the public locator API provided by most modern Kerberos
    1010                implementations.
    11         </p></div><div class="refsect1" title="PREREQUISITES"><a name="id2528920"></a><h2>PREREQUISITES</h2><p>
     11        </p></div><div class="refsect1" lang="en"><a name="id2522929"></a><h2>PREREQUISITES</h2><p>
    1212                MIT Kerberos (at least version 1.5) or Heimdal Kerberos (at least version
    1313                1.0) is required.
    … …  
    3333                environment without any modification or servers
    3434                being put manually into <code class="filename">/etc/krb5.conf</code>.
    35         </p></div><div class="refsect1" title="VERSION"><a name="id2489354"></a><h2>VERSION</h2><p>
     35        </p></div><div class="refsect1" lang="en"><a name="id2483377"></a><h2>VERSION</h2><p>
    3636        This man page is correct for version 3 of the Samba suite.
    37         </p></div><div class="refsect1" title="AUTHOR"><a name="id2489365"></a><h2>AUTHOR</h2><p>
     37        </p></div><div class="refsect1" lang="en"><a name="id2483388"></a><h2>AUTHOR</h2><p>
    3838                The original Samba software and related utilities were created by Andrew
    3939                Tridgell. Samba is now developed by the Samba Team as an Open Source

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

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>winbindd</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="winbindd"><a name="winbindd.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>winbindd &#8212; Name Service Switch daemon for resolving names
    2         from NT servers</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">winbindd</code> [-D] [-F] [-S] [-i] [-Y] [-d &lt;debug level&gt;] [-s &lt;smb config file&gt;] [-n]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id2489327"></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
     1<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.74.0"></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="id2483343"></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
    … …  
    1212        and system information to be obtained from different databases
    1313        services such as NIS or DNS.  The exact behaviour can be configured
    14         throught the <code class="filename">/etc/nsswitch.conf</code> file.
     14        through the <code class="filename">/etc/nsswitch.conf</code> file.
    1515        Users and groups are allocated as they are resolved to a range
    1616        of user and group ids specified by the administrator of the
    … …  
    6161        WINS server.</p><pre class="programlisting">
    6262hosts:          files wins
    63 </pre></div><div class="refsect1" title="OPTIONS"><a name="id2487531"></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="id2481550"></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" title="NAME AND ID RESOLUTION"><a name="id2487790"></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="id2481809"></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
    … …  
    128128        store is deleted or corrupted, there is no way for winbindd to
    129129        determine which user and group ids correspond to Windows NT user
    130         and group rids. </p></div><div class="refsect1" title="CONFIGURATION"><a name="id2487828"></a><h2>CONFIGURATION</h2><p>Configuration of the <code class="literal">winbindd</code> daemon
     130        and group rids. </p></div><div class="refsect1" lang="en"><a name="id2481847"></a><h2>CONFIGURATION</h2><p>Configuration of the <code class="literal">winbindd</code> daemon
    131131        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
    132         [global] section of smb.conf. </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
    133                 <a class="link" href="smb.conf.5.html#WINBINDSEPARATOR" target="_top">winbind separator</a></p></li><li class="listitem"><p>
    134                 <a class="link" href="smb.conf.5.html#IDMAPUID" target="_top">idmap uid</a></p></li><li class="listitem"><p>
    135                 <a class="link" href="smb.conf.5.html#IDMAPGID" target="_top">idmap gid</a></p></li><li class="listitem"><p>
    136                 <a class="link" href="smb.conf.5.html#IDMAPBACKEND" target="_top">idmap backend</a></p></li><li class="listitem"><p>
    137                 <a class="link" href="smb.conf.5.html#WINBINDCACHETIME" target="_top">winbind cache time</a></p></li><li class="listitem"><p>
    138                 <a class="link" href="smb.conf.5.html#WINBINDENUMUSERS" target="_top">winbind enum users</a></p></li><li class="listitem"><p>
    139                 <a class="link" href="smb.conf.5.html#WINBINDENUMGROUPS" target="_top">winbind enum groups</a></p></li><li class="listitem"><p>
    140                 <a class="link" href="smb.conf.5.html#TEMPLATEHOMEDIR" target="_top">template homedir</a></p></li><li class="listitem"><p>
    141                 <a class="link" href="smb.conf.5.html#TEMPLATESHELL" target="_top">template shell</a></p></li><li class="listitem"><p>
    142                 <a class="link" href="smb.conf.5.html#WINBINDUSEDEFAULTDOMAIN" target="_top">winbind use default domain</a></p></li><li class="listitem"><p>
     132        [global] section of smb.conf. </p><div class="itemizedlist"><ul type="disc"><li><p>
     133                <a class="link" href="smb.conf.5.html#WINBINDSEPARATOR" target="_top">winbind separator</a></p></li><li><p>
     134                <a class="link" href="smb.conf.5.html#IDMAPUID" target="_top">idmap uid</a></p></li><li><p>
     135                <a class="link" href="smb.conf.5.html#IDMAPGID" target="_top">idmap gid</a></p></li><li><p>
     136                <a class="link" href="smb.conf.5.html#IDMAPBACKEND" target="_top">idmap backend</a></p></li><li><p>
     137                <a class="link" href="smb.conf.5.html#WINBINDCACHETIME" target="_top">winbind cache time</a></p></li><li><p>
     138                <a class="link" href="smb.conf.5.html#WINBINDENUMUSERS" target="_top">winbind enum users</a></p></li><li><p>
     139                <a class="link" href="smb.conf.5.html#WINBINDENUMGROUPS" target="_top">winbind enum groups</a></p></li><li><p>
     140                <a class="link" href="smb.conf.5.html#TEMPLATEHOMEDIR" target="_top">template homedir</a></p></li><li><p>
     141                <a class="link" href="smb.conf.5.html#TEMPLATESHELL" target="_top">template shell</a></p></li><li><p>
     142                <a class="link" href="smb.conf.5.html#WINBINDUSEDEFAULTDOMAIN" target="_top">winbind use default domain</a></p></li><li><p>
    143143                <a class="link" href="smb.conf.5.html#WINBIND:RPCONLY" target="_top">winbind: rpc only</a>
    144144                Setting this parameter forces winbindd to use RPC
    145145                instead of LDAP to retrieve information from Domain
    146146                Controllers.
    147                 </p></li></ul></div></div><div class="refsect1" title="EXAMPLE SETUP"><a name="id2538487"></a><h2>EXAMPLE SETUP</h2><p>
     147                </p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2532502"></a><h2>EXAMPLE SETUP</h2><p>
    148148        To setup winbindd for user and group lookups plus
    149149        authentication from a domain controller use something like the
    … …  
    164164                  use_first_pass shadow nullok
    165165</pre><p>
    166         </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
     166        </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
    167167        The PAM module pam_unix has recently replaced the module pam_pwdb.
    168168        Some Linux systems use the module pam_unix2 in place of pam_unix.
    … …  
    196196        the DOMAIN+user syntax for the username. You may wish to use the
    197197        commands <code class="literal">getent passwd</code> and <code class="literal">getent group
    198         </code> to confirm the correct operation of winbindd.</p></div><div class="refsect1" title="NOTES"><a name="id2538677"></a><h2>NOTES</h2><p>The following notes are useful when configuring and
     198        </code> to confirm the correct operation of winbindd.</p></div><div class="refsect1" lang="en"><a name="id2532693"></a><h2>NOTES</h2><p>The following notes are useful when configuring and
    199199        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
    200200        for <code class="literal">winbindd</code> to work. </p><p>PAM is really easy to misconfigure.  Make sure you know what
    … …  
    204204        be the same.  The user and group ids will only be valid for the local
    205205        machine, unless a shared <a class="link" href="smb.conf.5.html#IDMAPBACKEND" target="_top">idmap backend</a> is configured.</p><p>If the the Windows NT SID to UNIX user and group id mapping
    206         file is damaged or destroyed then the mappings will be lost. </p></div><div class="refsect1" title="SIGNALS"><a name="id2538742"></a><h2>SIGNALS</h2><p>The following signals can be used to manipulate the
     206        file is damaged or destroyed then the mappings will be lost. </p></div><div class="refsect1" lang="en"><a name="id2532758"></a><h2>SIGNALS</h2><p>The following signals can be used to manipulate the
    207207        <code class="literal">winbindd</code> daemon. </p><div class="variablelist"><dl><dt><span class="term">SIGHUP</span></dt><dd><p>Reload the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file and
    208208                apply any parameter changes to the running
    … …  
    212212                winbindd</code> to write status information to the winbind
    213213                log file.</p><p>Log files are stored in the filename specified by the
    214                 log file parameter.</p></dd></dl></div></div><div class="refsect1" title="FILES"><a name="id2538805"></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
     214                log file parameter.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2532821"></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
    215215                the <code class="literal">winbindd</code> program.  For security reasons, the
    216216                winbind client will only attempt to connect to the winbindd daemon
    … …  
    233233                This directory is by default <code class="filename">/usr/local/samba/var/locks
    234234                </code>. </p></dd><dt><span class="term">$LOCKDIR/winbindd_cache.tdb</span></dt><dd><p>Storage for cached user and group information.
    235                 </p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id2538951"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
    236         the Samba suite.</p></div><div class="refsect1" title="SEE ALSO"><a name="id2538961"></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" title="AUTHOR"><a name="id2539017"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     235                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2532967"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
     236        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2532978"></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="id2533033"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    237237        were created by Andrew Tridgell. Samba is now developed
    238238        by the Samba Team as an Open Source project similar
Note: See TracChangeset for help on using the changeset viewer.