Ignore:
Timestamp:
Jun 24, 2009, 5:09:21 PM (16 years ago)
Author:
Herwig Bauernfeind
Message:

Update 3.0 to 3.0.35

Location:
branches/samba-3.0/docs/htmldocs/manpages
Files:
56 edited

Legend:

Unmodified
Added
Removed

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

    r158 r286  
    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.73.2"></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>
     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" lang="en"><a name="id290839"></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="id2483393"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.1.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(1)</span></a> suite.</p><p><code class="literal">eventlogadm</code> is a filter that accepts
    1010        formatted event log records on standard input and writes them
    1111        to the Samba event log store. Windows client can then manipulate
    12         these record using the usual administration tools.</p></div><div class="refsect1" lang="en"><a name="id258937"></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="id2483538"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term"><code class="option">-d</code></span></dt><dd><p>
    1313                The <code class="literal">-d</code> option causes <code class="literal">eventlogadm</code> to emit debugging
    1414                information.
    … …  
    3232                </p></dd><dt><span class="term"><code class="option">-h</code></span></dt><dd><p>
    3333                Print usage information.
    34                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id259051"></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="id2483654"></a><h2>EVENTLOG RECORD FORMAT</h2><p>For the write operation, <code class="literal">eventlogadm</code>
    3535        expects to be able to read structured records from standard
    3636        input. These records are a sequence of lines, with the record key
    … …  
    8181                </p></li><li><p>
    8282                <code class="literal">DAT</code> - This field should be left unset.
    83                 </p></li></ul></div></div><div class="refsect1" lang="en"><a name="id299775"></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="id2481525"></a><h2>EXAMPLES</h2><p>An example of the record format accepted by <code class="literal">eventlogadm</code>:</p><pre class="programlisting">
    8484        LEN: 0
    8585        RS1: 1699505740
    … …  
    104104                my_program_to_parse_into_eventlog_records | \\
    105105                eventlogadm SystemLogEvents
    106         </pre></div><div class="refsect1" lang="en"><a name="id299816"></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="id299826"></a><h2>AUTHOR</h2><p> The original Samba software and related utilities were
     106        </pre></div><div class="refsect1" lang="en"><a name="id2481575"></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="id2481586"></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.0/docs/htmldocs/manpages/findsmb.1.html

    r158 r286  
    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.73.2"></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="id258177"></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="id2522937"></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" lang="en"><a name="id290798"></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="id2483352"></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" lang="en"><a name="id258940"></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="id2483543"></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" lang="en"><a name="id259027"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
    52         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id259038"></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="id2483644"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
     52        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2483656"></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" lang="en"><a name="id258238"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     54        </p></div><div class="refsect1" lang="en"><a name="id2483689"></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.0/docs/htmldocs/manpages/index.html

    r158 r286  
    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.73.2"></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="eventlogadm.8.html" target="_top">eventlogadm(8)</a></span></dt><dd><p>push records into the Samba event log store
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title></title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.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)
     2</p></dd><dt><span class="term"><a class="ulink" href="eventlogadm.8.html" target="_top">eventlogadm(8)</a></span></dt><dd><p>push records into the Samba event log store
    23</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
    34        name queries on a subnet
    … …  
    2728</p></dd><dt><span class="term"><a class="ulink" href="samba.7.html" target="_top">samba(7)</a></span></dt><dd><p>A Windows SMB/CIFS fileserver for UNIX
    2829</p></dd><dt><span class="term"><a class="ulink" href="smbcacls.1.html" target="_top">smbcacls(1)</a></span></dt><dd><p>Set or get ACLs on an NT file or directory names
    29 </p></dd><dt><span class="term"><a class="ulink" href="smbclient.1.html" target="_top">smbclient(1)</a></span></dt><dd><p>ftp-like client to access SMB/CIFS resources 
     30</p></dd><dt><span class="term"><a class="ulink" href="smbclient.1.html" target="_top">smbclient(1)</a></span></dt><dd><p>ftp-like client to access SMB/CIFS resources
    3031        on servers
    3132</p></dd><dt><span class="term"><a class="ulink" href="smb.conf.5.html" target="_top">smb.conf(5)</a></span></dt><dd><p>The configuration file for the Samba suite

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

    r158 r286  
    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.73.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="libsmbclient.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>libsmbclient &#8212; An extension library for browsers and that can be used as a generic browsing API.</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">Browser URL:</code><p>
     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><code class="literal">Browser URL:</code><p>
    22        smb://[[[domain:]user[:password@]]server[/share[/path[/file]]]] [?options]
    3     </p></p></div></div><div class="refsect1" lang="en"><a name="id258174"></a><h2>DESCRIPTION</h2><p>
     3    </p></p></div></div><div class="refsect1" lang="en"><a name="id2522934"></a><h2>DESCRIPTION</h2><p>
    44        This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.
    55        </p><p>
    … …  
    1313        extension of the capabilities of tools such as file managers and browsers.  This man page describes the
    1414        configuration options for this tool so that the user may obtain greatest utility of use.
    15         </p></div><div class="refsect1" lang="en"><a name="id290796"></a><h2>OPTIONS</h2><p>
     15        </p></div><div class="refsect1" lang="en"><a name="id2483355"></a><h2>OPTIONS</h2><p>
    1616        What the URLs mean:
    1717        </p><div class="variablelist"><dl><dt><span class="term">smb://</span></dt><dd><p>
    … …  
    4545        parameter and will use its value when if the <code class="literal">user</code> parameter was not included
    4646        in the URL.
    47         </p></div><div class="refsect1" lang="en"><a name="id258984"></a><h2>PROGRAMMERS GUIDE</h2><p>
     47        </p></div><div class="refsect1" lang="en"><a name="id2483610"></a><h2>PROGRAMMERS GUIDE</h2><p>
    4848        Watch this space for future updates.
    49         </p></div><div class="refsect1" lang="en"><a name="id258994"></a><h2>VERSION</h2><p>
     49        </p></div><div class="refsect1" lang="en"><a name="id2483621"></a><h2>VERSION</h2><p>
    5050        This man page is correct for version 3.0 of the Samba suite.
    51         </p></div><div class="refsect1" lang="en"><a name="id259004"></a><h2>AUTHOR</h2><p>
     51        </p></div><div class="refsect1" lang="en"><a name="id2483632"></a><h2>AUTHOR</h2><p>
    5252        The original Samba software and related utilities were created by Andrew Tridgell.
    5353        Samba is now developed by the Samba Team as an Open Source project similar to the way

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

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>lmhosts</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258175"></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="id2522932"></a><h2>DESCRIPTION</h2><p>This file is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="filename">lmhosts</code> is the <span class="emphasis"><em>Samba
    22        </em></span> NetBIOS name to IP address mapping file.  It
    33        is very similar to the <code class="filename">/etc/hosts</code> file
    44        format, except that the hostname component must correspond
    5         to the NetBIOS naming format.</p></div><div class="refsect1" lang="en"><a name="id290790"></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="id2483344"></a><h2>FILE FORMAT</h2><p>It is an ASCII file containing one line for NetBIOS name.
    66        The two fields on each line are separated from each other by
    77        white space. Any entry beginning with '#' is ignored. Each line
    … …  
    2626        type for a name "NTSERVER" is queried. Any other name type will not
    2727        be resolved.</p><p>The default location of the <code class="filename">lmhosts</code> file
    28         is in the same directory as the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file.</p></div><div class="refsect1" lang="en"><a name="id258930"></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="id2483540"></a><h2>FILES</h2><p>lmhosts is loaded from the configuration directory. This is
    2929                usually <code class="filename">/etc/samba</code> or <code class="filename">/usr/local/samba/lib</code>.
    30         </p></div><div class="refsect1" lang="en"><a name="id258952"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id258962"></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="id258995"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     30        </p></div><div class="refsect1" lang="en"><a name="id2483562"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2483573"></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="id2483608"></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.0/docs/htmldocs/manpages/log2pcap.1.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>log2pcap</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id290779"></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="id2522958"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">log2pcap</code> reads in a
    22        samba log file and generates a pcap file (readable
    33        by most sniffers, such as ethereal or tcpdump) based on the packet
    … …  
    66        right, <code class="constant">10</code> to get the first 512 data bytes of the
    77        packet and <code class="constant">50</code> to get the whole packet.
    8         </p></div><div class="refsect1" lang="en"><a name="id290825"></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="id2483381"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h</span></dt><dd><p>If this parameter is
    99                specified the output file will be a
    1010                hex dump, in a format that is readable
    … …  
    1818                to stdout.
    1919                </p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    20 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id258969"></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="id2483576"></a><h2>EXAMPLES</h2><p>Extract all network traffic from all samba log files:</p><pre class="programlisting">
    2121                        <code class="prompt">$</code> log2pcap &lt; /var/log/* &gt; trace.pcap
    2222        </pre><p>Convert to pcap using text2pcap:</p><pre class="programlisting">
    2323        <code class="prompt">$</code> log2pcap -h samba.log | text2pcap -T 139,139 - trace.pcap
    24         </pre></div><div class="refsect1" lang="en"><a name="id259007"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id259016"></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="id2483617"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2483628"></a><h2>BUGS</h2><p>Only SMB data is extracted from the samba logs, no LDAP,
    2525        NetBIOS lookup or other data.</p><p>The generated TCP and IP headers don't contain a valid
    26         checksum.</p></div><div class="refsect1" lang="en"><a name="id259031"></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="id259054"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     26        checksum.</p></div><div class="refsect1" lang="en"><a name="id2483645"></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="id2483667"></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.0/docs/htmldocs/manpages/mount.cifs.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>mount.cifs</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258193"></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="id2522954"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>mount.cifs mounts a Linux CIFS filesystem. It
    22is usually invoked indirectly by
    33the <a class="citerefentry" href="mount.8.html"><span class="citerefentry"><span class="refentrytitle">mount</span>(8)</span></a> command when using the
    … …  
    2121        </p><p><span class="emphasis"><em>mount.cifs</em></span> causes the cifs vfs to launch a thread named cifsd. After mounting it keeps running until
    2222                the mounted resource is unmounted (usually via the umount utility).
    23         </p></div><div class="refsect1" lang="en"><a name="id290829"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">user=<em class="replaceable"><code>arg</code></em></span></dt><dd><p>specifies the username to connect as. If
     23        </p></div><div class="refsect1" lang="en"><a name="id2483393"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">user=<em class="replaceable"><code>arg</code></em></span></dt><dd><p>specifies the username to connect as. If
    2424                                this is not given, then the environment variable <span class="emphasis"><em>USER</em></span> is used. This option can also take the
    2525form "user%password" or "workgroup/user" or
    … …  
    3030        </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
    3131option is not given then the environment variable
    32 <span class="emphasis"><em>PASSWD</em></span> is used. If the password is not specified 
     32<span class="emphasis"><em>PASSWD</em></span> is used. If the password is not specified
    3333directly or indirectly via an argument to mount, <span class="emphasis"><em>mount.cifs</em></span> will prompt
    3434for a password, unless the guest option is specified.
    … …  
    4040</p></dd><dt><span class="term">credentials=<em class="replaceable"><code>filename</code></em></span></dt><dd><p>
    4141                                specifies a file that contains a username
    42                                 and/or password. The format of the file is:
     42                                and/or password and optionally the name of the
     43                                workgroup. The format of the file is:
    4344                        </p><pre class="programlisting">
    4445                username=<em class="replaceable"><code>value</code></em>
    4546                password=<em class="replaceable"><code>value</code></em>
     47                workgroup=<em class="replaceable"><code>value</code></em>
    4648</pre><p>
    4749This is preferred over having passwords in plaintext in a
    … …  
    214216                </p></dd><dt><span class="term">wsize=<em class="replaceable"><code>arg</code></em></span></dt><dd><p>default network write size (default 57344)
    215217                maximum wsize currently allowed by CIFS is 57344 (fourteen
    216                 4096 byte pages)</p></dd><dt><span class="term">--verbose</span></dt><dd><p>Print additional debugging information for the mount. Note that this parameter must be specified before the -o. For example:</p><p>mount -t cifs //server/share /mnt --verbose -o user=username</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id300200"></a><h2>SERVICE FORMATTING AND DELIMITERS</h2><p>
     218                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="id2532635"></a><h2>SERVICE FORMATTING AND DELIMITERS</h2><p>
    217219                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.
    218220        </p><p>
    219221                mount.cifs will attempt to convert backslashes to forward slashes where it's able to do so, but it cannot do so in any path component following the sharename.
    220         </p></div><div class="refsect1" lang="en"><a name="id300218"></a><h2>ENVIRONMENT VARIABLES</h2><p>
     222        </p></div><div class="refsect1" lang="en"><a name="id2532658"></a><h2>ENVIRONMENT VARIABLES</h2><p>
    221223                The variable <span class="emphasis"><em>USER</em></span> may contain the username of the
    222224person to be used to authenticate to the server.
    … …  
    230232of a file to read the password from. A single line of input is
    231233read and used as the password.
    232         </p></div><div class="refsect1" lang="en"><a name="id300247"></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="id300258"></a><h2>CONFIGURATION</h2><p>
     234        </p></div><div class="refsect1" lang="en"><a name="id2532690"></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="id2532702"></a><h2>CONFIGURATION</h2><p>
    233235The primary mechanism for making configuration changes and for reading
    234236debug information for the cifs vfs is via the Linux /proc filesystem.
    … …  
    241243installation (device driver load).
    242244For more information see the kernel file <code class="filename">fs/cifs/README</code>.
    243 </p></div><div class="refsect1" lang="en"><a name="id300283"></a><h2>BUGS</h2><p>Mounting using the CIFS URL specification is currently not supported.
     245</p></div><div class="refsect1" lang="en"><a name="id2532733"></a><h2>BUGS</h2><p>Mounting using the CIFS URL specification is currently not supported.
    244246        </p><p>The credentials file does not handle usernames or passwords with
    245247                leading space.</p><p>
    … …  
    249251when reporting bugs (minimum: mount.cifs (try mount.cifs -V), kernel (see /proc/version) and
    250252server type you are trying to contact.
    251 </p></div><div class="refsect1" lang="en"><a name="id300304"></a><h2>VERSION</h2><p>This man page is correct for version 1.52 of
    252         the cifs vfs filesystem (roughly Linux kernel 2.6.24).</p></div><div class="refsect1" lang="en"><a name="id300314"></a><h2>SEE ALSO</h2><p>
     253</p></div><div class="refsect1" lang="en"><a name="id2532757"></a><h2>VERSION</h2><p>This man page is correct for version 1.52 of
     254        the cifs vfs filesystem (roughly Linux kernel 2.6.24).</p></div><div class="refsect1" lang="en"><a name="id2532769"></a><h2>SEE ALSO</h2><p>
    253255        Documentation/filesystems/cifs.txt and fs/cifs/README in the linux kernel
    254256        source tree may contain additional options and information.
    255 </p><p><a class="citerefentry" href="umount.cifs.8.html"><span class="citerefentry"><span class="refentrytitle">umount.cifs</span>(8)</span></a></p></div><div class="refsect1" lang="en"><a name="id300334"></a><h2>AUTHOR</h2><p>Steve French</p><p>The syntax and manpage were loosely based on that of smbmount. It
     257</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="id2532789"></a><h2>AUTHOR</h2><p>Steve French</p><p>The syntax and manpage were loosely based on that of smbmount. It
    256258                was converted to Docbook/XML by Jelmer Vernooij.</p><p>The maintainer of the Linux cifs vfs and the userspace
    257259                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.0/docs/htmldocs/manpages/net.8.html

    r158 r286  
    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.73.2"></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
     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"><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]</p></div></div><div class="refsect1" lang="en"><a name="id290856"></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]</p></div></div><div class="refsect1" lang="en"><a name="id2483410"></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" lang="en"><a name="id258951"></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="id2483554"></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
    … …  
    2525                </p></dd><dt><span class="term">-n &lt;primary NetBIOS name&gt;</span></dt><dd><p>This option allows you to override
    2626the NetBIOS name that Samba uses for itself. This is identical
    27 to setting the <a class="link" href="smb.conf.5.html#NETBIOSNAME">netbios name</a> parameter in the <code class="filename">smb.conf</code> file.
     27to setting the <a class="link" href="smb.conf.5.html#NETBIOSNAME" target="_top">netbios name</a> parameter in the <code class="filename">smb.conf</code> file.
    2828However, a command
    2929line setting will take precedence over settings in
    … …  
    5454use only by developers and generate HUGE amounts of log
    5555data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
    56 override the <a class="link" href="smb.conf.5.html#LOGLEVEL">log level</a> parameter
    57 in the <code class="filename">smb.conf</code> file.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id299800"></a><h2>COMMANDS</h2><div class="refsect2" lang="en"><a name="id299805"></a><h3>CHANGESECRETPW</h3><p>This command allows the Samba machine account password to be set from an external application
     56override the <a class="link" href="smb.conf.5.html#LOGLEVEL" target="_top">log level</a> parameter
     57in the <code class="filename">smb.conf</code> file.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481566"></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
    5858to a machine account password that has already been stored in Active Directory. DO NOT USE this command
    5959unless you know exactly what you are doing. The use of this command requires that the force flag (-f)
    … …  
    6262this without care and attention as it will overwrite a legitimate machine password without warning.
    6363YOU HAVE BEEN WARNED.
    64 </p></div><div class="refsect2" lang="en"><a name="id299820"></a><h3>TIME</h3><p>The <code class="literal">NET TIME</code> command allows you to view the time on a remote server
    65         or synchronise the time on the local server with the time on the remote server.</p><div class="refsect3" lang="en"><a name="id299835"></a><h4>TIME</h4><p>Without any options, the <code class="literal">NET TIME</code> command
     64</p></div><div class="refsect2" lang="en"><a name="id2481593"></a><h3>TIME</h3><p>The <code class="literal">NET TIME</code> command allows you to view the time on a remote server
     65        or synchronise the time on the local server with the time on the remote server.</p><div class="refsect3" lang="en"><a name="id2481610"></a><h4>TIME</h4><p>Without any options, the <code class="literal">NET TIME</code> command
    6666displays the time on the remote server.
    67 </p></div><div class="refsect3" lang="en"><a name="id299850"></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="id299866"></a><h4>TIME SET</h4><p>Tries to set the date and time of the local server to that on
    68 the remote server using <code class="literal">/bin/date</code>. </p></div><div class="refsect3" lang="en"><a name="id299881"></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="id299893"></a><h3>[RPC|ADS] JOIN [TYPE] [-U username[%password]] [createupn=UPN] [createcomputer=OU] [options]</h3><p>
     67</p></div><div class="refsect3" lang="en"><a name="id2481626"></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="id2481643"></a><h4>TIME SET</h4><p>Tries to set the date and time of the local server to that on
     68the remote server using <code class="literal">/bin/date</code>. </p></div><div class="refsect3" lang="en"><a name="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>
    6969Join a domain.  If the account already exists on the server, and
    7070[TYPE] is MEMBER, the machine will attempt to join automatically.
    … …  
    8383and ldap, so it may need to be doubled or quadrupled to pass through,
    8484and it is not used as a delimiter.
    85 </p></div><div class="refsect2" lang="en"><a name="id299920"></a><h3>[RPC] OLDJOIN [options]</h3><p>Join a domain. Use the OLDJOIN option to join the domain
     85</p></div><div class="refsect2" lang="en"><a name="id2481707"></a><h3>[RPC] OLDJOIN [options]</h3><p>Join a domain. Use the OLDJOIN option to join the domain
    8686using the old style of domain joining - you need to create a trust
    87 account in server manager first.</p></div><div class="refsect2" lang="en"><a name="id299931"></a><h3>[RPC|ADS] USER</h3><div class="refsect3" lang="en"><a name="id299936"></a><h4>[RPC|ADS] USER</h4><p>List all users</p></div><div class="refsect3" lang="en"><a name="id299946"></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="id299958"></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="id299969"></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="id299984"></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="id299998"></a><h3>[RPC|ADS] GROUP</h3><div class="refsect3" lang="en"><a name="id300003"></a><h4>[RPC|ADS] GROUP [misc options] [targets]</h4><p>List user groups.</p></div><div class="refsect3" lang="en"><a name="id300013"></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="id300026"></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="id300040"></a><h3>[RAP|RPC] SHARE</h3><div class="refsect3" lang="en"><a name="id300045"></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="id300055"></a><h4>[RAP|RPC] SHARE ADD <em class="replaceable"><code>name=serverpath</code></em> [-C comment] [-M maxusers] [targets]</h4><p>Adds a share from a server (makes the export active). Maxusers
     87account in server manager first.</p></div><div class="refsect2" lang="en"><a name="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="id2481776"></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="id2481791"></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="id2481821"></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="id2481853"></a><h4>[RAP|RPC] SHARE ADD <em class="replaceable"><code>name=serverpath</code></em> [-C comment] [-M maxusers] [targets]</h4><p>Adds a share from a server (makes the export active). Maxusers
    8888specifies the number of users that can be connected to the
    89 share simultaneously.</p></div><div class="refsect3" lang="en"><a name="id300069"></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="id300082"></a><h3>[RPC|RAP] FILE</h3><div class="refsect3" lang="en"><a name="id300088"></a><h4>[RPC|RAP] FILE</h4><p>List all open files on remote server.</p></div><div class="refsect3" lang="en"><a name="id300097"></a><h4>[RPC|RAP] FILE CLOSE <em class="replaceable"><code>fileid</code></em></h4><p>Close file with specified <em class="replaceable"><code>fileid</code></em> on
    90 remote server.</p></div><div class="refsect3" lang="en"><a name="id300112"></a><h4>[RPC|RAP] FILE INFO <em class="replaceable"><code>fileid</code></em></h4><p>
     89share simultaneously.</p></div><div class="refsect3" lang="en"><a name="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="id2481883"></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
     90remote 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>
    9191Print information on specified <em class="replaceable"><code>fileid</code></em>.
    9292Currently listed are: file-id, username, locks, path, permissions.
    93 </p></div><div class="refsect3" lang="en"><a name="id300128"></a><h4>[RAP|RPC] FILE USER <em class="replaceable"><code>user</code></em></h4><p>
     93</p></div><div class="refsect3" lang="en"><a name="id2481932"></a><h4>[RAP|RPC] FILE USER <em class="replaceable"><code>user</code></em></h4><p>
    9494List files opened by specified <em class="replaceable"><code>user</code></em>.
    9595Please note that <code class="literal">net rap file user</code> does not work
    9696against Samba servers.
    97 </p></div></div><div class="refsect2" lang="en"><a name="id300149"></a><h3>SESSION</h3><div class="refsect3" lang="en"><a name="id300154"></a><h4>RAP SESSION</h4><p>Without any other options, SESSION enumerates all active SMB/CIFS
    98 sessions on the target server.</p></div><div class="refsect3" lang="en"><a name="id300165"></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="id300176"></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="id300190"></a><h3>RAP SERVER <em class="replaceable"><code>DOMAIN</code></em></h3><p>List all servers in specified domain or workgroup. Defaults
    99 to local domain.</p></div><div class="refsect2" lang="en"><a name="id300202"></a><h3>RAP DOMAIN</h3><p>Lists all domains and workgroups visible on the
    100 current network.</p></div><div class="refsect2" lang="en"><a name="id300213"></a><h3>RAP PRINTQ</h3><div class="refsect3" lang="en"><a name="id300218"></a><h4>RAP PRINTQ LIST <em class="replaceable"><code>QUEUE_NAME</code></em></h4><p>Lists the specified print queue and print jobs on the server.
     97</p></div></div><div class="refsect2" lang="en"><a name="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
     98sessions on the target server.</p></div><div class="refsect3" lang="en"><a name="id2481973"></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="id2481985"></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
     99to 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
     100current network.</p></div><div class="refsect2" lang="en"><a name="id2482025"></a><h3>RAP PRINTQ</h3><div class="refsect3" lang="en"><a name="id2482030"></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.
    101101If the <em class="replaceable"><code>QUEUE_NAME</code></em> is omitted, all
    102 queues are listed.</p></div><div class="refsect3" lang="en"><a name="id300234"></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="id300246"></a><h3>RAP VALIDATE <em class="replaceable"><code>user</code></em> [<em class="replaceable"><code>password</code></em>]</h3><p>
     102queues are listed.</p></div><div class="refsect3" lang="en"><a name="id2482048"></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>
    103103Validate whether the specified user can log in to the
    104104remote server. If the password is not specified on the commandline, it
    105105will be prompted.
    106 </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div><div class="refsect2" lang="en"><a name="id300268"></a><h3>RAP GROUPMEMBER</h3><div class="refsect3" lang="en"><a name="id300273"></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="id300285"></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="id300300"></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="id300316"></a><h3>RAP ADMIN <em class="replaceable"><code>command</code></em></h3><p>Execute the specified <em class="replaceable"><code>command</code></em> on
     106</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div><div class="refsect2" lang="en"><a name="id2532548"></a><h3>RAP GROUPMEMBER</h3><div class="refsect3" lang="en"><a name="id2532553"></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
    107107the remote server. Only works with OS/2 servers.
    108 </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div><div class="refsect2" lang="en"><a name="id300335"></a><h3>RAP SERVICE</h3><div class="refsect3" lang="en"><a name="id300341"></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="id300358"></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="id300373"></a><h3>RAP PASSWORD <em class="replaceable"><code>USER</code></em> <em class="replaceable"><code>OLDPASS</code></em> <em class="replaceable"><code>NEWPASS</code></em></h3><p>
     108</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div><div class="refsect2" lang="en"><a name="id2532617"></a><h3>RAP SERVICE</h3><div class="refsect3" lang="en"><a name="id2532622"></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>
    109109Change password of <em class="replaceable"><code>USER</code></em> from <em class="replaceable"><code>OLDPASS</code></em> to <em class="replaceable"><code>NEWPASS</code></em>.
    110 </p></div><div class="refsect2" lang="en"><a name="id300401"></a><h3>LOOKUP</h3><div class="refsect3" lang="en"><a name="id300406"></a><h4>LOOKUP HOST <em class="replaceable"><code>HOSTNAME</code></em> [<em class="replaceable"><code>TYPE</code></em>]</h4><p>
     110</p></div><div class="refsect2" lang="en"><a name="id2532684"></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>
    111111Lookup the IP address of the given host with the specified type (netbios suffix).
    112112The type defaults to 0x20 (workstation).
    113 </p></div><div class="refsect3" lang="en"><a name="id300424"></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="id300440"></a><h4>LOOKUP KDC [<em class="replaceable"><code>REALM</code></em>]</h4><p>Give IP address of KDC for the specified <em class="replaceable"><code>REALM</code></em>.
    114 Defaults to local realm.</p></div><div class="refsect3" lang="en"><a name="id300456"></a><h4>LOOKUP DC [<em class="replaceable"><code>DOMAIN</code></em>]</h4><p>Give IP's of Domain Controllers for specified <em class="replaceable"><code>
    115 DOMAIN</code></em>. Defaults to local domain.</p></div><div class="refsect3" lang="en"><a name="id300472"></a><h4>LOOKUP MASTER <em class="replaceable"><code>DOMAIN</code></em></h4><p>Give IP of master browser for specified <em class="replaceable"><code>DOMAIN</code></em>
    116 or workgroup. Defaults to local domain.</p></div></div><div class="refsect2" lang="en"><a name="id300488"></a><h3>CACHE</h3><p>Samba uses a general caching interface called 'gencache'. It
     113</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>.
     114Defaults 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>
     115DOMAIN</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>
     116or 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
    117117can be controlled using 'NET CACHE'.</p><p>All the timeout parameters support the suffixes:
    118118
    119119</p><table class="simplelist" border="0" summary="Simple list"><tr><td>s - Seconds</td></tr><tr><td>m - Minutes</td></tr><tr><td>h - Hours</td></tr><tr><td>d - Days</td></tr><tr><td>w - Weeks</td></tr></table><p>
    120120
    121 </p><div class="refsect3" lang="en"><a name="id300521"></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="id300540"></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="id300552"></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="id300570"></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="id300582"></a><h4>CACHE LIST</h4><p>
     121</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="id2532874"></a><h4>CACHE LIST</h4><p>
    122122List all current items in the cache.
    123 </p></div><div class="refsect3" lang="en"><a name="id300591"></a><h4>CACHE FLUSH</h4><p>Remove all the current items from the cache.</p></div></div><div class="refsect2" lang="en"><a name="id300602"></a><h3>GETLOCALSID [DOMAIN]</h3><p>Prints the SID of the specified domain, or if the parameter is
    124 omitted, the SID of the local server.</p></div><div class="refsect2" lang="en"><a name="id300613"></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="id300622"></a><h3>GETDOMAINSID</h3><p>Prints the local machine SID and the SID of the current
    125 domain.</p></div><div class="refsect2" lang="en"><a name="id300632"></a><h3>SETDOMAINSID</h3><p>Sets the SID of the current domain.</p></div><div class="refsect2" lang="en"><a name="id300642"></a><h3>GROUPMAP</h3><p>Manage the mappings between Windows group SIDs and UNIX groups.
     123</p></div><div class="refsect3" lang="en"><a name="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="id2532896"></a><h3>GETLOCALSID [DOMAIN]</h3><p>Prints the SID of the specified domain, or if the parameter is
     124omitted, the SID of the local server.</p></div><div class="refsect2" lang="en"><a name="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="id2532918"></a><h3>GETDOMAINSID</h3><p>Prints the local machine SID and the SID of the current
     125domain.</p></div><div class="refsect2" lang="en"><a name="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.
    126126Common options include:</p><div class="itemizedlist"><ul type="disc"><li><p>unixgroup - Name of the UNIX group</p></li><li><p>ntgroup - Name of the Windows NT group (must be
    127127  resolvable to a SID</p></li><li><p>rid - Unsigned 32-bit integer</p></li><li><p>sid - Full SID in the form of "S-1-..."</p></li><li><p>type - Type of the group; either 'domain', 'local',
    128   or 'builtin'</p></li><li><p>comment - Freeform text description of the group</p></li></ul></div><div class="refsect3" lang="en"><a name="id300682"></a><h4>GROUPMAP ADD</h4><p>
     128  or 'builtin'</p></li><li><p>comment - Freeform text description of the group</p></li></ul></div><div class="refsect3" lang="en"><a name="id2532982"></a><h4>GROUPMAP ADD</h4><p>
    129129Add a new group mapping entry:
    130130</p><pre class="programlisting">
    … …  
    132132        [type={domain|local}] [ntgroup=string] [comment=string]
    133133</pre><p>
    134 </p></div><div class="refsect3" lang="en"><a name="id300697"></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="id300711"></a><h4>GROUPMAP MODIFY</h4><p>Update en existing group entry.</p><p>
     134</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="id2533014"></a><h4>GROUPMAP MODIFY</h4><p>Update en existing group entry.</p><p>
    135135</p><pre class="programlisting">
    136136net groupmap modify {ntgroup=string|sid=SID} [unixgroup=string] \
    137137       [comment=string] [type={domain|local}]
    138138</pre><p>
    139 </p></div><div class="refsect3" lang="en"><a name="id300730"></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="id300744"></a><h3>MAXRID</h3><p>Prints out the highest RID currently in use on the local
     139</p></div><div class="refsect3" lang="en"><a name="id2533034"></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
    140140server (by the active 'passdb backend').
    141 </p></div><div class="refsect2" lang="en"><a name="id300755"></a><h3>RPC INFO</h3><p>Print information about the domain of the remote server,
     141</p></div><div class="refsect2" lang="en"><a name="id2533061"></a><h3>RPC INFO</h3><p>Print information about the domain of the remote server,
    142142such as domain name, domain sid and number of users and groups.
    143 </p></div><div class="refsect2" lang="en"><a name="id300765"></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="id300775"></a><h3>[RPC|ADS] CHANGETRUSTPW</h3><p>Force change of domain trust password.</p></div><div class="refsect2" lang="en"><a name="id300785"></a><h3>RPC TRUSTDOM</h3><div class="refsect3" lang="en"><a name="id300790"></a><h4>RPC TRUSTDOM ADD <em class="replaceable"><code>DOMAIN</code></em></h4><p>Add a interdomain trust account for <em class="replaceable"><code>DOMAIN</code></em>.
     143</p></div><div class="refsect2" lang="en"><a name="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>.
    144144This is in fact a Samba account named <em class="replaceable"><code>DOMAIN$</code></em>
    145145with the account flag <code class="constant">'I'</code> (interdomain trust account).
    … …  
    147147<code class="literal">smbpasswd -a -i DOMAIN</code>. Please note that both commands
    148148expect a appropriate UNIX account.
    149 </p></div><div class="refsect3" lang="en"><a name="id300818"></a><h4>RPC TRUSTDOM DEL <em class="replaceable"><code>DOMAIN</code></em></h4><p>Remove interdomain trust account for
     149</p></div><div class="refsect3" lang="en"><a name="id2533131"></a><h4>RPC TRUSTDOM DEL <em class="replaceable"><code>DOMAIN</code></em></h4><p>Remove interdomain trust account for
    150150<em class="replaceable"><code>DOMAIN</code></em>. If it is used against localhost
    151151it has the same effect as <code class="literal">smbpasswd -x DOMAIN$</code>.
    152 </p></div><div class="refsect3" lang="en"><a name="id300839"></a><h4>RPC TRUSTDOM ESTABLISH <em class="replaceable"><code>DOMAIN</code></em></h4><p>
     152</p></div><div class="refsect3" lang="en"><a name="id2533153"></a><h4>RPC TRUSTDOM ESTABLISH <em class="replaceable"><code>DOMAIN</code></em></h4><p>
    153153Establish a trust relationship to a trusting domain.
    154154Interdomain account must already be created on the remote PDC.
    155 </p></div><div class="refsect3" lang="en"><a name="id300852"></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="id300863"></a><h4>RPC TRUSTDOM LIST</h4><p>List all current interdomain trust relationships.</p></div><div class="refsect3" lang="en"><a name="id300873"></a><h4>RPC RIGHTS</h4><p>This subcommand is used to view and manage Samba's rights assignments (also
     155</p></div><div class="refsect3" lang="en"><a name="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="id2533179"></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
    156156referred to as privileges).  There are three options currently available:
    157157<em class="parameter"><code>list</code></em>, <em class="parameter"><code>grant</code></em>, and
    158158<em class="parameter"><code>revoke</code></em>.  More details on Samba's privilege model and its use
    159 can be found in the Samba-HOWTO-Collection.</p></div></div><div class="refsect2" lang="en"><a name="id300902"></a><h3>RPC ABORTSHUTDOWN</h3><p>Abort the shutdown of a remote server.</p></div><div class="refsect2" lang="en"><a name="id300911"></a><h3>RPC SHUTDOWN [-t timeout] [-r] [-f] [-C message]</h3><p>Shut down the remote server.</p><div class="variablelist"><dl><dt><span class="term">-r</span></dt><dd><p>
     159can be found in the Samba-HOWTO-Collection.</p></div></div><div class="refsect2" lang="en"><a name="id2533220"></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>
    160160Reboot after shutdown.
    161161</p></dd><dt><span class="term">-f</span></dt><dd><p>
    … …  
    165165user of the system can use this time to cancel the shutdown.
    166166</p></dd><dt><span class="term">-C message</span></dt><dd><p>Display the specified message on the screen to
    167 announce the shutdown.</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id300968"></a><h3>RPC SAMDUMP</h3><p>Print out sam database of remote server. You need
    168 to run this against the PDC, from a Samba machine joined as a BDC. </p></div><div class="refsect2" lang="en"><a name="id300979"></a><h3>RPC VAMPIRE</h3><p>Export users, aliases and groups from remote server to
     167announce the shutdown.</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2533292"></a><h3>RPC SAMDUMP</h3><p>Print out sam database of remote server. You need
     168to run this against the PDC, from a Samba machine joined as a BDC. </p></div><div class="refsect2" lang="en"><a name="id2533303"></a><h3>RPC VAMPIRE</h3><p>Export users, aliases and groups from remote server to
    169169local server.  You need to run this against the PDC, from a Samba machine joined as a BDC.
    170 </p></div><div class="refsect2" lang="en"><a name="id300990"></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="id301005"></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="id301014"></a><h3>ADS STATUS</h3><p>Print out status of machine account of the local machine in ADS.
     170</p></div><div class="refsect2" lang="en"><a name="id2533316"></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="id2533331"></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="id2533342"></a><h3>ADS STATUS</h3><p>Print out status of machine account of the local machine in ADS.
    171171Prints out quite some debug info. Aimed at developers, regular
    172 users should use <code class="literal">NET ADS TESTJOIN</code>.</p></div><div class="refsect2" lang="en"><a name="id301031"></a><h3>ADS PRINTER</h3><div class="refsect3" lang="en"><a name="id301036"></a><h4>ADS PRINTER INFO [<em class="replaceable"><code>PRINTER</code></em>] [<em class="replaceable"><code>SERVER</code></em>]</h4><p>
     172users should use <code class="literal">NET ADS TESTJOIN</code>.</p></div><div class="refsect2" lang="en"><a name="id2533359"></a><h3>ADS PRINTER</h3><div class="refsect3" lang="en"><a name="id2533364"></a><h4>ADS PRINTER INFO [<em class="replaceable"><code>PRINTER</code></em>] [<em class="replaceable"><code>SERVER</code></em>]</h4><p>
    173173Lookup info for <em class="replaceable"><code>PRINTER</code></em> on <em class="replaceable"><code>SERVER</code></em>. The printer name defaults to "*", the
    174 server name defaults to the local host.</p></div><div class="refsect3" lang="en"><a name="id301059"></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="id301071"></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="id301084"></a><h3>ADS SEARCH <em class="replaceable"><code>EXPRESSION</code></em> <em class="replaceable"><code>ATTRIBUTES...</code></em></h3><p>Perform a raw LDAP search on a ADS server and dump the results. The
     174server name defaults to the local host.</p></div><div class="refsect3" lang="en"><a name="id2533388"></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="id2533401"></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="id2533415"></a><h3>ADS SEARCH <em class="replaceable"><code>EXPRESSION</code></em> <em class="replaceable"><code>ATTRIBUTES...</code></em></h3><p>Perform a raw LDAP search on a ADS server and dump the results. The
    175175expression is a standard LDAP search expression, and the
    176176attributes are a list of LDAP fields to show in the results.</p><p>Example: <strong class="userinput"><code>net ads search '(objectCategory=group)' sAMAccountName</code></strong>
    177 </p></div><div class="refsect2" lang="en"><a name="id301109"></a><h3>ADS DN <em class="replaceable"><code>DN</code></em> <em class="replaceable"><code>(attributes)</code></em></h3><p>
     177</p></div><div class="refsect2" lang="en"><a name="id2533442"></a><h3>ADS DN <em class="replaceable"><code>DN</code></em> <em class="replaceable"><code>(attributes)</code></em></h3><p>
    178178Perform a raw LDAP search on a ADS server and dump the results. The
    179179DN standard LDAP DN, and the attributes are a list of LDAP fields
    180180to show in the result.
    181 </p><p>Example: <strong class="userinput"><code>net ads dn 'CN=administrator,CN=Users,DC=my,DC=domain' SAMAccountName</code></strong></p></div><div class="refsect2" lang="en"><a name="id301133"></a><h3>ADS WORKGROUP</h3><p>Print out workgroup name for specified kerberos realm.</p></div><div class="refsect2" lang="en"><a name="id301143"></a><h3>SAM CREATEBUILTINGROUP &lt;NAME&gt;</h3><p>
     181</p><p>Example: <strong class="userinput"><code>net ads dn 'CN=administrator,CN=Users,DC=my,DC=domain' SAMAccountName</code></strong></p></div><div class="refsect2" lang="en"><a name="id2533469"></a><h3>ADS WORKGROUP</h3><p>Print out workgroup name for specified kerberos realm.</p></div><div class="refsect2" lang="en"><a name="id2533479"></a><h3>SAM CREATEBUILTINGROUP &lt;NAME&gt;</h3><p>
    182182(Re)Create a BUILTIN group.
    183183Only a wellknown set of BUILTIN groups can be created with this command.
    … …  
    189189This command requires a running Winbindd with idmap allocation properly
    190190configured. The group gid will be allocated out of the winbindd range.
    191 </p></div><div class="refsect2" lang="en"><a name="id301156"></a><h3>SAM CREATELOCALGROUP &lt;NAME&gt;</h3><p>
     191</p></div><div class="refsect2" lang="en"><a name="id2533498"></a><h3>SAM CREATELOCALGROUP &lt;NAME&gt;</h3><p>
    192192Create a LOCAL group (also known as Alias).
    193193
    194194This command requires a running Winbindd with idmap allocation properly
    195195configured. The group gid will be allocated out of the winbindd range.
    196 </p></div><div class="refsect2" lang="en"><a name="id301168"></a><h3>SAM DELETELOCALGROUP &lt;NAME&gt;</h3><p>
     196</p></div><div class="refsect2" lang="en"><a name="id2533512"></a><h3>SAM DELETELOCALGROUP &lt;NAME&gt;</h3><p>
    197197Delete an existing LOCAL group (also known as Alias).
    198198
    199 </p></div><div class="refsect2" lang="en"><a name="id301178"></a><h3>SAM MAPUNIXGROUP &lt;NAME&gt;</h3><p>
     199</p></div><div class="refsect2" lang="en"><a name="id2533523"></a><h3>SAM MAPUNIXGROUP &lt;NAME&gt;</h3><p>
    200200Map an existing Unix group and make it a Domain Group, the domain group
    201201will have the same name.
    202 </p></div><div class="refsect2" lang="en"><a name="id301189"></a><h3>SAM UNMAPUNIXGROUP &lt;NAME&gt;</h3><p>
     202</p></div><div class="refsect2" lang="en"><a name="id2533536"></a><h3>SAM UNMAPUNIXGROUP &lt;NAME&gt;</h3><p>
    203203Remove an existing group mapping entry.
    204 </p></div><div class="refsect2" lang="en"><a name="id301198"></a><h3>SAM ADDMEM &lt;GROUP&gt; &lt;MEMBER&gt;</h3><p>
     204</p></div><div class="refsect2" lang="en"><a name="id2533547"></a><h3>SAM ADDMEM &lt;GROUP&gt; &lt;MEMBER&gt;</h3><p>
    205205Add a member to a Local group. The group can be specified only by name,
    206206the member can be specified by name or SID.
    207 </p></div><div class="refsect2" lang="en"><a name="id301210"></a><h3>SAM DELMEM  &lt;GROUP&gt; &lt;MEMBER&gt;</h3><p>
     207</p></div><div class="refsect2" lang="en"><a name="id2533560"></a><h3>SAM DELMEM  &lt;GROUP&gt; &lt;MEMBER&gt;</h3><p>
    208208Remove a member from a Local group. The group and the member must be
    209209specified by name.
    210 </p></div><div class="refsect2" lang="en"><a name="id301221"></a><h3>SAM LISTMEM &lt;GROUP&gt;</h3><p>
     210</p></div><div class="refsect2" lang="en"><a name="id2533572"></a><h3>SAM LISTMEM &lt;GROUP&gt;</h3><p>
    211211List Local group members. The group must be specified by name.
    212 </p></div><div class="refsect2" lang="en"><a name="id301231"></a><h3>SAM LIST &lt;users|groups|localgroups|builtin|workstations&gt; [verbose]</h3><p>
     212</p></div><div class="refsect2" lang="en"><a name="id2533583"></a><h3>SAM LIST &lt;users|groups|localgroups|builtin|workstations&gt; [verbose]</h3><p>
    213213List the specified set of accounts by name. If verbose is specified,
    214214the rid and description is also provided for each account.
    215 </p></div><div class="refsect2" lang="en"><a name="id301243"></a><h3>SAM SHOW &lt;NAME&gt;</h3><p>
     215</p></div><div class="refsect2" lang="en"><a name="id2533597"></a><h3>SAM SHOW &lt;NAME&gt;</h3><p>
    216216Show the full DOMAIN\\NAME the SID and the type for the corresponding
    217217account.
    218 </p></div><div class="refsect2" lang="en"><a name="id301253"></a><h3>SAM SET HOMEDIR &lt;NAME&gt; &lt;DIRECTORY&gt;</h3><p>
     218</p></div><div class="refsect2" lang="en"><a name="id2533608"></a><h3>SAM SET HOMEDIR &lt;NAME&gt; &lt;DIRECTORY&gt;</h3><p>
    219219Set the home directory for a user account.
    220 </p></div><div class="refsect2" lang="en"><a name="id301263"></a><h3>SAM SET PROFILEPATH &lt;NAME&gt; &lt;PATH&gt;</h3><p>
     220</p></div><div class="refsect2" lang="en"><a name="id2533619"></a><h3>SAM SET PROFILEPATH &lt;NAME&gt; &lt;PATH&gt;</h3><p>
    221221Set the profile path for a user account.
    222 </p></div><div class="refsect2" lang="en"><a name="id301273"></a><h3>SAM SET COMMENT &lt;NAME&gt; &lt;COMMENT&gt;</h3><p>
     222</p></div><div class="refsect2" lang="en"><a name="id2533630"></a><h3>SAM SET COMMENT &lt;NAME&gt; &lt;COMMENT&gt;</h3><p>
    223223Set the comment for a user or group account.
    224 </p></div><div class="refsect2" lang="en"><a name="id301282"></a><h3>SAM SET FULLNAME &lt;NAME&gt; &lt;FULL NAME&gt;</h3><p>
     224</p></div><div class="refsect2" lang="en"><a name="id2533640"></a><h3>SAM SET FULLNAME &lt;NAME&gt; &lt;FULL NAME&gt;</h3><p>
    225225Set the full name for a user account.
    226 </p></div><div class="refsect2" lang="en"><a name="id301292"></a><h3>SAM SET LOGONSCRIPT &lt;NAME&gt; &lt;SCRIPT&gt;</h3><p>
     226</p></div><div class="refsect2" lang="en"><a name="id2533652"></a><h3>SAM SET LOGONSCRIPT &lt;NAME&gt; &lt;SCRIPT&gt;</h3><p>
    227227Set the logon script for a user account.
    228 </p></div><div class="refsect2" lang="en"><a name="id301301"></a><h3>SAM SET HOMEDRIVE &lt;NAME&gt; &lt;DRIVE&gt;</h3><p>
     228</p></div><div class="refsect2" lang="en"><a name="id2533663"></a><h3>SAM SET HOMEDRIVE &lt;NAME&gt; &lt;DRIVE&gt;</h3><p>
    229229Set the home drive for a user account.
    230 </p></div><div class="refsect2" lang="en"><a name="id301311"></a><h3>SAM SET WORKSTATIONS &lt;NAME&gt; &lt;WORKSTATIONS&gt;</h3><p>
     230</p></div><div class="refsect2" lang="en"><a name="id2533674"></a><h3>SAM SET WORKSTATIONS &lt;NAME&gt; &lt;WORKSTATIONS&gt;</h3><p>
    231231Set the workstations a user account is allowed to log in from.
    232 </p></div><div class="refsect2" lang="en"><a name="id301321"></a><h3>SAM SET DISABLE &lt;NAME&gt;</h3><p>
     232</p></div><div class="refsect2" lang="en"><a name="id2533686"></a><h3>SAM SET DISABLE &lt;NAME&gt;</h3><p>
    233233Set the "disabled" flag for a user account.
    234 </p></div><div class="refsect2" lang="en"><a name="id301331"></a><h3>SAM SET PWNOTREQ &lt;NAME&gt;</h3><p>
     234</p></div><div class="refsect2" lang="en"><a name="id2533696"></a><h3>SAM SET PWNOTREQ &lt;NAME&gt;</h3><p>
    235235Set the "password not required" flag for a user account.
    236 </p></div><div class="refsect2" lang="en"><a name="id301341"></a><h3>SAM SET AUTOLOCK &lt;NAME&gt;</h3><p>
     236</p></div><div class="refsect2" lang="en"><a name="id2533708"></a><h3>SAM SET AUTOLOCK &lt;NAME&gt;</h3><p>
    237237Set the "autolock" flag for a user account.
    238 </p></div><div class="refsect2" lang="en"><a name="id301351"></a><h3>SAM SET PWNOEXP &lt;NAME&gt;</h3><p>
     238</p></div><div class="refsect2" lang="en"><a name="id2533719"></a><h3>SAM SET PWNOEXP &lt;NAME&gt;</h3><p>
    239239Set the "password do not expire" flag for a user account.
    240 </p></div><div class="refsect2" lang="en"><a name="id301361"></a><h3>SAM SET PWDMUSTCHANGENOW &lt;NAME&gt; [yes|no]</h3><p>
     240</p></div><div class="refsect2" lang="en"><a name="id2533730"></a><h3>SAM SET PWDMUSTCHANGENOW &lt;NAME&gt; [yes|no]</h3><p>
    241241Set or unset the "password must change" flag for a user account.
    242 </p></div><div class="refsect2" lang="en"><a name="id301371"></a><h3>SAM POLICY LIST</h3><p>
     242</p></div><div class="refsect2" lang="en"><a name="id2533742"></a><h3>SAM POLICY LIST</h3><p>
    243243List the available account policies.
    244 </p></div><div class="refsect2" lang="en"><a name="id301381"></a><h3>SAM POLICY SHOW &lt;account policy&gt;</h3><p>
     244</p></div><div class="refsect2" lang="en"><a name="id2533752"></a><h3>SAM POLICY SHOW &lt;account policy&gt;</h3><p>
    245245Show the account policy value.
    246 </p></div><div class="refsect2" lang="en"><a name="id301390"></a><h3>SAM POLICY SET &lt;account policy&gt; &lt;value&gt;</h3><p>
     246</p></div><div class="refsect2" lang="en"><a name="id2533763"></a><h3>SAM POLICY SET &lt;account policy&gt; &lt;value&gt;</h3><p>
    247247Set a value for the account policy.
    248248Valid values can be: "forever", "never", "off", or a number.
    249 </p></div><div class="refsect2" lang="en"><a name="id301402"></a><h3>SAM PROVISION</h3><p>
     249</p></div><div class="refsect2" lang="en"><a name="id2533776"></a><h3>SAM PROVISION</h3><p>
    250250Only available if ldapsam:editposix is set and winbindd is running.
    251251Properly populates the ldap tree with the basic accounts (Administrator)
    252252and groups (Domain Users, Domain Admins, Domain Guests) on the ldap tree.
    253 </p></div><div class="refsect2" lang="en"><a name="id301413"></a><h3>IDMAP DUMP &lt;local tdb file name&gt;</h3><p>
     253</p></div><div class="refsect2" lang="en"><a name="id2533789"></a><h3>IDMAP DUMP &lt;local tdb file name&gt;</h3><p>
    254254Dumps the mappings contained in the local tdb file specified.
    255255This command is useful to dump only the mappings produced by the idmap_tdb backend.
    256 </p></div><div class="refsect2" lang="en"><a name="id301425"></a><h3>IDMAP RESTORE [input file]</h3><p>
     256</p></div><div class="refsect2" lang="en"><a name="id2533803"></a><h3>IDMAP RESTORE [input file]</h3><p>
    257257Restore the mappings from the specified file or stdin.
    258 </p></div><div class="refsect2" lang="en"><a name="id301436"></a><h3>IDMAP SECRET &lt;DOMAIN&gt;|ALLOC &lt;secret&gt;</h3><p>
     258</p></div><div class="refsect2" lang="en"><a name="id2533813"></a><h3>IDMAP SECRET &lt;DOMAIN&gt;|ALLOC &lt;secret&gt;</h3><p>
    259259Store a secret for the specified domain, used primarily for domains
    260260that use idmap_ldap as a backend. In this case the secret is used
    261261as the password for the user DN used to bind to the ldap server.
    262 </p></div><div class="refsect2" lang="en"><a name="id301448"></a><h3>USERSHARE</h3><p>Starting with version 3.0.23, a Samba server now supports the ability for
     262</p></div><div class="refsect2" lang="en"><a name="id2533828"></a><h3>USERSHARE</h3><p>Starting with version 3.0.23, a Samba server now supports the ability for
    263263non-root users to add user defined shares to be exported using the "net usershare"
    264264commands.
    … …  
    289289</p><table class="simplelist" border="0" summary="Simple list"><tr><td>net usershare add sharename path [comment] [acl] [guest_ok=[y|n]] - to add or change a user defined share.</td></tr><tr><td>net usershare delete sharename - to delete a user defined share.</td></tr><tr><td>net usershare info [-l|--long] [wildcard sharename] - to print info about a user defined share.</td></tr><tr><td>net usershare list [-l|--long] [wildcard sharename] - to list user defined shares.</td></tr></table><p>
    290290
    291 </p><div class="refsect3" lang="en"><a name="id301493"></a><h4>USERSHARE ADD <em class="replaceable"><code>sharename</code></em> <em class="replaceable"><code>path</code></em> <em class="replaceable"><code>[comment]</code></em> <em class="replaceable"><code>[acl]</code></em> <em class="replaceable"><code>[guest_ok=[y|n]]</code></em></h4><p>
     291</p><div class="refsect3" lang="en"><a name="id2533885"></a><h4>USERSHARE ADD <em class="replaceable"><code>sharename</code></em> <em class="replaceable"><code>path</code></em> <em class="replaceable"><code>[comment]</code></em> <em class="replaceable"><code>[acl]</code></em> <em class="replaceable"><code>[guest_ok=[y|n]]</code></em></h4><p>
    292292Add or replace a new user defined share, with name "sharename".
    293293</p><p>
    … …  
    326326at connect time so will see the change immediately, there is no need
    327327to restart smbd on adding, deleting or changing a user defined share.
    328 </div><div class="refsect3" lang="en"><a name="id301550"></a><h4>USERSHARE DELETE <em class="replaceable"><code>sharename</code></em></h4><p>
     328</div><div class="refsect3" lang="en"><a name="id2533958"></a><h4>USERSHARE DELETE <em class="replaceable"><code>sharename</code></em></h4><p>
    329329Deletes the user defined share by name. The Samba smbd daemon
    330330immediately notices this change, although it will not disconnect
    331331any users currently connected to the deleted share.
    332 </p></div><div class="refsect3" lang="en"><a name="id301563"></a><h4>USERSHARE INFO <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>[wildcard sharename]</code></em></h4><p>
     332</p></div><div class="refsect3" lang="en"><a name="id2533973"></a><h4>USERSHARE INFO <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>[wildcard sharename]</code></em></h4><p>
    333333Get info on user defined shares owned by the current user matching the given pattern, or all users.
    334334</p><p>
    … …  
    349349And is a list of the current settings of the user defined share that can be
    350350modified by the "net usershare add" command.
    351 </p></div><div class="refsect3" lang="en"><a name="id301591"></a><h4>USERSHARE LIST <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>wildcard sharename</code></em></h4><p>
     351</p></div><div class="refsect3" lang="en"><a name="id2534006"></a><h4>USERSHARE LIST <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>wildcard sharename</code></em></h4><p>
    352352List all the user defined shares owned by the current user matching the given pattern, or all users.
    353353</p><p>
    … …  
    357357If the '-l' or '--long' option is also given, it includes the names of user defined
    358358shares created by other users.
    359 </p></div></div><div class="refsect2" lang="en"><a name="id301617"></a><h3>HELP [COMMAND]</h3><p>Gives usage information for the specified command.</p></div></div><div class="refsect1" lang="en"><a name="id301628"></a><h2>VERSION</h2><p>This man page is complete for version 3.0 of the Samba
    360         suite.</p></div><div class="refsect1" lang="en"><a name="id301638"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     359</p></div></div><div class="refsect2" lang="en"><a name="id2534040"></a><h3>HELP [COMMAND]</h3><p>Gives usage information for the specified command.</p></div></div><div class="refsect1" lang="en"><a name="id2534052"></a><h2>VERSION</h2><p>This man page is complete for version 3.0 of the Samba
     360        suite.</p></div><div class="refsect1" lang="en"><a name="id2534063"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    361361        were created by Andrew Tridgell. Samba is now developed
    362362        by the Samba Team as an Open Source project similar

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

    r158 r286  
    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.73.2"></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="id290849"></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="id2483406"></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,
    … …  
    1212        is running on.  Its "own NetBIOS name" is by
    1313        default the primary DNS name of the host it is running on,
    14         but this can be overridden by the <a class="link" href="smb.conf.5.html#NETBIOSNAME">netbios name</a>
     14        but this can be overridden by the <a class="link" href="smb.conf.5.html#NETBIOSNAME" target="_top">netbios name</a>
    1515        in <code class="filename">smb.conf</code>. Thus <code class="literal">nmbd</code> will
    1616        reply to broadcast queries for its own name(s). Additional
    … …  
    2323        proxy, relaying broadcast queries from clients that do
    2424        not understand how to talk the WINS protocol to a WINS
    25         server.</p></div><div class="refsect1" lang="en"><a name="id258975"></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="id2483734"></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
    … …  
    5252                file is a list of NetBIOS names to IP addresses that
    5353                is loaded by the nmbd server and used via the name
    54                 resolution mechanism <a class="link" href="smb.conf.5.html#NAMERESOLVEORDER">name resolve order</a> described in <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> to resolve any
     54                resolution mechanism <a class="link" href="smb.conf.5.html#NAMERESOLVEORDER" target="_top">name resolve order</a> described in <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> to resolve any
    5555                NetBIOS name queries needed by the server. Note
    5656                that the contents of this file are <span class="emphasis"><em>NOT</em></span>
    … …  
    7373use only by developers and generate HUGE amounts of log
    7474data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
    75 override the <a class="link" href="smb.conf.5.html#LOGLEVEL">log level</a> parameter
     75override the <a class="link" href="smb.conf.5.html#LOGLEVEL" target="_top">log level</a> parameter
    7676in the <code class="filename">smb.conf</code> file.</p></dd><dt><span class="term">-V</span></dt><dd><p>Prints the program version number.
    7777</p></dd><dt><span class="term">-s &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the
    … …  
    8989                that <code class="literal">nmbd</code> responds to name queries on. Don't
    9090                use this option unless you are an expert, in which case you
    91                 won't need help!</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id299964"></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="id2481764"></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
    … …  
    105105                install this file are <code class="filename">/usr/samba/lib/smb.conf</code>
    106106                and <code class="filename">/etc/samba/smb.conf</code>.</p><p>When run as a WINS server (see the
    107                         <a class="link" href="smb.conf.5.html#WINSSUPPORT">wins support</a>
     107                        <a class="link" href="smb.conf.5.html#WINSSUPPORT" target="_top">wins support</a>
    108108                parameter in the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> man page),
    109109                <code class="literal">nmbd</code>
    … …  
    111111                in the <code class="filename">var/locks</code> directory configured under
    112112                wherever Samba was configured to install itself.</p><p>If <code class="literal">nmbd</code> is acting as a <span class="emphasis"><em>
    113                                 browse master</em></span> (see the <a class="link" href="smb.conf.5.html#LOCALMASTER">local master</a>
     113                                browse master</em></span> (see the <a class="link" href="smb.conf.5.html#LOCALMASTER" target="_top">local master</a>
    114114                parameter in the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> man page, <code class="literal">nmbd</code>
    115115                will store the browsing database in the file <code class="filename">browse.dat
    116116                </code> in the <code class="filename">var/locks</code> directory
    117117                configured under wherever Samba was configured to install itself.
    118                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id300140"></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="id2481969"></a><h2>SIGNALS</h2><p>To shut down an <code class="literal">nmbd</code> process it is recommended
    119119        that SIGKILL (-9) <span class="emphasis"><em>NOT</em></span> be used, except as a last
    120120        resort, as this may leave the name database in an inconsistent state.
    … …  
    130130        are no longer used since Samba 2.2). This is to allow
    131131        transient problems to be diagnosed, whilst still running
    132         at a normally low log level.</p></div><div class="refsect1" lang="en"><a name="id300213"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
    133         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id300223"></a><h2>SEE ALSO</h2><p>
     132        at a normally low log level.</p></div><div class="refsect1" lang="en"><a name="id2532519"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
     133        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2532530"></a><h2>SEE ALSO</h2><p>
    134134        <a class="citerefentry" href="inetd.8.html"><span class="citerefentry"><span class="refentrytitle">inetd</span>(8)</span></a>, <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>, <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>, <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>, <a class="citerefentry" href="testparm.1.html"><span class="citerefentry"><span class="refentrytitle">testparm</span>(1)</span></a>, <a class="citerefentry" href="testprns.1.html"><span class="citerefentry"><span class="refentrytitle">testprns</span>(1)</span></a>, and the Internet
    135135        RFC's <code class="filename">rfc1001.txt</code>, <code class="filename">rfc1002.txt</code>.
    136136        In addition the CIFS (formerly SMB) specification is available
    137137        as a link from the Web page <a class="ulink" href="http://samba.org/cifs/" target="_top">
    138         http://samba.org/cifs/</a>.</p></div><div class="refsect1" lang="en"><a name="id300296"></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="id2532603"></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.0/docs/htmldocs/manpages/nmblookup.1.html

    r158 r286  
    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.73.2"></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="id290857"></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="id2483412"></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" lang="en"><a name="id258955"></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="id2483558"></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>
    … …  
    2929                an IP Address and do a node status query on this address.</p></dd><dt><span class="term">-n &lt;primary NetBIOS name&gt;</span></dt><dd><p>This option allows you to override
    3030the NetBIOS name that Samba uses for itself. This is identical
    31 to setting the <a class="link" href="smb.conf.5.html#NETBIOSNAME">netbios name</a> parameter in the <code class="filename">smb.conf</code> file.
     31to setting the <a class="link" href="smb.conf.5.html#NETBIOSNAME" target="_top">netbios name</a> parameter in the <code class="filename">smb.conf</code> file.
    3232However, a command
    3333line setting will take precedence over settings in
    … …  
    6666use only by developers and generate HUGE amounts of log
    6767data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
    68 override the <a class="link" href="smb.conf.5.html#LOGLEVEL">log level</a> parameter
     68override the <a class="link" href="smb.conf.5.html#LOGLEVEL" target="_top">log level</a> parameter
    6969in the <code class="filename">smb.conf</code> file.</p></dd><dt><span class="term">-V</span></dt><dd><p>Prints the program version number.
    7070</p></dd><dt><span class="term">-s &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the
    … …  
    8989                by appending '#&lt;type&gt;' to the name. This name may also be
    9090                '*', which will return all registered names within a broadcast
    91                 area.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id299978"></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="id2481778"></a><h2>EXAMPLES</h2><p><code class="literal">nmblookup</code> can be used to query
    9292                a WINS server (in the same way <code class="literal">nslookup</code> is
    9393                used to query DNS servers). To query a WINS server, <code class="literal">nmblookup</code>
    9494                must be called like this:</p><p><code class="literal">nmblookup -U server -R 'name'</code></p><p>For example, running :</p><p><code class="literal">nmblookup -U samba.org -R 'IRIX#1B'</code></p><p>would query the WINS server samba.org for the domain
    95                 master browser (1B name type) for the IRIX workgroup.</p></div><div class="refsect1" lang="en"><a name="id300023"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
    96         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id300034"></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="id300065"></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="id2481828"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
     96        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2481839"></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="id2481871"></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.0/docs/htmldocs/manpages/ntlm_auth.1.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ntlm_auth</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258193"></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="id2522953"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">ntlm_auth</code> is a helper utility that authenticates
    22        users using NT/LM authentication. It returns 0 if the users is authenticated
    33        successfully and 1 if access was denied. ntlm_auth uses winbind to access
    … …  
    66        <a class="ulink" href="http://www.squid-cache.org/" target="_top">Squid</a>
    77        and <a class="ulink" href="http://download.samba.org/ftp/unpacked/lorikeet/trunk/mod_ntlm_winbind/" target="_top">mod_ntlm_winbind</a>)
    8         </p></div><div class="refsect1" lang="en"><a name="id290812"></a><h2>OPERATIONAL REQUIREMENTS</h2><p>
     8        </p></div><div class="refsect1" lang="en"><a name="id2483370"></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" lang="en"><a name="id290853"></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="id2483416"></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>
    … …  
    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
    67                 Samba's <a class="link" href="smb.conf.5.html#UNIXCHARSET">unix charset</a>.
    68                 </p><div class="example"><a name="id258316"></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="id258321"></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
    69                 Samba's <a class="link" href="smb.conf.5.html#UNIXCHARSET">unix charset</a>.
    70                 </p><div class="example"><a name="id258347"></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="id258352"></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
    71                 Samba's <a class="link" href="smb.conf.5.html#UNIXCHARSET">unix charset</a> and qualified with the
    72                 <a class="link" href="smb.conf.5.html#WINBINDSEPARATOR">winbind separator</a>.
    73                 </p><div class="example"><a name="id299860"></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="id299864"></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,
     67                Samba's <a class="link" href="smb.conf.5.html#UNIXCHARSET" target="_top">unix charset</a>.
     68                </p><div class="example"><a name="id2483782"></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="id2483787"></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
     69                Samba's <a class="link" href="smb.conf.5.html#UNIXCHARSET" target="_top">unix charset</a>.
     70                </p><div class="example"><a name="id2481589"></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="id2481593"></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
     71                Samba's <a class="link" href="smb.conf.5.html#UNIXCHARSET" target="_top">unix charset</a> and qualified with the
     72                <a class="link" href="smb.conf.5.html#WINBINDSEPARATOR" target="_top">winbind separator</a>.
     73                </p><div class="example"><a name="id2481629"></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="id2481633"></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="id299886"></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="id2481658"></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="id299913"></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="id2481689"></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="id299940"></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="id2481722"></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="id299957"></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="id299962"></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="id2481743"></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="id2481747"></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="id299978"></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="id2481765"></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="id299994"></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="id2481782"></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>
    … …  
    116116use only by developers and generate HUGE amounts of log
    117117data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
    118 override the <a class="link" href="smb.conf.5.html#LOGLEVEL">log level</a> parameter
     118override the <a class="link" href="smb.conf.5.html#LOGLEVEL" target="_top">log level</a> parameter
    119119in the <code class="filename">smb.conf</code> file.</p></dd><dt><span class="term">-V</span></dt><dd><p>Prints the program version number.
    120120</p></dd><dt><span class="term">-s &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the
    … …  
    129129log.smbd, etc...). The log file is never removed by the client.
    130130</p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    131 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id300248"></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="id2532534"></a><h2>EXAMPLE SETUP</h2><p>To setup ntlm_auth for use by squid 2.5, with both basic and
    132132        NTLMSSP authentication, the following
    133133        should be placed in the <code class="filename">squid.conf</code> file.
    … …  
    145145auth_param ntlm program ntlm_auth --helper-protocol=squid-2.5-ntlmssp --require-membership-of='WORKGROUP\Domain Users'
    146146auth_param basic program ntlm_auth --helper-protocol=squid-2.5-basic --require-membership-of='WORKGROUP\Domain Users'
    147 </pre></div><div class="refsect1" lang="en"><a name="id300297"></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="id2532590"></a><h2>TROUBLESHOOTING</h2><p>If you're experiencing problems with authenticating Internet Explorer running
    148148        under MS Windows 9X or Millenium Edition against ntlm_auth's NTLMSSP authentication
    149149        helper (--helper-protocol=squid-2.5-ntlmssp), then please read
    150150        <a class="ulink" href="http://support.microsoft.com/support/kb/articles/Q239/8/69.ASP" target="_top">
    151151        the Microsoft Knowledge Base article #239869 and follow instructions described there</a>.
    152         </p></div><div class="refsect1" lang="en"><a name="id300315"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba
    153         suite.</p></div><div class="refsect1" lang="en"><a name="id300325"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     152        </p></div><div class="refsect1" lang="en"><a name="id2532612"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba
     153        suite.</p></div><div class="refsect1" lang="en"><a name="id2532623"></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.0/docs/htmldocs/manpages/pam_winbind.7.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>pam_winbind</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="pam_winbind.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>pam_winbind &#8212; PAM module for Winbind</p></div><div class="refsect1" lang="en"><a name="id258741"></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.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>pam_winbind &#8212; PAM module for Winbind</p></div><div class="refsect1" lang="en"><a name="id2522915"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>
    22        pam_winbind is a PAM module that can authenticate users against the local domain by talking to the Winbind daemon.
    3         </p></div><div class="refsect1" lang="en"><a name="id258178"></a><h2>OPTIONS</h2><p>
     3        </p></div><div class="refsect1" lang="en"><a name="id2522939"></a><h2>OPTIONS</h2><p>
    44       
    55                pam_winbind supports several options which can either be set in
    … …  
    5656
    5757
    58         </p></div><div class="refsect1" lang="en"><a name="id259014"></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="id259049"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of Samba.</p></div><div class="refsect1" lang="en"><a name="id259059"></a><h2>AUTHOR</h2><p>
     58        </p></div><div class="refsect1" lang="en"><a name="id2483635"></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="id2483671"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of Samba.</p></div><div class="refsect1" lang="en"><a name="id2483681"></a><h2>AUTHOR</h2><p>
    5959        The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed by
    6060        the Samba Team as an Open Source project similar to the way the Linux kernel is developed.

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

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>pdbedit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id259003"></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="id2483603"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The pdbedit program is used to manage the users accounts
    22        stored in the sam database and can only be run by root.</p><p>The pdbedit tool uses the passdb modular interface and is
    33        independent from the kind of users database used (currently there
    … …  
    55        without changing the tool).</p><p>There are five main ways to use pdbedit: adding a user account,
    66        removing a user account, modifing a user account, listing user
    7         accounts, importing users accounts.</p></div><div class="refsect1" lang="en"><a name="id259036"></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="id2483640"></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
    … …  
    7979</pre><p>
    8080</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
    81                                 script if <a class="link" href="smb.conf.5.html#UNIXPASSWORDSYNC">unix password sync</a>
     81                                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
    8383                                user database.
    … …  
    133133use only by developers and generate HUGE amounts of log
    134134data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
    135 override the <a class="link" href="smb.conf.5.html#LOGLEVEL">log level</a> parameter
     135override the <a class="link" href="smb.conf.5.html#LOGLEVEL" target="_top">log level</a> parameter
    136136in the <code class="filename">smb.conf</code> file.</p></dd><dt><span class="term">-V</span></dt><dd><p>Prints the program version number.
    137137</p></dd><dt><span class="term">-s &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the
    … …  
    145145<code class="constant">".progname"</code> will be appended (e.g. log.smbclient,
    146146log.smbd, etc...). The log file is never removed by the client.
    147 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id300451"></a><h2>NOTES</h2><p>This command may be used only by root.</p></div><div class="refsect1" lang="en"><a name="id300461"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
    148         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id300471"></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="id300494"></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="id2532742"></a><h2>NOTES</h2><p>This command may be used only by root.</p></div><div class="refsect1" lang="en"><a name="id2532752"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
     148        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2532762"></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="id2532785"></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.0/docs/htmldocs/manpages/profiles.1.html

    r158 r286  
    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.73.2"></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="id290779"></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="id2522959"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">profiles</code> is a utility that
    33        reports and changes SIDs in windows registry files. It currently only
    44        supports NT.
    5         </p></div><div class="refsect1" lang="en"><a name="id290806"></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="id2483360"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">file</span></dt><dd><p>Registry file to view or edit.  </p></dd><dt><span class="term">-v,--verbose</span></dt><dd><p>Increases verbosity of messages.
    66                </p></dd><dt><span class="term">-c SID1 -n SID2</span></dt><dd><p>Change all occurences of SID1 in <code class="filename">file</code> by SID2.
    77                </p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    8 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id258937"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba
    9         suite.</p></div><div class="refsect1" lang="en"><a name="id258947"></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="id2483538"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba
     9        suite.</p></div><div class="refsect1" lang="en"><a name="id2483548"></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.0/docs/htmldocs/manpages/rpcclient.1.html

    r158 r286  
    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.73.2"></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="id290842"></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="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">rpcclient</code> is a utility initially developed
    33        to test MS-RPC functionality in Samba itself.  It has undergone
    44        several stages of development and stability.  Many system administrators
    55        have now written scripts around it to manage Windows NT clients from
    6         their UNIX workstation. </p></div><div class="refsect1" lang="en"><a name="id258941"></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="id2483542"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">server</span></dt><dd><p>NetBIOS name of Server to which to connect.
    77                The server can be  any SMB/CIFS server.  The name is
    8                 resolved using the <a class="link" href="smb.conf.5.html#NAMERESOLVEORDER">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
     8                resolved using the <a class="link" href="smb.conf.5.html#NAMERESOLVEORDER" target="_top">name resolve order</a> line from <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>.</p></dd><dt><span class="term">-c|--command='command string'</span></dt><dd><p>execute semicolon separated commands (listed
    99                below)) </p></dd><dt><span class="term">-I IP-address</span></dt><dd><p><em class="replaceable"><code>IP address</code></em> is the address of the server to connect to.
    1010                It should be specified in standard "a.b.c.d" notation. </p><p>Normally the client would attempt to locate a named
    … …  
    2828use only by developers and generate HUGE amounts of log
    2929data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
    30 override the <a class="link" href="smb.conf.5.html#LOGLEVEL">log level</a> parameter
     30override the <a class="link" href="smb.conf.5.html#LOGLEVEL" target="_top">log level</a> parameter
    3131in the <code class="filename">smb.conf</code> file.</p></dd><dt><span class="term">-V</span></dt><dd><p>Prints the program version number.
    3232</p></dd><dt><span class="term">-s &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the
    … …  
    7373it in directly. </p></dd><dt><span class="term">-n &lt;primary NetBIOS name&gt;</span></dt><dd><p>This option allows you to override
    7474the NetBIOS name that Samba uses for itself. This is identical
    75 to setting the <a class="link" href="smb.conf.5.html#NETBIOSNAME">netbios name</a> parameter in the <code class="filename">smb.conf</code> file.
     75to setting the <a class="link" href="smb.conf.5.html#NETBIOSNAME" target="_top">netbios name</a> parameter in the <code class="filename">smb.conf</code> file.
    7676However, a command
    7777line setting will take precedence over settings in
    … …  
    9090the <code class="filename">smb.conf</code> manual page for the list of valid
    9191options. </p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    92 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id299954"></a><h2>COMMANDS</h2><div class="refsect2" lang="en"><a name="id299960"></a><h3>LSARPC</h3><div class="variablelist"><dl><dt><span class="term">lsaquery</span></dt><dd><p>Query info policy</p></dd><dt><span class="term">lookupsids</span></dt><dd><p>Resolve a list
     92</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481747"></a><h2>COMMANDS</h2><div class="refsect2" lang="en"><a name="id2481753"></a><h3>LSARPC</h3><div class="variablelist"><dl><dt><span class="term">lsaquery</span></dt><dd><p>Query info policy</p></dd><dt><span class="term">lookupsids</span></dt><dd><p>Resolve a list
    9393                of SIDs to usernames.
    9494                </p></dd><dt><span class="term">lookupnames</span></dt><dd><p>Resolve a list
    9595                of usernames to SIDs.
    96                 </p></dd><dt><span class="term">enumtrusts</span></dt><dd><p>Enumerate trusted domains</p></dd><dt><span class="term">enumprivs</span></dt><dd><p>Enumerate privileges</p></dd><dt><span class="term">getdispname</span></dt><dd><p>Get the privilege name</p></dd><dt><span class="term">lsaenumsid</span></dt><dd><p>Enumerate the LSA SIDS</p></dd><dt><span class="term">lsaenumprivsaccount</span></dt><dd><p>Enumerate the privileges of an SID</p></dd><dt><span class="term">lsaenumacctrights</span></dt><dd><p>Enumerate the rights of an SID</p></dd><dt><span class="term">lsaenumacctwithright</span></dt><dd><p>Enumerate accounts with a right</p></dd><dt><span class="term">lsaaddacctrights</span></dt><dd><p>Add rights to an account</p></dd><dt><span class="term">lsaremoveacctrights</span></dt><dd><p>Remove rights from an account</p></dd><dt><span class="term">lsalookupprivvalue</span></dt><dd><p>Get a privilege value given its name</p></dd><dt><span class="term">lsaquerysecobj</span></dt><dd><p>Query LSA security object</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id300074"></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="id300139"></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="id300163"></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="id300203"></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="id300339"></a><h3>SPOOLSS</h3><div class="variablelist"><dl><dt><span class="term">adddriver &lt;arch&gt; &lt;config&gt; [&lt;version&gt;]</span></dt><dd><p>
     96                </p></dd><dt><span class="term">enumtrusts</span></dt><dd><p>Enumerate trusted domains</p></dd><dt><span class="term">enumprivs</span></dt><dd><p>Enumerate privileges</p></dd><dt><span class="term">getdispname</span></dt><dd><p>Get the privilege name</p></dd><dt><span class="term">lsaenumsid</span></dt><dd><p>Enumerate the LSA SIDS</p></dd><dt><span class="term">lsaenumprivsaccount</span></dt><dd><p>Enumerate the privileges of an SID</p></dd><dt><span class="term">lsaenumacctrights</span></dt><dd><p>Enumerate the rights of an SID</p></dd><dt><span class="term">lsaenumacctwithright</span></dt><dd><p>Enumerate accounts with a right</p></dd><dt><span class="term">lsaaddacctrights</span></dt><dd><p>Add rights to an account</p></dd><dt><span class="term">lsaremoveacctrights</span></dt><dd><p>Remove rights from an account</p></dd><dt><span class="term">lsalookupprivvalue</span></dt><dd><p>Get a privilege value given its name</p></dd><dt><span class="term">lsaquerysecobj</span></dt><dd><p>Query LSA security object</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="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="id2481946"></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="id2532617"></a><h3>SPOOLSS</h3><div class="variablelist"><dl><dt><span class="term">adddriver &lt;arch&gt; &lt;config&gt; [&lt;version&gt;]</span></dt><dd><p>
    9797                Execute an AddPrinterDriver() RPC to install the printer driver
    9898                information on the server.  Note that the driver files should
    … …  
    179179                <code class="literal">enumdrivers</code> commands for obtaining a list of
    180180                of installed printers and drivers.</p></dd><dt><span class="term">addform</span></dt><dd><p>Add form</p></dd><dt><span class="term">setform</span></dt><dd><p>Set form</p></dd><dt><span class="term">getform</span></dt><dd><p>Get form</p></dd><dt><span class="term">deleteform</span></dt><dd><p>Delete form</p></dd><dt><span class="term">enumforms</span></dt><dd><p>Enumerate form</p></dd><dt><span class="term">setprinter</span></dt><dd><p>Set printer comment</p></dd><dt><span class="term">setprinterdata</span></dt><dd><p>Set REG_SZ printer data</p></dd><dt><span class="term">setprintername &lt;printername&gt;
    181                 &lt;newprintername&gt;</span></dt><dd><p>Set printer name</p></dd><dt><span class="term">rffpcnex</span></dt><dd><p>Rffpcnex test</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id300692"></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="id300750"></a><h3>GENERAL COMMANDS</h3><div class="variablelist"><dl><dt><span class="term">debuglevel</span></dt><dd><p>Set the current
     181                &lt;newprintername&gt;</span></dt><dd><p>Set printer name</p></dd><dt><span class="term">rffpcnex</span></dt><dd><p>Rffpcnex test</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2533012"></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="id2533070"></a><h3>GENERAL COMMANDS</h3><div class="variablelist"><dl><dt><span class="term">debuglevel</span></dt><dd><p>Set the current
    182182                debug level used to log information.</p></dd><dt><span class="term">help (?)</span></dt><dd><p>Print a listing of all
    183183                known commands or extended help  on a particular command.
    184184                </p></dd><dt><span class="term">quit (exit)</span></dt><dd><p>Exit <code class="literal">rpcclient
    185                 </code>.</p></dd></dl></div></div></div><div class="refsect1" lang="en"><a name="id300789"></a><h2>BUGS</h2><p><code class="literal">rpcclient</code> is designed as a developer testing tool
     185                </code>.</p></dd></dl></div></div></div><div class="refsect1" lang="en"><a name="id2533111"></a><h2>BUGS</h2><p><code class="literal">rpcclient</code> is designed as a developer testing tool
    186186        and may not be robust in certain areas (such as command line parsing). 
    187187        It has been known to  generate a core dump upon failures when invalid
    … …  
    196196        the developers are sending reports to Microsoft,  and problems found
    197197        or reported to Microsoft are fixed in Service Packs,  which may
    198         result in incompatibilities.</p></div><div class="refsect1" lang="en"><a name="id300838"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba
    199         suite.</p></div><div class="refsect1" lang="en"><a name="id300848"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     198        result in incompatibilities.</p></div><div class="refsect1" lang="en"><a name="id2533169"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba
     199        suite.</p></div><div class="refsect1" lang="en"><a name="id2533180"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    200200        were created by Andrew Tridgell. Samba is now developed
    201201        by the Samba Team as an Open Source project similar

  • branches/samba-3.0/docs/htmldocs/manpages/samba.7.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>samba</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258167"></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="id2522928"></a><h2>DESCRIPTION</h2><p>The Samba software suite is a collection of programs
    22        that implements the Server Message Block (commonly abbreviated
    33        as SMB) protocol for UNIX systems. This protocol is sometimes
    … …  
    6464                mount CIFS/SMB shares on Linux.
    6565                </p></dd><dt><span class="term"><a class="citerefentry" href="smbcquotas.1.html"><span class="citerefentry"><span class="refentrytitle">smbcquotas</span>(1)</span></a></span></dt><dd><p><code class="literal">smbcquotas</code> is a tool that
    66                 can set remote QUOTA's on server with NTFS 5. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id300036"></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="id2481814"></a><h2>COMPONENTS</h2><p>The Samba suite is made up of several components. Each
    6767        component is described in a separate manual page. It is strongly
    6868        recommended that you read the documentation that comes with Samba
    … …  
    7373        <a class="ulink" href="http://samba.org/" target="_top">http://www.samba.org/</a> and
    7474        explore the many option available to you.
    75         </p></div><div class="refsect1" lang="en"><a name="id300062"></a><h2>AVAILABILITY</h2><p>The Samba software suite is licensed under the
     75        </p></div><div class="refsect1" lang="en"><a name="id2481847"></a><h2>AVAILABILITY</h2><p>The Samba software suite is licensed under the
    7676        GNU Public License(GPL). A copy of that license should
    7777        have come with the package in the file COPYING. You are
    … …  
    8787        or Konqueror) then you will also find lots of useful information,
    8888        including back issues of the Samba mailing list, at
    89         <a class="ulink" href="http://lists.samba.org/" target="_top">http://lists.samba.org</a>.</p></div><div class="refsect1" lang="en"><a name="id300099"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the
    90         Samba suite. </p></div><div class="refsect1" lang="en"><a name="id300109"></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="id2481891"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the
     90        Samba suite. </p></div><div class="refsect1" lang="en"><a name="id2481902"></a><h2>CONTRIBUTIONS</h2><p>If you wish to contribute to the Samba project,
    9191        then I suggest you join the Samba mailing list at
    9292        <a class="ulink" href="http://lists.samba.org/" target="_top">http://lists.samba.org</a>.
    … …  
    9494        <a class="ulink" href="http://devel.samba.org/" target="_top">http://devel.samba.org/</a>
    9595        for information on how to do it properly. We prefer patches
    96         in <code class="literal">diff -u</code> format.</p></div><div class="refsect1" lang="en"><a name="id300139"></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="id2481936"></a><h2>CONTRIBUTORS</h2><p>Contributors to the project are now too numerous
    9797        to mention here but all deserve the thanks of all Samba
    9898        users. To see a full list, look at the
    … …  
    102102        for the contributors to Samba post-CVS. CVS is the Open Source
    103103        source code control system used by the Samba Team to develop
    104         Samba. The project would have been unmanageable without it.</p></div><div class="refsect1" lang="en"><a name="id300163"></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="id2481964"></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.0/docs/htmldocs/manpages/smb.conf.5.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smb.conf</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258742"></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="id2522916"></a><h2>SYNOPSIS</h2><p>
    22        The <code class="filename">smb.conf</code> file is a configuration  file for the Samba suite. <code class="filename">smb.conf</code> contains  runtime configuration information for the Samba programs. The
    33         <code class="filename">smb.conf</code> file is designed to be configured and administered by the
    … …  
    2727        which may be given as yes/no, 0/1 or true/false. Case is not significant in boolean values, but is preserved
    2828        in string values. Some items such as create masks are numeric.
    29         </p></div><div class="refsect1" lang="en"><a name="id290840"></a><h2>SECTION DESCRIPTIONS</h2><p>
     29        </p></div><div class="refsect1" lang="en"><a name="id2483409"></a><h2>SECTION DESCRIPTIONS</h2><p>
    3030        Each section in the configuration file (except for the [global] section) describes a shared resource (known as
    3131        a &#8220;<span class="quote">share</span>&#8221;). The section name is the name of the shared resource and the parameters within the
    … …  
    5656</p><pre class="programlisting">
    5757        <em class="parameter"><code>[foo]</code></em>
    58         <a class="link" href="smb.conf.5.html#PATH">path = /home/bar</a>
    59         <a class="link" href="smb.conf.5.html#READONLY">read only = no</a>
     58        <a class="link" href="smb.conf.5.html#PATH" target="_top">path = /home/bar</a>
     59        <a class="link" href="smb.conf.5.html#READONLY" target="_top">read only = no</a>
    6060</pre><p>
    6161        </p><p>
    … …  
    6565</p><pre class="programlisting">
    6666        <em class="parameter"><code>[aprinter]</code></em>
    67         <a class="link" href="smb.conf.5.html#PATH">path = /usr/spool/public</a>
    68         <a class="link" href="smb.conf.5.html#READONLY">read only = yes</a>
    69         <a class="link" href="smb.conf.5.html#PRINTABLE">printable = yes</a>
    70         <a class="link" href="smb.conf.5.html#GUESTOK">guest ok = yes</a>
     67        <a class="link" href="smb.conf.5.html#PATH" target="_top">path = /usr/spool/public</a>
     68        <a class="link" href="smb.conf.5.html#READONLY" target="_top">read only = yes</a>
     69        <a class="link" href="smb.conf.5.html#PRINTABLE" target="_top">printable = yes</a>
     70        <a class="link" href="smb.conf.5.html#GUESTOK" target="_top">guest ok = yes</a>
    7171</pre><p>
    72         </p></div><div class="refsect1" lang="en"><a name="id259036"></a><h2>SPECIAL SECTIONS</h2><div class="refsect2" lang="en"><a name="id259041"></a><h3>The [global] section</h3><p>
     72        </p></div><div class="refsect1" lang="en"><a name="id2481485"></a><h2>SPECIAL SECTIONS</h2><div class="refsect2" lang="en"><a name="id2481491"></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.
    … …  
    106106</p><pre class="programlisting">
    107107<em class="parameter"><code>[homes]</code></em>
    108 <a class="link" href="smb.conf.5.html#READONLY">read only = no</a>
     108<a class="link" href="smb.conf.5.html#READONLY" target="_top">read only = no</a>
    109109</pre><p>
    110110                </p><p>
    … …  
    138138</p><pre class="programlisting">
    139139<em class="parameter"><code>[printers]</code></em>
    140 <a class="link" href="smb.conf.5.html#PATH">path = /usr/spool/public</a>
    141 <a class="link" href="smb.conf.5.html#GUESTOK">guest ok = yes</a>
    142 <a class="link" href="smb.conf.5.html#PRINTABLE">printable = yes</a>
     140<a class="link" href="smb.conf.5.html#PATH" target="_top">path = /usr/spool/public</a>
     141<a class="link" href="smb.conf.5.html#GUESTOK" target="_top">guest ok = yes</a>
     142<a class="link" href="smb.conf.5.html#PRINTABLE" target="_top">printable = yes</a>
    143143</pre><p>
    144144                </p><p>
    … …  
    161161                <code class="literal">printcap name = lpstat</code> to automatically obtain a list of printers. See the
    162162                <code class="literal">printcap name</code> option for more details.
    163                 </p></div></div></div><div class="refsect1" lang="en"><a name="id299983"></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="id2481804"></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.
    … …  
    179179
    180180</p><pre class="programlisting">
    181         <a class="link" href="smb.conf.5.html#USERSHAREPATH">usershare path = /usr/local/samba/lib/usershares</a>
    182         <a class="link" href="smb.conf.5.html#USERSHAREMAXSHARES">usershare max shares = 10</a> # (or the desired number of shares)
     181        <a class="link" href="smb.conf.5.html#USERSHAREPATH" target="_top">usershare path = /usr/local/samba/lib/usershares</a>
     182        <a class="link" href="smb.conf.5.html#USERSHAREMAXSHARES" target="_top">usershare max shares = 10</a> # (or the desired number of shares)
    183183</pre><p>
    184184
    185185        to the global
    186186        section of your <code class="filename">smb.conf</code>. Members of the group foo may then manipulate the user defined shares
    187         using the following commands.</p><div class="variablelist"><dl><dt><span class="term">net usershare add sharename path [comment] [acl] [guest_ok=[y|n]]</span></dt><dd><p>To create or modify (overwrite) a user defined share.</p></dd><dt><span class="term">net usershare delete sharename</span></dt><dd><p>To delete a user defined share.</p></dd><dt><span class="term">net usershare list wildcard-sharename</span></dt><dd><p>To list user defined shares.</p></dd><dt><span class="term">net usershare info wildcard-sharename</span></dt><dd><p>To print information about user defined shares.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id300177"></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="id2482031"></a><h2>PARAMETERS</h2><p>Parameters define the specific attributes of sections.</p><p>
    188188        Some parameters are specific to the [global] section (e.g., <span class="emphasis"><em>security</em></span>).  Some parameters
    189189        are usable in all sections (e.g., <span class="emphasis"><em>create mask</em></span>). All others are permissible only in normal
    … …  
    197197        find them! Where there are synonyms, the preferred synonym is described, others refer to the preferred
    198198        synonym.
    199         </p></div><div class="refsect1" lang="en"><a name="id300216"></a><h2>VARIABLE SUBSTITUTIONS</h2><p>
     199        </p></div><div class="refsect1" lang="en"><a name="id2532544"></a><h2>VARIABLE SUBSTITUTIONS</h2><p>
    200200        Many of the strings that are settable in the config file can take substitutions. For example the option
    201201        &#8220;<span class="quote">path = /tmp/%u</span>&#8221; is interpreted as &#8220;<span class="quote">path = /tmp/john</span>&#8221; if the user connected with the
    … …  
    259259                controls what the default case is for new filenames (ie. files that don't currently exist in the filesystem).
    260260                Default <span class="emphasis"><em>lower</em></span>.  IMPORTANT NOTE: This option will be used to modify the case of
    261                 <span class="emphasis"><em>all</em></span> incoming client filenames, not just new filenames if the options <a class="link" href="smb.conf.5.html#CASESENSITIVE">case sensitive = yes</a>, <a class="link" href="smb.conf.5.html#PRESERVECASE">preserve case = No</a>,
    262                 <a class="link" href="smb.conf.5.html#SHORTPRESERVECASE">short preserve case = No</a> are set.  This change is needed as part of the
     261                <span class="emphasis"><em>all</em></span> incoming client filenames, not just new filenames if the options <a class="link" href="smb.conf.5.html#CASESENSITIVE" target="_top">case sensitive = yes</a>, <a class="link" href="smb.conf.5.html#PRESERVECASE" target="_top">preserve case = No</a>,
     262                <a class="link" href="smb.conf.5.html#SHORTPRESERVECASE" target="_top">short preserve case = No</a> are set.  This change is needed as part of the
    263263                optimisations for directories containing large numbers of files.
    264264                </p></dd><dt><span class="term">preserve case = yes/no</span></dt><dd><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" lang="en"><a name="id300842"></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="id300851"></a>
     308                </p></li></ol></div></div><div class="refsect1" lang="en"><a name="id2533244"></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="id2533256"></a>
    309309
    310310abort shutdown script (G)
    311 </h3></div></div></div><a class="indexterm" name="id300852"></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
    312         should stop a shutdown procedure issued by the <a class="link" href="smb.conf.5.html#SHUTDOWNSCRIPT">shutdown script</a>.</p><p>If the connected user posseses the <code class="constant">SeRemoteShutdownPrivilege</code>,
     311</h3></div></div></div><a class="indexterm" name="id2533257"></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
     312        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>,
    313313        right, this command will be run as user.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>abort shutdown script</code></em> = <code class="literal">""</code>
    314314</em></span>
    315315</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>abort shutdown script</code></em> = <code class="literal">/sbin/shutdown -c</code>
    316316</em></span>
    317 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id300926"></a>
     317</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533336"></a>
    318318
    319319acl check permissions (S)
    320 </h3></div></div></div><a class="indexterm" name="id300927"></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"
     320</h3></div></div></div><a class="indexterm" name="id2533337"></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"
    321321    from a Windows client. If a Windows client doesn't have permissions to delete a file then they
    322322    expect this to be denied at open time. POSIX systems normally only detect restrictions on delete by
    … …  
    338338    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>acl check permissions</code></em> = <code class="literal">True</code>
    339339</em></span>
    340 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id257823"></a>
    341 
    342 acl compatibility (S)
    343 </h3></div></div></div><a class="indexterm" name="id257824"></a><a name="ACLCOMPATIBILITY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies what OS ACL semantics should
     340</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2481383"></a>
     341
     342acl compatibility (G)
     343</h3></div></div></div><a class="indexterm" name="id2481384"></a><a name="ACLCOMPATIBILITY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies what OS ACL semantics should
    344344        be compatible with. Possible values are <span class="emphasis"><em>winnt</em></span> for Windows NT 4,
    345345        <span class="emphasis"><em>win2k</em></span> for Windows 2000 and above and <span class="emphasis"><em>auto</em></span>.
    … …  
    350350</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>acl compatibility</code></em> = <code class="literal">win2k</code>
    351351</em></span>
    352 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id301129"></a>
     352</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2481459"></a>
    353353
    354354acl group control (S)
    355 </h3></div></div></div><a class="indexterm" name="id301130"></a><a name="ACLGROUPCONTROL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     355</h3></div></div></div><a class="indexterm" name="id2481460"></a><a name="ACLGROUPCONTROL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    356356        In a POSIX filesystem, only the owner of a file or directory and the superuser can modify the permissions
    357357        and ACLs on a file. If this parameter is set, then Samba overrides this restriction, and also allows the
    … …  
    369369        control the permissions on a file or directory they have group ownership on.
    370370        </p><p>
    371         This parameter is best used with the <a class="link" href="smb.conf.5.html#INHERITOWNER">inherit owner</a> option and also
     371        This parameter is best used with the <a class="link" href="smb.conf.5.html#INHERITOWNER" target="_top">inherit owner</a> option and also
    372372        on on a share containing directories with the UNIX <span class="emphasis"><em>setgid bit</em></span> set
    373373        on them, which causes new files and directories created within it to inherit the group
    … …  
    380380        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>acl group control</code></em> = <code class="literal">no</code>
    381381</em></span>
    382 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id301210"></a>
     382</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533727"></a>
    383383
    384384acl map full control (S)
    385 </h3></div></div></div><a class="indexterm" name="id301211"></a><a name="ACLMAPFULLCONTROL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     385</h3></div></div></div><a class="indexterm" name="id2533728"></a><a name="ACLMAPFULLCONTROL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    386386        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
    387387        allowed POSIX permission set, into a Windows ACL of "FULL CONTROL". If this parameter is set to true any POSIX
    … …  
    391391        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>acl map full control</code></em> = <code class="literal">True</code>
    392392</em></span>
    393 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id301258"></a>
     393</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533778"></a>
    394394
    395395add group script (G)
    396 </h3></div></div></div><a class="indexterm" name="id301259"></a><a name="ADDGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     396</h3></div></div></div><a class="indexterm" name="id2533779"></a><a name="ADDGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    397397        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
    398398        will expand any <em class="parameter"><code>%g</code></em> to the group name passed. This script is only useful
    … …  
    404404</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>add group script</code></em> = <code class="literal">/usr/sbin/groupadd %g</code>
    405405</em></span>
    406 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id301329"></a>
     406</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533853"></a>
    407407
    408408add machine script (G)
    409 </h3></div></div></div><a class="indexterm" name="id301330"></a><a name="ADDMACHINESCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     409</h3></div></div></div><a class="indexterm" name="id2533854"></a><a name="ADDMACHINESCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    410410        This is the full pathname to a script that will  be run by
    411411         <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when a machine is
    412412        added to Samba's domain and a Unix account matching the machine's name appended with a "$" does not
    413413        already exist.
    414         </p><p>This option is very similar to the <a class="link" href="smb.conf.5.html#ADDUSERSCRIPT">add user script</a>, and likewise uses the %u
     414        </p><p>This option is very similar to the <a class="link" href="smb.conf.5.html#ADDUSERSCRIPT" target="_top">add user script</a>, and likewise uses the %u
    415415        substitution for the account name.  Do not use the %m
    416416        substitution.  </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>add machine script</code></em> = <code class="literal"></code>
    … …  
    418418</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>
    419419</em></span>
    420 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id301402"></a>
     420</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533932"></a>
    421421
    422422add port command (G)
    423 </h3></div></div></div><a class="indexterm" name="id301403"></a><a name="ADDPORTCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>Samba 3.0.23 introduced support for adding printer ports
     423</h3></div></div></div><a class="indexterm" name="id2533933"></a><a name="ADDPORTCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>Samba 3.0.23 introduced support for adding printer ports
    424424        remotely using the Windows "Add Standard TCP/IP Port Wizard".
    425425        This option defines an external program to be executed when
    … …  
    430430</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>
    431431</em></span>
    432 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id301482"></a>
     432</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534015"></a>
    433433
    434434add printer command (G)
    435 </h3></div></div></div><a class="indexterm" name="id301483"></a><a name="ADDPRINTERCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printing
     435</h3></div></div></div><a class="indexterm" name="id2534016"></a><a name="ADDPRINTERCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printing
    436436    support for Windows NT/2000 clients in Samba 2.2, The MS Add
    437437    Printer Wizard (APW) icon is now also available in the
    … …  
    462462</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>add printer command</code></em> = <code class="literal">/usr/bin/addprinter</code>
    463463</em></span>
    464 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id301651"></a>
     464</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534199"></a>
    465465
    466466add share command (G)
    467 </h3></div></div></div><a class="indexterm" name="id301652"></a><a name="ADDSHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     467</h3></div></div></div><a class="indexterm" name="id2534200"></a><a name="ADDSHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    468468        Samba 2.2.0 introduced the ability to dynamically add and delete shares via the Windows NT 4.0 Server
    469469        Manager.  The <em class="parameter"><code>add share command</code></em> is used to define an external program
    470         or script which will add a new service definition to <code class="filename">smb.conf</code>.  In order
    471         to successfully execute the <em class="parameter"><code>add share command</code></em>, <code class="literal">smbd</code> requires that the administrator be connected using a root account (i.e.  uid == 0).
    472         </p><p>
    473     If the connected account has <code class="literal">SeDiskOperatorPrivilege</code>, scripts defined in
    474     <em class="parameter"><code>change share</code></em> parameter are executed as root.
    475     </p><p>
     470        or script which will add a new service definition to
     471        <code class="filename">smb.conf</code>.
     472        </p><p>
     473        In order to successfully execute the
     474        <em class="parameter"><code>add share command</code></em>,
     475        <code class="literal">smbd</code> requires that the administrator
     476        connects using a root account (i.e.  uid == 0) or has the
     477        <code class="literal">SeDiskOperatorPrivilege</code>.
     478        Scripts defined in the <em class="parameter"><code>add share command</code></em>
     479        parameter are executed as root.
     480        </p><p>
    476481        When executed, <code class="literal">smbd</code> will automatically invoke the
    477482        <em class="parameter"><code>add share command</code></em> with five parameters.
    … …  
    487492                        share.
    488493                        </p></li></ul></div><p>
    489         This parameter is only used for add file shares.  To add printer shares, see the <a class="link" href="smb.conf.5.html#ADDPRINTERCOMMAND">addprinter command</a>.
     494        This parameter is only used to add file shares. To add printer shares, see the <a class="link" href="smb.conf.5.html#ADDPRINTERCOMMAND" target="_top">addprinter command</a>.
    490495        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>add share command</code></em> = <code class="literal"></code>
    491496</em></span>
    492497</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>add share command</code></em> = <code class="literal">/usr/local/bin/addshare</code>
    493498</em></span>
    494 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id301826"></a>
     499</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534384"></a>
    495500
    496501add user script (G)
    497 </h3></div></div></div><a class="indexterm" name="id301827"></a><a name="ADDUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     502</h3></div></div></div><a class="indexterm" name="id2534385"></a><a name="ADDUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    498503        This is the full pathname to a script that will be run <span class="emphasis"><em>AS ROOT</em></span> by
    499504        <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>
    … …  
    507512        </p><p>
    508513        In order to use this option, <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> must <span class="emphasis"><em>NOT</em></span> be set to
    509         <a class="link" href="smb.conf.5.html#SECURITY">security = share</a> and <a class="link" href="smb.conf.5.html#ADDUSERSCRIPT">add user script</a>
     514        <a class="link" href="smb.conf.5.html#SECURITY" target="_top">security = share</a> and <a class="link" href="smb.conf.5.html#ADDUSERSCRIPT" target="_top">add user script</a>
    510515        must be set to a full pathname for a script that will create a UNIX user given one argument of
    511516        <em class="parameter"><code>%u</code></em>, which expands into the UNIX user name to create.
    512517        </p><p>
    513518        When the Windows user attempts to access the Samba server, at login (session setup in
    514         the SMB protocol) time, <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> contacts the <a class="link" href="smb.conf.5.html#PASSWORDSERVER">password server</a>
     519        the SMB protocol) time, <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> contacts the <a class="link" href="smb.conf.5.html#PASSWORDSERVER" target="_top">password server</a>
    515520        and attempts to authenticate the given user with the given password. If the authentication
    516521        succeeds then <code class="literal">smbd</code> attempts to find a UNIX user in the UNIX
    517522        password database to map the Windows user into. If this lookup fails, and
    518         <a class="link" href="smb.conf.5.html#ADDUSERSCRIPT">add user script</a> is set then <code class="literal">smbd</code> will
     523        <a class="link" href="smb.conf.5.html#ADDUSERSCRIPT" target="_top">add user script</a> is set then <code class="literal">smbd</code> will
    519524        call the specified script <span class="emphasis"><em>AS ROOT</em></span>, expanding any
    520525        <em class="parameter"><code>%u</code></em> argument to be the user name to create.
    … …  
    524529        match existing Windows NT accounts.
    525530        </p><p>
    526         See also <a class="link" href="smb.conf.5.html#SECURITY">security</a>, <a class="link" href="smb.conf.5.html#PASSWORDSERVER">password server</a>,
    527         <a class="link" href="smb.conf.5.html#DELETEUSERSCRIPT">delete user script</a>.
     531        See also <a class="link" href="smb.conf.5.html#SECURITY" target="_top">security</a>, <a class="link" href="smb.conf.5.html#PASSWORDSERVER" target="_top">password server</a>,
     532        <a class="link" href="smb.conf.5.html#DELETEUSERSCRIPT" target="_top">delete user script</a>.
    528533        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>add user script</code></em> = <code class="literal"></code>
    529534</em></span>
    530535</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>
    531536</em></span>
    532 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id302015"></a>
     537</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534596"></a>
    533538
    534539add user to group script (G)
    535 </h3></div></div></div><a class="indexterm" name="id302016"></a><a name="ADDUSERTOGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     540</h3></div></div></div><a class="indexterm" name="id2534597"></a><a name="ADDUSERTOGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    536541        Full path to the script that will be called when a user is added to a group using the Windows NT domain administration
    537542        tools. It will be run by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>
    … …  
    545550</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>
    546551</em></span>
    547 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id302098"></a>
     552</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534682"></a>
    548553
    549554admin users (S)
    550 </h3></div></div></div><a class="indexterm" name="id302099"></a><a name="ADMINUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of users who will be granted
     555</h3></div></div></div><a class="indexterm" name="id2534683"></a><a name="ADMINUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of users who will be granted
    551556    administrative privileges on the share. This means that they
    552557    will do all file operations as the super-user (root).</p><p>You should use this option very carefully, as any user in
    553558    this list will be able to do anything they like on the share,
    554     irrespective of file permissions.</p><p>This parameter will not work with the <a class="link" href="smb.conf.5.html#SECURITY">security = share</a> in
     559    irrespective of file permissions.</p><p>This parameter will not work with the <a class="link" href="smb.conf.5.html#SECURITY" target="_top">security = share</a> in
    555560    Samba 3.0.  This is by design.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>admin users</code></em> = <code class="literal"></code>
    556561</em></span>
    557562</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>admin users</code></em> = <code class="literal">jason</code>
    558563</em></span>
    559 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id302166"></a>
     564</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534755"></a>
    560565
    561566afs share (S)
    562 </h3></div></div></div><a class="indexterm" name="id302167"></a><a name="AFSSHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether special AFS features are enabled
     567</h3></div></div></div><a class="indexterm" name="id2534756"></a><a name="AFSSHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether special AFS features are enabled
    563568        for this share. If enabled, it assumes that the directory exported via
    564569        the <em class="parameter"><code>path</code></em> parameter is a local AFS import. The
    … …  
    567572        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>afs share</code></em> = <code class="literal">no</code>
    568573</em></span>
    569 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id302211"></a>
     574</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534803"></a>
    570575
    571576afs username map (G)
    572 </h3></div></div></div><a class="indexterm" name="id302212"></a><a name="AFSUSERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>If you are using the fake kaserver AFS feature, you might
     577</h3></div></div></div><a class="indexterm" name="id2534804"></a><a name="AFSUSERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>If you are using the fake kaserver AFS feature, you might
    573578        want to hand-craft the usernames you are creating tokens for.
    574579        For example this is necessary if you have users from several domain
    … …  
    580585</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>afs username map</code></em> = <code class="literal">%u@afs.samba.org</code>
    581586</em></span>
    582 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id302269"></a>
     587</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534865"></a>
    583588
    584589aio read size (S)
    585 </h3></div></div></div><a class="indexterm" name="id302270"></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
     590</h3></div></div></div><a class="indexterm" name="id2534866"></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
    586591    integer parameter is set to non-zero value,
    587592    Samba will read from file asynchronously when size of request is bigger
    588593    than this value. Note that it happens only for non-chained and non-chaining
    589594    reads and when not using write cache.</p><p>Current implementation of asynchronous I/O in Samba 3.0 does support
    590     only up to 10 outstanding asynchronous requests, read and write combined.</p><p>Related command: <a class="link" href="smb.conf.5.html#WRITECACHESIZE">write cache size</a></p><p>Related command: <a class="link" href="smb.conf.5.html#AIOWRITESIZE">aio write size</a></p><p>Default: <span class="emphasis"><em><em class="parameter"><code>aio read size</code></em> = <code class="literal">0</code>
     595    only up to 10 outstanding asynchronous requests, read and write combined.</p><p>Related command: <a class="link" href="smb.conf.5.html#WRITECACHESIZE" target="_top">write cache size</a></p><p>Related command: <a class="link" href="smb.conf.5.html#AIOWRITESIZE" target="_top">aio write size</a></p><p>Default: <span class="emphasis"><em><em class="parameter"><code>aio read size</code></em> = <code class="literal">0</code>
    591596</em></span>
    592597</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>aio read size</code></em> = <code class="literal">16384
    … …  
    594599    request size</code>
    595600</em></span>
    596 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id302349"></a>
     601</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2534952"></a>
    597602
    598603aio write size (S)
    599 </h3></div></div></div><a class="indexterm" name="id302350"></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
     604</h3></div></div></div><a class="indexterm" name="id2534953"></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
    600605    integer parameter is set to non-zero value,
    601606    Samba will write to file asynchronously when size of request is bigger
    602607    than this value. Note that it happens only for non-chained and non-chaining
    603608    reads and when not using write cache.</p><p>Current implementation of asynchronous I/O in Samba 3.0 does support
    604     only up to 10 outstanding asynchronous requests, read and write combined.</p><p>Related command: <a class="link" href="smb.conf.5.html#WRITECACHESIZE">write cache size</a></p><p>Related command: <a class="link" href="smb.conf.5.html#AIOREADSIZE">aio read size</a></p><p>Default: <span class="emphasis"><em><em class="parameter"><code>aio write size</code></em> = <code class="literal">0</code>
     609    only up to 10 outstanding asynchronous requests, read and write combined.</p><p>Related command: <a class="link" href="smb.conf.5.html#WRITECACHESIZE" target="_top">write cache size</a></p><p>Related command: <a class="link" href="smb.conf.5.html#AIOREADSIZE" target="_top">aio read size</a></p><p>Default: <span class="emphasis"><em><em class="parameter"><code>aio write size</code></em> = <code class="literal">0</code>
    605610</em></span>
    606611</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>aio write size</code></em> = <code class="literal">16384
    … …  
    608613    request size</code>
    609614</em></span>
    610 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id302428"></a>
     615</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535038"></a>
    611616
    612617algorithmic rid base (G)
    613 </h3></div></div></div><a class="indexterm" name="id302429"></a><a name="ALGORITHMICRIDBASE"></a><div class="variablelist"><dl><dt></dt><dd><p>This determines how Samba will use its
     618</h3></div></div></div><a class="indexterm" name="id2535039"></a><a name="ALGORITHMICRIDBASE"></a><div class="variablelist"><dl><dt></dt><dd><p>This determines how Samba will use its
    614619    algorithmic mapping from uids/gid to the RIDs needed to construct
    615620    NT Security Identifiers.
    … …  
    626631</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>algorithmic rid base</code></em> = <code class="literal">100000</code>
    627632</em></span>
    628 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id302493"></a>
     633</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535108"></a>
    629634
    630635allocation roundup size (S)
    631 </h3></div></div></div><a class="indexterm" name="id302494"></a><a name="ALLOCATIONROUNDUPSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows an administrator to tune the
     636</h3></div></div></div><a class="indexterm" name="id2535109"></a><a name="ALLOCATIONROUNDUPSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows an administrator to tune the
    632637    allocation size reported to Windows clients.  The default
    633638    size of 1Mb generally results in improved Windows client
    … …  
    641646# (to disable roundups)</code>
    642647</em></span>
    643 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id302553"></a>
     648</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535173"></a>
    644649
    645650allow trusted domains (G)
    646 </h3></div></div></div><a class="indexterm" name="id302554"></a><a name="ALLOWTRUSTEDDOMAINS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    647     This option only takes effect when the <a class="link" href="smb.conf.5.html#SECURITY">security</a> option is set to
     651</h3></div></div></div><a class="indexterm" name="id2535174"></a><a name="ALLOWTRUSTEDDOMAINS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     652    This option only takes effect when the <a class="link" href="smb.conf.5.html#SECURITY" target="_top">security</a> option is set to
    648653    <code class="constant">server</code>, <code class="constant">domain</code> or <code class="constant">ads</code>. 
    649654    If it is set to no, then attempts to connect to a resource from
    … …  
    659664    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>
    660665</em></span>
    661 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id302616"></a>
     666</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535245"></a>
    662667
    663668announce as (G)
    664 </h3></div></div></div><a class="indexterm" name="id302617"></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
     669</h3></div></div></div><a class="indexterm" name="id2535246"></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
    665670    list. By default this is set to Windows NT. The valid options
    666671    are : "NT Server" (which can also be written as "NT"),
    … …  
    674679</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>announce as</code></em> = <code class="literal">Win95</code>
    675680</em></span>
    676 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id302685"></a>
     681</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535323"></a>
    677682
    678683announce version (G)
    679 </h3></div></div></div><a class="indexterm" name="id302686"></a><a name="ANNOUNCEVERSION"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the major and minor version numbers
     684</h3></div></div></div><a class="indexterm" name="id2535324"></a><a name="ANNOUNCEVERSION"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the major and minor version numbers
    680685    that nmbd will use when announcing itself as a server. The default
    681686    is 4.9.  Do not change this parameter unless you have a specific
    … …  
    684689</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>announce version</code></em> = <code class="literal">2.0</code>
    685690</em></span>
    686 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id302740"></a>
     691</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535380"></a>
    687692
    688693auth methods (G)
    689 </h3></div></div></div><a class="indexterm" name="id302741"></a><a name="AUTHMETHODS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     694</h3></div></div></div><a class="indexterm" name="id2535381"></a><a name="AUTHMETHODS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    690695    This option allows the administrator to chose what authentication methods <code class="literal">smbd</code>
    691     will use when authenticating a user. This option defaults to sensible values based on <a class="link" href="smb.conf.5.html#SECURITY">security</a>. 
     696    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>. 
    692697    This should be considered a developer option and used only in rare circumstances.  In the majority (if not all)
    693698    of production servers, the default setting should be adequate.
    … …  
    708713</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>auth methods</code></em> = <code class="literal">guest sam winbind</code>
    709714</em></span>
    710 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id302836"></a>
     715</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535486"></a>
    711716
    712717available (S)
    713 </h3></div></div></div><a class="indexterm" name="id302837"></a><a name="AVAILABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter lets you "turn off" a service. If
     718</h3></div></div></div><a class="indexterm" name="id2535487"></a><a name="AVAILABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter lets you "turn off" a service. If
    714719        <em class="parameter"><code>available = no</code></em>, then <span class="emphasis"><em>ALL</em></span>
    715720        attempts to connect to the service will fail. Such failures are
    716721        logged.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>available</code></em> = <code class="literal">yes</code>
    717722</em></span>
    718 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id302882"></a>
     723</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535533"></a>
    719724
    720725bind interfaces only (G)
    721 </h3></div></div></div><a class="indexterm" name="id302883"></a><a name="BINDINTERFACESONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This global parameter allows the Samba admin
     726</h3></div></div></div><a class="indexterm" name="id2535534"></a><a name="BINDINTERFACESONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This global parameter allows the Samba admin
    722727        to limit what interfaces on a machine will serve SMB requests. It
    723728        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>
    724729        For name service it causes <code class="literal">nmbd</code> to bind to ports 137 and 138 on the
    725         interfaces listed in the <a class="link" href="smb.conf.5.html#INTERFACES">interfaces</a> parameter. <code class="literal">nmbd</code>
     730        interfaces listed in the <a class="link" href="smb.conf.5.html#INTERFACES" target="_top">interfaces</a> parameter. <code class="literal">nmbd</code>
    726731        also binds to the "all addresses" interface (0.0.0.0) on ports 137 and 138 for the purposes of
    727732        reading broadcast messages.  If this option is not set then <code class="literal">nmbd</code> will
    728         service name requests on all of these sockets. If <a class="link" href="smb.conf.5.html#BINDINTERFACESONLY">bind interfaces only</a> is set then
     733        service name requests on all of these sockets. If <a class="link" href="smb.conf.5.html#BINDINTERFACESONLY" target="_top">bind interfaces only</a> is set then
    729734         <code class="literal">nmbd</code> will check the source address of any packets coming in on the
    730735        broadcast sockets and discard any that don't match the broadcast addresses of the interfaces in the
    731         <a class="link" href="smb.conf.5.html#INTERFACES">interfaces</a> parameter list.  As unicast packets are received on the other sockets it
     736        <a class="link" href="smb.conf.5.html#INTERFACES" target="_top">interfaces</a> parameter list.  As unicast packets are received on the other sockets it
    732737        allows <code class="literal">nmbd</code> to refuse to serve names to machines that send packets that
    733         arrive through any interfaces not listed in the <a class="link" href="smb.conf.5.html#INTERFACES">interfaces</a> list.  IP Source address
     738        arrive through any interfaces not listed in the <a class="link" href="smb.conf.5.html#INTERFACES" target="_top">interfaces</a> list.  IP Source address
    734739        spoofing does defeat this simple check, however, so it must not be used seriously as a security feature for
    735740         <code class="literal">nmbd</code>.
    736741        </p><p>
    737         For file service it causes <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> to bind only to the interface list given in the <a class="link" href="smb.conf.5.html#INTERFACES">interfaces</a> parameter. This restricts the networks that <code class="literal">smbd</code> will
     742        For file service it causes <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> to bind only to the interface list given in the <a class="link" href="smb.conf.5.html#INTERFACES" target="_top">interfaces</a> parameter. This restricts the networks that <code class="literal">smbd</code> will
    738743        serve to packets coming in those interfaces.  Note that you should not use this parameter for machines that
    739744        are serving PPP or other intermittent or non-broadcast network interfaces as it will not cope with
    740745        non-permanent interfaces.
    741746        </p><p>
    742         If <a class="link" href="smb.conf.5.html#BINDINTERFACESONLY">bind interfaces only</a> is set then unless the network address
    743          <span class="emphasis"><em>127.0.0.1</em></span> is added to the <a class="link" href="smb.conf.5.html#INTERFACES">interfaces</a> parameter list
     747        If <a class="link" href="smb.conf.5.html#BINDINTERFACESONLY" target="_top">bind interfaces only</a> is set then unless the network address
     748         <span class="emphasis"><em>127.0.0.1</em></span> is added to the <a class="link" href="smb.conf.5.html#INTERFACES" target="_top">interfaces</a> parameter list
    744749         <a class="citerefentry" href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a> and
    745750         <a class="citerefentry" href="swat.8.html"><span class="citerefentry"><span class="refentrytitle">swat</span>(8)</span></a> may not work as
    … …  
    748753        To change a users SMB password, the <code class="literal">smbpasswd</code> by default connects to the
    749754         <span class="emphasis"><em>localhost - 127.0.0.1</em></span> address as an SMB client to issue the password change request. If
    750         <a class="link" href="smb.conf.5.html#BINDINTERFACESONLY">bind interfaces only</a> is set then unless the network address
    751          <span class="emphasis"><em>127.0.0.1</em></span> is added to the <a class="link" href="smb.conf.5.html#INTERFACES">interfaces</a> parameter list then <code class="literal"> smbpasswd</code> will fail to connect in it's default mode.  <code class="literal">smbpasswd</code> can be forced to use the primary IP interface of the local host by using
     755        <a class="link" href="smb.conf.5.html#BINDINTERFACESONLY" target="_top">bind interfaces only</a> is set then unless the network address
     756         <span class="emphasis"><em>127.0.0.1</em></span> is added to the <a class="link" href="smb.conf.5.html#INTERFACES" target="_top">interfaces</a> parameter list then <code class="literal"> smbpasswd</code> will fail to connect in it's default mode.  <code class="literal">smbpasswd</code> can be forced to use the primary IP interface of the local host by using
    752757        its <a class="citerefentry" href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a>       <em class="parameter"><code>-r <em class="replaceable"><code>remote machine</code></em></code></em> parameter, with <em class="replaceable"><code>remote
    753758        machine</code></em> set to the IP name of the primary interface of the local host.
    … …  
    760765        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>bind interfaces only</code></em> = <code class="literal">no</code>
    761766</em></span>
    762 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id303179"></a>
     767</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535860"></a>
    763768
    764769blocking locks (S)
    765 </h3></div></div></div><a class="indexterm" name="id303180"></a><a name="BLOCKINGLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls the behavior
     770</h3></div></div></div><a class="indexterm" name="id2535861"></a><a name="BLOCKINGLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls the behavior
    766771        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
    767772        to obtain a byte range lock on a region of an open file, and the
    … …  
    774779        cannot be obtained.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>blocking locks</code></em> = <code class="literal">yes</code>
    775780</em></span>
    776 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id303237"></a>
     781</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2535924"></a>
    777782
    778783block size (S)
    779 </h3></div></div></div><a class="indexterm" name="id303238"></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
     784</h3></div></div></div><a class="indexterm" name="id2535926"></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
    780785    sizes. By default, this reports a disk block size of 1024 bytes.
    781786    </p><p>Changing this parameter may have some effect on the
    … …  
    791796</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>block size</code></em> = <code class="literal">4096</code>
    792797</em></span>
    793 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id303309"></a>
     798</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536002"></a>
    794799
    795800<a name="BROWSABLE"></a>browsable
    796 </h3></div></div></div><a class="indexterm" name="id303310"></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="id303335"></a>
     801</h3></div></div></div><a class="indexterm" name="id2536004"></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="id2536029"></a>
    797802
    798803browseable (S)
    799 </h3></div></div></div><a class="indexterm" name="id303336"></a><a name="BROWSEABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether this share is seen in
     804</h3></div></div></div><a class="indexterm" name="id2536030"></a><a name="BROWSEABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether this share is seen in
    800805        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>
    801806</em></span>
    802 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id303373"></a>
     807</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536068"></a>
    803808
    804809browse list (G)
    805 </h3></div></div></div><a class="indexterm" name="id303374"></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
     810</h3></div></div></div><a class="indexterm" name="id2536069"></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
    806811        a client doing a <code class="literal">NetServerEnum</code> call. Normally
    807812        set to <code class="constant">yes</code>. You should never need to change
    808813        this.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>browse list</code></em> = <code class="literal">yes</code>
    809814</em></span>
    810 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id303426"></a>
     815</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536123"></a>
    811816
    812817<a name="CASESIGNAMES"></a>casesignames
    813 </h3></div></div></div><a class="indexterm" name="id303427"></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="id303452"></a>
     818</h3></div></div></div><a class="indexterm" name="id2536124"></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="id2536150"></a>
    814819
    815820case sensitive (S)
    816 </h3></div></div></div><a class="indexterm" name="id303453"></a><a name="CASESENSITIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>See the discussion in the section <a class="link" href="smb.conf.5.html#NAMEMANGLING">name mangling</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>case sensitive</code></em> = <code class="literal">no</code>
    817 </em></span>
    818 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id303496"></a>
     821</h3></div></div></div><a class="indexterm" name="id2536151"></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>
     822</em></span>
     823</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536196"></a>
    819824
    820825change notify (S)
    821 </h3></div></div></div><a class="indexterm" name="id303497"></a><a name="CHANGENOTIFY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should reply
     826</h3></div></div></div><a class="indexterm" name="id2536197"></a><a name="CHANGENOTIFY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should reply
    822827        to a client's file change notify requests.
    823828        </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>
    824829</em></span>
    825 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id303537"></a>
     830</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536239"></a>
    826831
    827832change share command (G)
    828 </h3></div></div></div><a class="indexterm" name="id303538"></a><a name="CHANGESHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     833</h3></div></div></div><a class="indexterm" name="id2536240"></a><a name="CHANGESHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    829834        Samba 2.2.0 introduced the ability to dynamically add and delete shares via the Windows NT 4.0 Server
    830835Manager.  The <em class="parameter"><code>change share command</code></em> is used to define an external
    831 program or script which will modify an existing service definition in <code class="filename">smb.conf</code>.  In order to successfully execute the <em class="parameter"><code>change
    832 share command</code></em>, <code class="literal">smbd</code> requires that the administrator be
    833 connected using a root account (i.e. uid == 0).
    834         </p><p>
    835         If the connected account has <code class="literal">SeDiskOperatorPrivilege</code>, scripts defined in
    836         <em class="parameter"><code>change share</code></em> parameter are executed as root.
     836program or script which will modify an existing service definition in <code class="filename">smb.conf</code>.
     837        </p><p>
     838        In order to successfully execute the
     839        <em class="parameter"><code>change share command</code></em>,
     840        <code class="literal">smbd</code> requires that the administrator
     841        connects using a root account (i.e. uid == 0) or has the
     842        <code class="literal">SeDiskOperatorPrivilege</code>.
     843        Scripts defined in the <em class="parameter"><code>change share command</code></em>
     844        parameter are executed as root.
    837845        </p><p>
    838846        When executed, <code class="literal">smbd</code> will automatically invoke the
    … …  
    851859                        share.
    852860                        </p></li></ul></div><p>
    853         This parameter is only used modify existing file shares definitions.  To modify
    854         printer shares, use the "Printers..." folder as seen when browsing the Samba host.
     861        This parameter is only used to modify existing file share definitions.
     862        To modify printer shares, use the "Printers..." folder as seen
     863        when browsing the Samba host.
    855864        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>change share command</code></em> = <code class="literal"></code>
    856865</em></span>
    857 </p><p>Example: <span class="emphasis"><em><em class="parameter"><code>change share command</code></em> = <code class="literal">/usr/local/bin/addshare</code>
    858 </em></span>
    859 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id303706"></a>
     866</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>change share command</code></em> = <code class="literal">/usr/local/bin/changeshare</code>
     867</em></span>
     868</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536418"></a>
    860869
    861870check password script (G)
    862 </h3></div></div></div><a class="indexterm" name="id303707"></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
     871</h3></div></div></div><a class="indexterm" name="id2536419"></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
    863872    complexity. The password is sent to the program's standrad input.</p><p>The program must return 0 on good password any other value otherwise.
    864873    In case the password is considered weak (the program do not return 0) the
    … …  
    868877</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>check password script</code></em> = <code class="literal">check password script = /usr/local/sbin/crackcheck</code>
    869878</em></span>
    870 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id303770"></a>
     879</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536486"></a>
    871880
    872881client lanman auth (G)
    873 </h3></div></div></div><a class="indexterm" name="id303771"></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
     882</h3></div></div></div><a class="indexterm" name="id2536487"></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
    874883    tools will attempt to authenticate itself to servers using the
    875884    weaker LANMAN password hash. If disabled, only server which support NT
    … …  
    882891    attempted.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client lanman auth</code></em> = <code class="literal">yes</code>
    883892</em></span>
    884 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id303839"></a>
     893</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536562"></a>
    885894
    886895client ntlmv2 auth (G)
    887 </h3></div></div></div><a class="indexterm" name="id303840"></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
     896</h3></div></div></div><a class="indexterm" name="id2536563"></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
    888897    authenticate itself to servers using the NTLMv2 encrypted password
    889898    response.</p><p>If enabled, only an NTLMv2 and LMv2 response (both much more
    … …  
    897906        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>
    898907</em></span>
    899 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id303919"></a>
     908</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536650"></a>
    900909
    901910client plaintext auth (G)
    902 </h3></div></div></div><a class="indexterm" name="id303920"></a><a name="CLIENTPLAINTEXTAUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies whether a client should send a plaintext
     911</h3></div></div></div><a class="indexterm" name="id2536651"></a><a name="CLIENTPLAINTEXTAUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies whether a client should send a plaintext
    903912                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">yes</code>
    904913</em></span>
    905 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id303956"></a>
     914</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536689"></a>
    906915
    907916client schannel (G)
    908 </h3></div></div></div><a class="indexterm" name="id303958"></a><a name="CLIENTSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     917</h3></div></div></div><a class="indexterm" name="id2536690"></a><a name="CLIENTSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    909918    This controls whether the client offers or even demands the use of the netlogon schannel.
    910     <a class="link" href="smb.conf.5.html#CLIENTSCHANNEL">client schannel = no</a> does not offer the schannel,
    911     <a class="link" href="smb.conf.5.html#CLIENTSCHANNEL">client schannel = auto</a> offers the schannel but does not
    912     enforce it, and <a class="link" href="smb.conf.5.html#CLIENTSCHANNEL">client schannel = yes</a> denies access
     919    <a class="link" href="smb.conf.5.html#CLIENTSCHANNEL" target="_top">client schannel = no</a> does not offer the schannel,
     920    <a class="link" href="smb.conf.5.html#CLIENTSCHANNEL" target="_top">client schannel = auto</a> offers the schannel but does not
     921    enforce it, and <a class="link" href="smb.conf.5.html#CLIENTSCHANNEL" target="_top">client schannel = yes</a> denies access
    913922    if the server is not able to speak netlogon schannel.
    914923    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client schannel</code></em> = <code class="literal">auto</code>
    … …  
    916925</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>client schannel</code></em> = <code class="literal">yes</code>
    917926</em></span>
    918 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id304032"></a>
     927</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536773"></a>
    919928
    920929client signing (G)
    921 </h3></div></div></div><a class="indexterm" name="id304033"></a><a name="CLIENTSIGNING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether the client offers or requires
     930</h3></div></div></div><a class="indexterm" name="id2536774"></a><a name="CLIENTSIGNING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether the client offers or requires
    922931    the server it talks to to use SMB signing. Possible values
    923932    are <span class="emphasis"><em>auto</em></span>, <span class="emphasis"><em>mandatory</em></span>
    … …  
    928937</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client signing</code></em> = <code class="literal">auto</code>
    929938</em></span>
    930 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id304085"></a>
     939</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536828"></a>
    931940
    932941client use spnego (G)
    933 </h3></div></div></div><a class="indexterm" name="id304086"></a><a name="CLIENTUSESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p> This variable controls whether Samba clients will try
     942</h3></div></div></div><a class="indexterm" name="id2536829"></a><a name="CLIENTUSESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p> This variable controls whether Samba clients will try
    934943    to use Simple and Protected NEGOciation (as specified by rfc2478) with
    935944    supporting servers (including WindowsXP, Windows2000 and Samba
    … …  
    937946    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>
    938947</em></span>
    939 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id304124"></a>
     948</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536870"></a>
    940949
    941950comment (S)
    942 </h3></div></div></div><a class="indexterm" name="id304125"></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
     951</h3></div></div></div><a class="indexterm" name="id2536871"></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
    943952        when a client does a queries the server, either via the network
    944953        neighborhood or via <code class="literal">net view</code> to list what shares
    945954        are available.</p><p>If you want to set the string that is displayed next to the
    946                 machine name then see the <a class="link" href="smb.conf.5.html#SERVERSTRING">server string</a> parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>comment</code></em> = <code class="literal">
     955                machine name then see the <a class="link" href="smb.conf.5.html#SERVERSTRING" target="_top">server string</a> parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>comment</code></em> = <code class="literal">
    947956# No comment</code>
    948957</em></span>
    949958</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>comment</code></em> = <code class="literal">Fred's Files</code>
    950959</em></span>
    951 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id304195"></a>
     960</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536944"></a>
    952961
    953962config file (G)
    954 </h3></div></div></div><a class="indexterm" name="id304196"></a><a name="CONFIGFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the config file
     963</h3></div></div></div><a class="indexterm" name="id2536945"></a><a name="CONFIGFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the config file
    955964        to use, instead of the default (usually <code class="filename">smb.conf</code>).
    956965        There is a chicken and egg problem here as this option is set
    … …  
    962971        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>
    963972</em></span>
    964 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id304255"></a>
     973</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537010"></a>
    965974
    966975copy (S)
    967 </h3></div></div></div><a class="indexterm" name="id304256"></a><a name="COPY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows you to "clone" service
     976</h3></div></div></div><a class="indexterm" name="id2537011"></a><a name="COPY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows you to "clone" service
    968977        entries. The specified service is simply duplicated under the
    969978        current service's name. Any parameters specified in the current
    … …  
    975984</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>copy</code></em> = <code class="literal">otherservice</code>
    976985</em></span>
    977 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id304314"></a>
     986</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537072"></a>
    978987
    979988<a name="CREATEMODE"></a>create mode
    980 </h3></div></div></div><a class="indexterm" name="id304315"></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="id304340"></a>
     989</h3></div></div></div><a class="indexterm" name="id2537073"></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="id2537099"></a>
    981990
    982991create mask (S)
    983 </h3></div></div></div><a class="indexterm" name="id304341"></a><a name="CREATEMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
     992</h3></div></div></div><a class="indexterm" name="id2537100"></a><a name="CREATEMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
    984993        When a file is created, the necessary permissions are calculated according to the mapping from DOS modes to
    985994        UNIX permissions, and the resulting UNIX mode is then bit-wise 'AND'ed with this parameter. This parameter may
    … …  
    9911000        </p><p>
    9921001        Following this Samba will bit-wise 'OR' the UNIX mode created from this parameter with the value of the
    993         <a class="link" href="smb.conf.5.html#FORCECREATEMODE">force create mode</a> parameter which is set to 000 by default.
    994         </p><p>
    995         This parameter does not affect directory masks. See the parameter <a class="link" href="smb.conf.5.html#DIRECTORYMASK">directory mask</a>
     1002        <a class="link" href="smb.conf.5.html#FORCECREATEMODE" target="_top">force create mode</a> parameter which is set to 000 by default.
     1003        </p><p>
     1004        This parameter does not affect directory masks. See the parameter <a class="link" href="smb.conf.5.html#DIRECTORYMASK" target="_top">directory mask</a>
    9961005        for details.
    9971006        </p><p>
    9981007        Note that this parameter does not apply to permissions set by Windows NT/2000 ACL editors. If the
    999         administrator wishes to enforce a mask on access control lists also, they need to set the <a class="link" href="smb.conf.5.html#SECURITYMASK">security mask</a>.
     1008        administrator wishes to enforce a mask on access control lists also, they need to set the <a class="link" href="smb.conf.5.html#SECURITYMASK" target="_top">security mask</a>.
    10001009        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>create mask</code></em> = <code class="literal">0744</code>
    10011010</em></span>
    10021011</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>create mask</code></em> = <code class="literal">0775</code>
    10031012</em></span>
    1004 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id304448"></a>
     1013</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537220"></a>
    10051014
    10061015csc policy (S)
    1007 </h3></div></div></div><a class="indexterm" name="id304449"></a><a name="CSCPOLICY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1016</h3></div></div></div><a class="indexterm" name="id2537221"></a><a name="CSCPOLICY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    10081017        This stands for <span class="emphasis"><em>client-side caching policy</em></span>, and specifies how clients capable of offline
    10091018        caching will cache the files in the share. The valid values are: manual, documents, programs, disable.
    … …  
    10121021        </p><p>
    10131022        For example, shares containing roaming profiles can have offline caching disabled using
    1014         <a class="link" href="smb.conf.5.html#CSCPOLICY">csc policy = disable</a>.
     1023        <a class="link" href="smb.conf.5.html#CSCPOLICY" target="_top">csc policy = disable</a>.
    10151024        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>csc policy</code></em> = <code class="literal">manual</code>
    10161025</em></span>
    10171026</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>csc policy</code></em> = <code class="literal">programs</code>
    10181027</em></span>
    1019 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id304520"></a>
     1028</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537295"></a>
    10201029
    10211030cups options (S)
    1022 </h3></div></div></div><a class="indexterm" name="id304521"></a><a name="CUPSOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    1023     This parameter is only applicable if <a class="link" href="smb.conf.5.html#PRINTING">printing</a> is
     1031</h3></div></div></div><a class="indexterm" name="id2537296"></a><a name="CUPSOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1032    This parameter is only applicable if <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing</a> is
    10241033    set to <code class="constant">cups</code>.  Its value is a free form string of options
    10251034    passed directly to the cups library. 
    … …  
    10421051</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>cups options</code></em> = <code class="literal">"raw media=a4"</code>
    10431052</em></span>
    1044 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id304610"></a>
     1053</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537393"></a>
    10451054
    10461055cups server (G)
    1047 </h3></div></div></div><a class="indexterm" name="id304611"></a><a name="CUPSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    1048     This parameter is only applicable if <a class="link" href="smb.conf.5.html#PRINTING">printing</a> is set to <code class="constant">cups</code>.
     1056</h3></div></div></div><a class="indexterm" name="id2537394"></a><a name="CUPSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1057    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>.
    10491058    </p><p>
    10501059   If set, this option overrides the ServerName option in the CUPS <code class="filename">client.conf</code>. This is
    … …  
    10591068</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>cups server</code></em> = <code class="literal">mycupsserver:1631</code>
    10601069</em></span>
    1061 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id304702"></a>
     1070</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537491"></a>
    10621071
    10631072deadtime (G)
    1064 </h3></div></div></div><a class="indexterm" name="id304703"></a><a name="DEADTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a decimal integer)
     1073</h3></div></div></div><a class="indexterm" name="id2537492"></a><a name="DEADTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a decimal integer)
    10651074    represents the number of minutes of inactivity before a connection
    10661075    is considered dead, and it is disconnected. The deadtime only takes
    … …  
    10741083</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>deadtime</code></em> = <code class="literal">15</code>
    10751084</em></span>
    1076 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id304774"></a>
     1085</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537568"></a>
    10771086
    10781087debug hires timestamp (G)
    1079 </h3></div></div></div><a class="indexterm" name="id304775"></a><a name="DEBUGHIRESTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1088</h3></div></div></div><a class="indexterm" name="id2537569"></a><a name="DEBUGHIRESTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    10801089    Sometimes the timestamps in the log messages are needed with a resolution of higher that seconds, this
    10811090    boolean parameter adds microsecond resolution to the timestamp  message header when turned on.
    10821091    </p><p>
    1083     Note that the parameter <a class="link" href="smb.conf.5.html#DEBUGTIMESTAMP">debug timestamp</a> must be on for this to have an effect.
     1092    Note that the parameter <a class="link" href="smb.conf.5.html#DEBUGTIMESTAMP" target="_top">debug timestamp</a> must be on for this to have an effect.
    10841093    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug hires timestamp</code></em> = <code class="literal">no</code>
    10851094</em></span>
    1086 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id304823"></a>
     1095</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537623"></a>
    10871096
    10881097debug pid (G)
    1089 </h3></div></div></div><a class="indexterm" name="id304824"></a><a name="DEBUGPID"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1098</h3></div></div></div><a class="indexterm" name="id2537624"></a><a name="DEBUGPID"></a><div class="variablelist"><dl><dt></dt><dd><p>
    10901099    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
    10911100    message. This boolean parameter is adds the process-id to the timestamp message headers in the
    10921101    logfile when turned on.
    10931102    </p><p>
    1094     Note that the parameter <a class="link" href="smb.conf.5.html#DEBUGTIMESTAMP">debug timestamp</a> must be on for this to have an effect.
     1103    Note that the parameter <a class="link" href="smb.conf.5.html#DEBUGTIMESTAMP" target="_top">debug timestamp</a> must be on for this to have an effect.
    10951104    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug pid</code></em> = <code class="literal">no</code>
    10961105</em></span>
    1097 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id304880"></a>
     1106</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537685"></a>
    10981107
    10991108debug prefix timestamp (G)
    1100 </h3></div></div></div><a class="indexterm" name="id304881"></a><a name="DEBUGPREFIXTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1109</h3></div></div></div><a class="indexterm" name="id2537686"></a><a name="DEBUGPREFIXTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    11011110    With this option enabled, the timestamp message header is prefixed to the debug message without the
    1102     filename and function information that is included with the <a class="link" href="smb.conf.5.html#DEBUGTIMESTAMP">debug timestamp</a>
     1111    filename and function information that is included with the <a class="link" href="smb.conf.5.html#DEBUGTIMESTAMP" target="_top">debug timestamp</a>
    11031112    parameter. This gives timestamps to the messages without adding an additional line.
    11041113    </p><p>
    1105     Note that this parameter overrides the <a class="link" href="smb.conf.5.html#DEBUGTIMESTAMP">debug timestamp</a> parameter.
     1114    Note that this parameter overrides the <a class="link" href="smb.conf.5.html#DEBUGTIMESTAMP" target="_top">debug timestamp</a> parameter.
    11061115    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug prefix timestamp</code></em> = <code class="literal">no</code>
    11071116</em></span>
    1108 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id304937"></a>
     1117</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537748"></a>
    11091118
    11101119<a name="TIMESTAMPLOGS"></a>timestamp logs
    1111 </h3></div></div></div><a class="indexterm" name="id304938"></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="id304963"></a>
     1120</h3></div></div></div><a class="indexterm" name="id2537749"></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="id2537775"></a>
    11121121
    11131122debug timestamp (G)
    1114 </h3></div></div></div><a class="indexterm" name="id304964"></a><a name="DEBUGTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1123</h3></div></div></div><a class="indexterm" name="id2537776"></a><a name="DEBUGTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    11151124    Samba debug log messages are timestamped by default. If you are running at a high
    1116     <a class="link" href="smb.conf.5.html#DEBUGLEVEL">debug level</a> these timestamps can be distracting. This
     1125    <a class="link" href="smb.conf.5.html#DEBUGLEVEL" target="_top">debug level</a> these timestamps can be distracting. This
    11171126    boolean parameter allows timestamping to be turned off.
    11181127        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug timestamp</code></em> = <code class="literal">yes</code>
    11191128</em></span>
    1120 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id305009"></a>
     1129</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537823"></a>
    11211130
    11221131debug uid (G)
    1123 </h3></div></div></div><a class="indexterm" name="id305010"></a><a name="DEBUGUID"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1132</h3></div></div></div><a class="indexterm" name="id2537824"></a><a name="DEBUGUID"></a><div class="variablelist"><dl><dt></dt><dd><p>
    11241133    Samba is sometimes run as root and sometime run as the connected user, this boolean parameter inserts the
    11251134    current euid, egid, uid and gid to the timestamp message headers in the log file if turned on.
    11261135    </p><p>
    1127     Note that the parameter <a class="link" href="smb.conf.5.html#DEBUGTIMESTAMP">debug timestamp</a> must be on for this to have an effect.
     1136    Note that the parameter <a class="link" href="smb.conf.5.html#DEBUGTIMESTAMP" target="_top">debug timestamp</a> must be on for this to have an effect.
    11281137    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug uid</code></em> = <code class="literal">no</code>
    11291138</em></span>
    1130 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id305058"></a>
     1139</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537877"></a>
    11311140
    11321141default case (S)
    1133 </h3></div></div></div><a class="indexterm" name="id305059"></a><a name="DEFAULTCASE"></a><div class="variablelist"><dl><dt></dt><dd><p>See the section on <a class="link" href="smb.conf.5.html#NAMEMANGLING">name mangling</a>.
    1134         Also note the <a class="link" href="smb.conf.5.html#SHORTPRESERVECASE">short preserve case</a> parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>default case</code></em> = <code class="literal">lower</code>
    1135 </em></span>
    1136 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id305109"></a>
     1142</h3></div></div></div><a class="indexterm" name="id2537878"></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>.
     1143        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>
     1144</em></span>
     1145</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537931"></a>
    11371146
    11381147default devmode (S)
    1139 </h3></div></div></div><a class="indexterm" name="id305110"></a><a name="DEFAULTDEVMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only applicable to <a class="link" href="smb.conf.5.html#PRINTABLE">printable</a> services.
     1148</h3></div></div></div><a class="indexterm" name="id2537932"></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.
    11401149    When smbd is serving Printer Drivers to Windows NT/2k/XP clients, each printer on the Samba
    11411150    server has a Device Mode which defines things such as paper size and
    … …  
    11601169</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>default devmode</code></em> = <code class="literal">yes</code>
    11611170</em></span>
    1162 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id305184"></a>
     1171</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538019"></a>
    11631172
    11641173<a name="DEFAULT"></a>default
    1165 </h3></div></div></div><a class="indexterm" name="id305185"></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="id305211"></a>
     1174</h3></div></div></div><a class="indexterm" name="id2538020"></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="id2538046"></a>
    11661175
    11671176default service (G)
    1168 </h3></div></div></div><a class="indexterm" name="id305212"></a><a name="DEFAULTSERVICE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the name of a service
     1177</h3></div></div></div><a class="indexterm" name="id2538047"></a><a name="DEFAULTSERVICE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the name of a service
    11691178        which will be connected to if the service actually requested cannot
    11701179        be found. Note that the square brackets are <span class="emphasis"><em>NOT</em></span>
    … …  
    11721181        parameter is not given, attempting to connect to a nonexistent
    11731182        service results in an error.</p><p>
    1174         Typically the default service would be a <a class="link" href="smb.conf.5.html#GUESTOK">guest ok</a>, <a class="link" href="smb.conf.5.html#READ-ONLY">read-only</a> service.</p><p>Also note that the apparent service name will be changed to equal
     1183        Typically the default service would be a <a class="link" href="smb.conf.5.html#GUESTOK" target="_top">guest ok</a>, <a class="link" href="smb.conf.5.html#READ-ONLY" target="_top">read-only</a> service.</p><p>Also note that the apparent service name will be changed to equal
    11751184        that of the requested service, this is very useful as it allows you to use macros like <em class="parameter"><code>%S</code></em> to make a wildcard service.
    11761185        </p><p>Note also that any "_" characters in the name of the service
    … …  
    11801189</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>default service</code></em> = <code class="literal">pub</code>
    11811190</em></span>
    1182 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id305303"></a>
     1191</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538148"></a>
    11831192
    11841193defer sharing violations (G)
    1185 </h3></div></div></div><a class="indexterm" name="id305304"></a><a name="DEFERSHARINGVIOLATIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1194</h3></div></div></div><a class="indexterm" name="id2538149"></a><a name="DEFERSHARINGVIOLATIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    11861195        Windows allows specifying how a file will be shared with
    11871196        other processes when it is opened. Sharing violations occur when
    … …  
    11961205        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>defer sharing violations</code></em> = <code class="literal">True</code>
    11971206</em></span>
    1198 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id305352"></a>
     1207</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538203"></a>
    11991208
    12001209delete group script (G)
    1201 </h3></div></div></div><a class="indexterm" name="id305353"></a><a name="DELETEGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the full pathname to a script that will
     1210</h3></div></div></div><a class="indexterm" name="id2538204"></a><a name="DELETEGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the full pathname to a script that will
    12021211        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.
    12031212        It will expand any <em class="parameter"><code>%g</code></em> to the group name passed. 
    … …  
    12051214        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>delete group script</code></em> = <code class="literal"></code>
    12061215</em></span>
    1207 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id305406"></a>
     1216</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538259"></a>
    12081217
    12091218deleteprinter command (G)
    1210 </h3></div></div></div><a class="indexterm" name="id305407"></a><a name="DELETEPRINTERCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printer
     1219</h3></div></div></div><a class="indexterm" name="id2538260"></a><a name="DELETEPRINTERCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printer
    12111220    support for Windows NT/2000 clients in Samba 2.2, it is now
    12121221    possible to delete printer at run time by issuing the
    12131222    DeletePrinter() RPC call.</p><p>For a Samba host this means that the printer must be
    12141223    physically deleted from underlying printing system.  The
    1215     <a class="link" href="smb.conf.5.html#DELETEPRINTERCOMMAND">deleteprinter command</a> defines a script to be run which
     1224    <a class="link" href="smb.conf.5.html#DELETEPRINTERCOMMAND" target="_top">deleteprinter command</a> defines a script to be run which
    12161225    will perform the necessary operations for removing the printer
    12171226    from the print system and from <code class="filename">smb.conf</code>.
    1218     </p><p>The <a class="link" href="smb.conf.5.html#DELETEPRINTERCOMMAND">deleteprinter command</a> is
    1219     automatically called with only one parameter: <a class="link" href="smb.conf.5.html#PRINTERNAME">printer name</a>.
    1220         </p><p>Once the <a class="link" href="smb.conf.5.html#DELETEPRINTERCOMMAND">deleteprinter command</a> has
     1227    </p><p>The <a class="link" href="smb.conf.5.html#DELETEPRINTERCOMMAND" target="_top">deleteprinter command</a> is
     1228    automatically called with only one parameter: <a class="link" href="smb.conf.5.html#PRINTERNAME" target="_top">printer name</a>.
     1229        </p><p>Once the <a class="link" href="smb.conf.5.html#DELETEPRINTERCOMMAND" target="_top">deleteprinter command</a> has
    12211230    been executed, <code class="literal">smbd</code> will reparse the <code class="filename">
    12221231    smb.conf</code> to associated printer no longer exists. 
    … …  
    12261235</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>deleteprinter command</code></em> = <code class="literal">/usr/bin/removeprinter</code>
    12271236</em></span>
    1228 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id305522"></a>
     1237</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538386"></a>
    12291238
    12301239delete readonly (S)
    1231 </h3></div></div></div><a class="indexterm" name="id305523"></a><a name="DELETEREADONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows readonly files to be deleted. 
     1240</h3></div></div></div><a class="indexterm" name="id2538387"></a><a name="DELETEREADONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows readonly files to be deleted. 
    12321241        This is not normal DOS semantics, but is allowed by UNIX.</p><p>This option may be useful for running applications such
    12331242        as rcs, where UNIX file ownership prevents changing file
    12341243        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>
    12351244</em></span>
    1236 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id305564"></a>
     1245</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538431"></a>
    12371246
    12381247delete share command (G)
    1239 </h3></div></div></div><a class="indexterm" name="id305566"></a><a name="DELETESHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1248</h3></div></div></div><a class="indexterm" name="id2538432"></a><a name="DELETESHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12401249        Samba 2.2.0 introduced the ability to dynamically add and delete shares via the Windows NT 4.0 Server
    12411250        Manager.  The <em class="parameter"><code>delete share command</code></em> is used to define an external
    12421251        program or script which will remove an existing service definition from
    1243         <code class="filename">smb.conf</code>.  In order to successfully execute the
    1244         <em class="parameter"><code>delete share command</code></em>, <code class="literal">smbd</code>
    1245         requires that the administrator be connected using a root account (i.e.  uid == 0).
    1246         </p><p>
    1247     If the connected account has <code class="literal">SeDiskOperatorPrivilege</code>, scripts defined in
    1248     <em class="parameter"><code>change share</code></em> parameter are executed as root.
    1249     </p><p>
     1252        <code class="filename">smb.conf</code>.
     1253        </p><p>In order to successfully execute the
     1254        <em class="parameter"><code>delete share command</code></em>,
     1255        <code class="literal">smbd</code>       requires that the administrator
     1256        connects using a root account (i.e.  uid == 0) or has the
     1257        <code class="literal">SeDiskOperatorPrivilege</code>.
     1258        Scripts defined in the <em class="parameter"><code>delete share command</code></em>
     1259        parameter are executed as root.
     1260        </p><p>
    12501261        When executed, <code class="literal">smbd</code> will automatically invoke the
    12511262        <em class="parameter"><code>delete share command</code></em> with two parameters.
    … …  
    12561267                        </p></li></ul></div><p>
    12571268        This parameter is only used to remove file shares.  To delete printer shares,
    1258         see the <a class="link" href="smb.conf.5.html#DELETEPRINTERCOMMAND">deleteprinter command</a>.
     1269        see the <a class="link" href="smb.conf.5.html#DELETEPRINTERCOMMAND" target="_top">deleteprinter command</a>.
    12591270        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>delete share command</code></em> = <code class="literal"></code>
    12601271</em></span>
    12611272</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>delete share command</code></em> = <code class="literal">/usr/local/bin/delshare</code>
    12621273</em></span>
    1263 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id305708"></a>
     1274</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538583"></a>
    12641275
    12651276delete user from group script (G)
    1266 </h3></div></div></div><a class="indexterm" name="id305709"></a><a name="DELETEUSERFROMGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>Full path to the script that will be called when
     1277</h3></div></div></div><a class="indexterm" name="id2538584"></a><a name="DELETEUSERFROMGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>Full path to the script that will be called when
    12671278        a user is removed from a group using the Windows NT domain administration
    12681279        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>.
    … …  
    12731284</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>
    12741285</em></span>
    1275 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id305782"></a>
     1286</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538663"></a>
    12761287
    12771288delete user script (G)
    1278 </h3></div></div></div><a class="indexterm" name="id305783"></a><a name="DELETEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the full pathname to a script that will
     1289</h3></div></div></div><a class="indexterm" name="id2538664"></a><a name="DELETEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the full pathname to a script that will
    12791290        be run by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when managing users
    12801291        with remote RPC (NT) tools.
    … …  
    12851296</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>
    12861297</em></span>
    1287 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id305854"></a>
     1298</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538739"></a>
    12881299
    12891300delete veto files (S)
    1290 </h3></div></div></div><a class="indexterm" name="id305855"></a><a name="DELETEVETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used when Samba is attempting to
     1301</h3></div></div></div><a class="indexterm" name="id2538740"></a><a name="DELETEVETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used when Samba is attempting to
    12911302        delete a directory that contains one or more vetoed directories
    1292         (see the <a class="link" href="smb.conf.5.html#VETOFILES">veto files</a>
     1303        (see the <a class="link" href="smb.conf.5.html#VETOFILES" target="_top">veto files</a>
    12931304        option).  If this option is set to <code class="constant">no</code> (the default) then if a vetoed
    12941305        directory contains any non-vetoed files or directories then the
    … …  
    12981309        serving systems such as NetAtalk which create meta-files within
    12991310        directories you might normally veto DOS/Windows users from seeing
    1300         (e.g. <code class="filename">.AppleDouble</code>)</p><p>Setting <a class="link" href="smb.conf.5.html#DELETEVETOFILES">delete veto files = yes</a> allows these
     1311        (e.g. <code class="filename">.AppleDouble</code>)</p><p>Setting <a class="link" href="smb.conf.5.html#DELETEVETOFILES" target="_top">delete veto files = yes</a> allows these
    13011312        directories to be  transparently deleted when the parent directory
    13021313        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>
    13031314</em></span>
    1304 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id305930"></a>
     1315</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538825"></a>
    13051316
    13061317dfree cache time (S)
    1307 </h3></div></div></div><a class="indexterm" name="id305931"></a><a name="DFREECACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1318</h3></div></div></div><a class="indexterm" name="id2538826"></a><a name="DFREECACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    13081319        The <em class="parameter"><code>dfree cache time</code></em> should only be used on systems where a problem
    13091320        occurs with the internal disk space calculations. This has been known to happen with Ultrix, but may occur
    … …  
    13131324        This is a new parameter introduced in Samba version 3.0.21.  It specifies in seconds the time that smbd will
    13141325        cache the output of a disk free query. If set to zero (the default) no caching is done. This allows a heavily
    1315         loaded server to prevent rapid spawning of <a class="link" href="smb.conf.5.html#DFREECOMMAND">dfree command</a> scripts increasing the load.
     1326        loaded server to prevent rapid spawning of <a class="link" href="smb.conf.5.html#DFREECOMMAND" target="_top">dfree command</a> scripts increasing the load.
    13161327        </p><p>
    13171328        By default this parameter is zero, meaning no caching will be done.
    13181329        </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>
    13191330</em></span>
    1320 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id305995"></a>
     1331</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538897"></a>
    13211332
    13221333dfree command (S)
    1323 </h3></div></div></div><a class="indexterm" name="id305996"></a><a name="DFREECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1334</h3></div></div></div><a class="indexterm" name="id2538898"></a><a name="DFREECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    13241335        The <em class="parameter"><code>dfree command</code></em> setting should only be used on systems where a
    13251336        problem occurs with the internal disk space calculations. This has been known to happen with Ultrix, but may
    … …  
    13321343        </p><p>
    13331344        In Samba version 3.0.21 this parameter has been changed to be a per-share parameter, and in addition the
    1334         parameter <a class="link" href="smb.conf.5.html#DFREECACHETIME">dfree cache time</a> was added to allow the output of this script to be cached
     1345        parameter <a class="link" href="smb.conf.5.html#DFREECACHETIME" target="_top">dfree cache time</a> was added to allow the output of this script to be cached
    13351346        for systems under heavy load.
    13361347        </p><p>
    … …  
    13591370        </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>
    13601371</em></span>
    1361 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id306102"></a>
     1372</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539019"></a>
    13621373
    13631374<a name="DIRECTORYMODE"></a>directory mode
    1364 </h3></div></div></div><a class="indexterm" name="id306103"></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="id306128"></a>
     1375</h3></div></div></div><a class="indexterm" name="id2539020"></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="id2539046"></a>
    13651376
    13661377directory mask (S)
    1367 </h3></div></div></div><a class="indexterm" name="id306129"></a><a name="DIRECTORYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is the octal modes which are
     1378</h3></div></div></div><a class="indexterm" name="id2539047"></a><a name="DIRECTORYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is the octal modes which are
    13681379    used when converting DOS modes to UNIX modes when creating UNIX
    13691380    directories.</p><p>When a directory is created, the necessary permissions are
    … …  
    13761387    and 'other' write bits from the UNIX mode, allowing only the
    13771388    user who owns the directory to modify it.</p><p>Following this Samba will bit-wise 'OR' the UNIX mode
    1378     created from this parameter with the value of the <a class="link" href="smb.conf.5.html#FORCEDIRECTORYMODE">force directory mode</a> parameter.
     1389    created from this parameter with the value of the <a class="link" href="smb.conf.5.html#FORCEDIRECTORYMODE" target="_top">force directory mode</a> parameter.
    13791390    This parameter is set to 000 by default (i.e. no extra mode bits are added).</p><p>Note that this parameter does not apply to permissions
    13801391    set by Windows NT/2000 ACL editors. If the administrator wishes to enforce
    1381     a mask on access control lists also, they need to set the <a class="link" href="smb.conf.5.html#DIRECTORYSECURITYMASK">directory security mask</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>directory mask</code></em> = <code class="literal">0755</code>
     1392    a mask on access control lists also, they need to set the <a class="link" href="smb.conf.5.html#DIRECTORYSECURITYMASK" target="_top">directory security mask</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>directory mask</code></em> = <code class="literal">0755</code>
    13821393</em></span>
    13831394</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>directory mask</code></em> = <code class="literal">0775</code>
    13841395</em></span>
    1385 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id306221"></a>
     1396</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539151"></a>
    13861397
    13871398directory security mask (S)
    1388 </h3></div></div></div><a class="indexterm" name="id306222"></a><a name="DIRECTORYSECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls what UNIX permission bits
     1399</h3></div></div></div><a class="indexterm" name="id2539152"></a><a name="DIRECTORYSECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls what UNIX permission bits
    13891400    will be set when a Windows NT client is manipulating the UNIX
    13901401    permission on a directory using the native NT security dialog
    13911402    box.</p><p>
    13921403        This parameter is applied as a mask (AND'ed with) to the incoming permission bits, thus resetting
    1393         any bits not in this mask.  Make sure not to mix up this parameter with <a class="link" href="smb.conf.5.html#FORCEDIRECTORYSECURITYMODE">force  directory security mode</a>, which works similar like this one but uses logical OR instead of AND.
     1404        any bits not in this mask.  Make sure not to mix up this parameter with <a class="link" href="smb.conf.5.html#FORCEDIRECTORYSECURITYMODE" target="_top">force  directory security mode</a>, which works similar like this one but uses logical OR instead of AND.
    13941405        Essentially, zero bits in this mask are a set of bits that will always be set to zero.
    13951406        </p><p>
    … …  
    14061417</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>directory security mask</code></em> = <code class="literal">0700</code>
    14071418</em></span>
    1408 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id306310"></a>
     1419</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539251"></a>
    14091420
    14101421disable netbios (G)
    1411 </h3></div></div></div><a class="indexterm" name="id306311"></a><a name="DISABLENETBIOS"></a><div class="variablelist"><dl><dt></dt><dd><p>Enabling this parameter will disable netbios support
     1422</h3></div></div></div><a class="indexterm" name="id2539252"></a><a name="DISABLENETBIOS"></a><div class="variablelist"><dl><dt></dt><dd><p>Enabling this parameter will disable netbios support
    14121423    in Samba. Netbios is the only available form of browsing in
    14131424    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
    … …  
    14151426        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>disable netbios</code></em> = <code class="literal">no</code>
    14161427</em></span>
    1417 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id306353"></a>
     1428</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539297"></a>
    14181429
    14191430disable spoolss (G)
    1420 </h3></div></div></div><a class="indexterm" name="id306354"></a><a name="DISABLESPOOLSS"></a><div class="variablelist"><dl><dt></dt><dd><p>Enabling this parameter will disable Samba's support
     1431</h3></div></div></div><a class="indexterm" name="id2539298"></a><a name="DISABLESPOOLSS"></a><div class="variablelist"><dl><dt></dt><dd><p>Enabling this parameter will disable Samba's support
    14211432    for the SPOOLSS set of MS-RPC's and will yield identical behavior
    14221433    as Samba 2.0.x.  Windows NT/2000 clients will downgrade to using
    … …  
    14301441</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>disable spoolss</code></em> = <code class="literal">no</code>
    14311442</em></span>
    1432 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id306398"></a>
     1443</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539348"></a>
    14331444
    14341445display charset (G)
    1435 </h3></div></div></div><a class="indexterm" name="id306399"></a><a name="DISPLAYCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1446</h3></div></div></div><a class="indexterm" name="id2539350"></a><a name="DISPLAYCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>
    14361447        Specifies the charset that samba will use to print messages to stdout and stderr.
    14371448        The default value is "LOCALE", which means automatically set, depending on the
    14381449        current locale. The value should generally be the same as the value of the parameter
    1439         <a class="link" href="smb.conf.5.html#UNIXCHARSET">unix charset</a>.
     1450        <a class="link" href="smb.conf.5.html#UNIXCHARSET" target="_top">unix charset</a>.
    14401451        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>display charset</code></em> = <code class="literal">"LOCALE" or "ASCII" (depending on the system)</code>
    14411452</em></span>
    14421453</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>display charset</code></em> = <code class="literal">UTF8</code>
    14431454</em></span>
    1444 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id306460"></a>
     1455</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539415"></a>
    14451456
    14461457dmapi support (S)
    1447 </h3></div></div></div><a class="indexterm" name="id306461"></a><a name="DMAPISUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should use DMAPI to
     1458</h3></div></div></div><a class="indexterm" name="id2539416"></a><a name="DMAPISUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should use DMAPI to
    14481459        determine whether a file is offline or not. This would typically
    14491460        be used in conjunction with a hierarchical storage system that
    … …  
    14601471        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dmapi support</code></em> = <code class="literal">no</code>
    14611472</em></span>
    1462 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id306513"></a>
     1473</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539474"></a>
    14631474
    14641475dns proxy (G)
    1465 </h3></div></div></div><a class="indexterm" name="id306514"></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
     1476</h3></div></div></div><a class="indexterm" name="id2539475"></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
    14661477        finding that a NetBIOS name has not been registered, should treat the
    14671478        NetBIOS name word-for-word as a DNS name and do a lookup with the DNS server
    … …  
    14721483        action.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dns proxy</code></em> = <code class="literal">yes</code>
    14731484</em></span>
    1474 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id306572"></a>
     1485</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539537"></a>
    14751486
    14761487domain logons (G)
    1477 </h3></div></div></div><a class="indexterm" name="id306574"></a><a name="DOMAINLOGONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1488</h3></div></div></div><a class="indexterm" name="id2539538"></a><a name="DOMAINLOGONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    14781489        If set to <code class="constant">yes</code>, the Samba server will
    14791490        provide the netlogon service for Windows 9X network logons for the
    1480         <a class="link" href="smb.conf.5.html#WORKGROUP">workgroup</a> it is in.
     1491        <a class="link" href="smb.conf.5.html#WORKGROUP" target="_top">workgroup</a> it is in.
    14811492        This will also cause the Samba server to act as a domain
    14821493        controller for NT4 style domain services. For more details on
    … …  
    14851496        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>domain logons</code></em> = <code class="literal">no</code>
    14861497</em></span>
    1487 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id306623"></a>
     1498</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539591"></a>
    14881499
    14891500domain master (G)
    1490 </h3></div></div></div><a class="indexterm" name="id306624"></a><a name="DOMAINMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1501</h3></div></div></div><a class="indexterm" name="id2539592"></a><a name="DOMAINMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    14911502        Tell <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> to enable
    14921503        WAN-wide browse list collation. Setting this option causes <code class="literal">nmbd</code> to claim a
    14931504        special domain specific NetBIOS name that identifies it as a domain master browser for its given
    1494         <a class="link" href="smb.conf.5.html#WORKGROUP">workgroup</a>. Local master browsers in the same <a class="link" href="smb.conf.5.html#WORKGROUP">workgroup</a> on
     1505        <a class="link" href="smb.conf.5.html#WORKGROUP" target="_top">workgroup</a>. Local master browsers in the same <a class="link" href="smb.conf.5.html#WORKGROUP" target="_top">workgroup</a> on
    14951506        broadcast-isolated subnets will give this <code class="literal">nmbd</code> their local browse lists,
    14961507        and then ask <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> for a
    … …  
    14991510        broadcast-isolated subnet.
    15001511        </p><p>
    1501         Note that Windows NT Primary Domain Controllers expect to be able to claim this <a class="link" href="smb.conf.5.html#WORKGROUP">workgroup</a> specific special NetBIOS name that identifies them as domain master browsers for that
    1502         <a class="link" href="smb.conf.5.html#WORKGROUP">workgroup</a> by default (i.e. there is no way to prevent a Windows NT PDC from attempting
     1512        Note that Windows NT Primary Domain Controllers expect to be able to claim this <a class="link" href="smb.conf.5.html#WORKGROUP" target="_top">workgroup</a> specific special NetBIOS name that identifies them as domain master browsers for that
     1513        <a class="link" href="smb.conf.5.html#WORKGROUP" target="_top">workgroup</a> by default (i.e. there is no way to prevent a Windows NT PDC from attempting
    15031514        to do this). This means that if this parameter is set and <code class="literal">nmbd</code> claims the
    1504         special name for a <a class="link" href="smb.conf.5.html#WORKGROUP">workgroup</a> before a Windows NT PDC is able to do so then cross
     1515        special name for a <a class="link" href="smb.conf.5.html#WORKGROUP" target="_top">workgroup</a> before a Windows NT PDC is able to do so then cross
    15051516        subnet browsing will behave strangely and may fail.
    15061517        </p><p>
    1507         If <a class="link" href="smb.conf.5.html#DOMAINLOGONS">domain logons = yes</a>, then the default behavior is to enable the
    1508         <a class="link" href="smb.conf.5.html#DOMAINMASTER">domain master</a> parameter.  If <a class="link" href="smb.conf.5.html#DOMAINLOGONS">domain logons</a> is not enabled (the
    1509         default setting), then neither will <a class="link" href="smb.conf.5.html#DOMAINMASTER">domain master</a> be enabled by default.
    1510         </p><p>
    1511         When <a class="link" href="smb.conf.5.html#DOMAINLOGONS">domain logons = Yes</a> the default setting for this parameter is
    1512         Yes, with the result that Samba will be a PDC. If <a class="link" href="smb.conf.5.html#DOMAINMASTER">domain master = No</a>,
     1518        If <a class="link" href="smb.conf.5.html#DOMAINLOGONS" target="_top">domain logons = yes</a>, then the default behavior is to enable the
     1519        <a class="link" href="smb.conf.5.html#DOMAINMASTER" target="_top">domain master</a> parameter.  If <a class="link" href="smb.conf.5.html#DOMAINLOGONS" target="_top">domain logons</a> is not enabled (the
     1520        default setting), then neither will <a class="link" href="smb.conf.5.html#DOMAINMASTER" target="_top">domain master</a> be enabled by default.
     1521        </p><p>
     1522        When <a class="link" href="smb.conf.5.html#DOMAINLOGONS" target="_top">domain logons = Yes</a> the default setting for this parameter is
     1523        Yes, with the result that Samba will be a PDC. If <a class="link" href="smb.conf.5.html#DOMAINMASTER" target="_top">domain master = No</a>,
    15131524        Samba will function as a BDC. In general, this parameter should be set to 'No' only on a BDC.
    15141525        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>domain master</code></em> = <code class="literal">auto</code>
    15151526</em></span>
    1516 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id306789"></a>
     1527</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539782"></a>
    15171528
    15181529dont descend (S)
    1519 </h3></div></div></div><a class="indexterm" name="id306790"></a><a name="DONTDESCEND"></a><div class="variablelist"><dl><dt></dt><dd><p>There are certain directories on some systems
     1530</h3></div></div></div><a class="indexterm" name="id2539783"></a><a name="DONTDESCEND"></a><div class="variablelist"><dl><dt></dt><dd><p>There are certain directories on some systems
    15201531        (e.g., the <code class="filename">/proc</code> tree under Linux) that are either not
    15211532        of interest to clients or are infinitely deep (recursive). This
    … …  
    15281539</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>dont descend</code></em> = <code class="literal">/proc,/dev</code>
    15291540</em></span>
    1530 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id306863"></a>
     1541</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539860"></a>
    15311542
    15321543dos charset (G)
    1533 </h3></div></div></div><a class="indexterm" name="id306864"></a><a name="DOSCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>DOS SMB clients assume the server has
     1544</h3></div></div></div><a class="indexterm" name="id2539861"></a><a name="DOSCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>DOS SMB clients assume the server has
    15341545        the same charset as they do. This option specifies which
    15351546        charset Samba should talk to DOS clients.
    15361547        </p><p>The default depends on which charsets you have installed.
    15371548        Samba tries to use charset 850 but falls back to ASCII in
    1538         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="id306902"></a>
     1549        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="id2539901"></a>
    15391550
    15401551dos filemode (S)
    1541 </h3></div></div></div><a class="indexterm" name="id306903"></a><a name="DOSFILEMODE"></a><div class="variablelist"><dl><dt></dt><dd><p> The default behavior in Samba is to provide
     1552</h3></div></div></div><a class="indexterm" name="id2539902"></a><a name="DOSFILEMODE"></a><div class="variablelist"><dl><dt></dt><dd><p> The default behavior in Samba is to provide
    15421553        UNIX-like behavior where only the owner of a file/directory is
    15431554        able to change the permissions on it.  However, this behavior
    … …  
    15501561        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>
    15511562</em></span>
    1552 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id306944"></a>
     1563</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539948"></a>
    15531564
    15541565dos filetime resolution (S)
    1555 </h3></div></div></div><a class="indexterm" name="id306945"></a><a name="DOSFILETIMERESOLUTION"></a><div class="variablelist"><dl><dt></dt><dd><p>Under the DOS and Windows FAT filesystem, the finest
     1566</h3></div></div></div><a class="indexterm" name="id2539949"></a><a name="DOSFILETIMERESOLUTION"></a><div class="variablelist"><dl><dt></dt><dd><p>Under the DOS and Windows FAT filesystem, the finest
    15561567        granularity on time resolution is two seconds. Setting this parameter
    15571568        for a share causes Samba to round the reported time down to the
    … …  
    15681579        happy.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dos filetime resolution</code></em> = <code class="literal">no</code>
    15691580</em></span>
    1570 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id306999"></a>
     1581</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540012"></a>
    15711582
    15721583dos filetimes (S)
    1573 </h3></div></div></div><a class="indexterm" name="id307000"></a><a name="DOSFILETIMES"></a><div class="variablelist"><dl><dt></dt><dd><p>Under DOS and Windows, if a user can write to a
     1584</h3></div></div></div><a class="indexterm" name="id2540013"></a><a name="DOSFILETIMES"></a><div class="variablelist"><dl><dt></dt><dd><p>Under DOS and Windows, if a user can write to a
    15741585        file they can change the timestamp on it. Under POSIX semantics,
    15751586        only the owner of the file or root may change the timestamp. By
    … …  
    15851596        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dos filetimes</code></em> = <code class="literal">yes</code>
    15861597</em></span>
    1587 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id307058"></a>
     1598</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540077"></a>
    15881599
    15891600ea support (S)
    1590 </h3></div></div></div><a class="indexterm" name="id307060"></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
     1601</h3></div></div></div><a class="indexterm" name="id2540078"></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
    15911602    attributes on a share. In order to enable this parameter the underlying filesystem exported by
    15921603    the share must support extended attributes (such as provided on XFS and EXT3 on Linux, with the
    … …  
    15951606                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>
    15961607</em></span>
    1597 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id307107"></a>
     1608</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540130"></a>
    15981609
    15991610enable asu support (G)
    1600 </h3></div></div></div><a class="indexterm" name="id307108"></a><a name="ENABLEASUSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>Hosts running the "Advanced Server for Unix (ASU)" product
     1611</h3></div></div></div><a class="indexterm" name="id2540131"></a><a name="ENABLEASUSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>Hosts running the "Advanced Server for Unix (ASU)" product
    16011612    require some special accomodations such as creating a builting [ADMIN$]
    16021613    share that only supports IPC connections.  The has been the default
    … …  
    16061617    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>
    16071618</em></span>
    1608 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id307148"></a>
     1619</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540175"></a>
    16091620
    16101621enable privileges (G)
    1611 </h3></div></div></div><a class="indexterm" name="id307149"></a><a name="ENABLEPRIVILEGES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1622</h3></div></div></div><a class="indexterm" name="id2540176"></a><a name="ENABLEPRIVILEGES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    16121623        This parameter controls whether or not smbd will honor privileges assigned to specific SIDs via either
    16131624         <code class="literal">net rpc rights</code> or one of the Windows user and group manager tools.  This parameter is
    … …  
    16221633        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>enable privileges</code></em> = <code class="literal">yes</code>
    16231634</em></span>
    1624 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id307203"></a>
     1635</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540236"></a>
    16251636
    16261637encrypt passwords (G)
    1627 </h3></div></div></div><a class="indexterm" name="id307204"></a><a name="ENCRYPTPASSWORDS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean controls whether encrypted passwords
     1638</h3></div></div></div><a class="indexterm" name="id2540237"></a><a name="ENCRYPTPASSWORDS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean controls whether encrypted passwords
    16281639    will be negotiated with the client. Note that Windows NT 4.0 SP3 and
    16291640    above and also Windows 98 will by default expect encrypted passwords
    … …  
    16441655    <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> must either
    16451656    have access to a local <a class="citerefentry" href="smbpasswd.5.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(5)</span></a> file (see the <a class="citerefentry" href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a> program for information on how to set up
    1646     and maintain this file), or set the <a class="link" href="smb.conf.5.html#SECURITY">security = [server|domain|ads]</a> parameter which
     1657    and maintain this file), or set the <a class="link" href="smb.conf.5.html#SECURITY" target="_top">security = [server|domain|ads]</a> parameter which
    16471658    causes <code class="literal">smbd</code> to authenticate against another
    16481659        server.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>encrypt passwords</code></em> = <code class="literal">yes</code>
    16491660</em></span>
    1650 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id307293"></a>
     1661</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540340"></a>
    16511662
    16521663enhanced browsing (G)
    1653 </h3></div></div></div><a class="indexterm" name="id307294"></a><a name="ENHANCEDBROWSING"></a><div class="variablelist"><dl><dt></dt><dd><p>This option enables a couple of enhancements to
     1664</h3></div></div></div><a class="indexterm" name="id2540341"></a><a name="ENHANCEDBROWSING"></a><div class="variablelist"><dl><dt></dt><dd><p>This option enables a couple of enhancements to
    16541665        cross-subnet browse propagation that have been added in Samba
    16551666        but which are not standard in Microsoft implementations. 
    … …  
    16641675        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>
    16651676</em></span>
    1666 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id307348"></a>
     1677</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540401"></a>
    16671678
    16681679enumports command (G)
    1669 </h3></div></div></div><a class="indexterm" name="id307349"></a><a name="ENUMPORTSCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>The concept of a "port" is fairly foreign
     1680</h3></div></div></div><a class="indexterm" name="id2540402"></a><a name="ENUMPORTSCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>The concept of a "port" is fairly foreign
    16701681    to UNIX hosts.  Under Windows NT/2000 print servers, a port
    16711682    is associated with a port monitor and generally takes the form of
    … …  
    16841695</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>enumports command</code></em> = <code class="literal">/usr/bin/listports</code>
    16851696</em></span>
    1686 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id307422"></a>
     1697</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540482"></a>
    16871698
    16881699eventlog list (G)
    1689 </h3></div></div></div><a class="indexterm" name="id307423"></a><a name="EVENTLOGLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of log names that Samba will
     1700</h3></div></div></div><a class="indexterm" name="id2540483"></a><a name="EVENTLOGLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of log names that Samba will
    16901701    report to the Microsoft EventViewer utility.  The listed
    16911702    eventlogs will be associated with tdb file on disk in the
    … …  
    17001711</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>eventlog list</code></em> = <code class="literal">Security Application Syslog Apache</code>
    17011712</em></span>
    1702 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id307491"></a>
     1713</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540555"></a>
    17031714
    17041715fake directory create times (S)
    1705 </h3></div></div></div><a class="indexterm" name="id307492"></a><a name="FAKEDIRECTORYCREATETIMES"></a><div class="variablelist"><dl><dt></dt><dd><p>NTFS and Windows VFAT file systems keep a create
     1716</h3></div></div></div><a class="indexterm" name="id2540556"></a><a name="FAKEDIRECTORYCREATETIMES"></a><div class="variablelist"><dl><dt></dt><dd><p>NTFS and Windows VFAT file systems keep a create
    17061717        time for all files and directories. This is not the same as the
    17071718        ctime - status change time - that Unix keeps, so Samba by default
    … …  
    17251736        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>
    17261737</em></span>
    1727 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id307546"></a>
     1738</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540622"></a>
    17281739
    17291740fake oplocks (S)
    1730 </h3></div></div></div><a class="indexterm" name="id307547"></a><a name="FAKEOPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>Oplocks are the way that SMB clients get permission
     1741</h3></div></div></div><a class="indexterm" name="id2540624"></a><a name="FAKEOPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>Oplocks are the way that SMB clients get permission
    17311742        from a server to locally cache file operations. If a server grants
    17321743        an oplock (opportunistic lock) then the client is free to assume
    … …  
    17351746        file open/close operations. This can give enormous performance benefits.
    17361747        </p><p>When you set <code class="literal">fake oplocks = yes</code>, <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will
    1737         always grant oplock requests no matter how many clients are using the file.</p><p>It is generally much better to use the real <a class="link" href="smb.conf.5.html#OPLOCKS">oplocks</a> support rather
     1748        always grant oplock requests no matter how many clients are using the file.</p><p>It is generally much better to use the real <a class="link" href="smb.conf.5.html#OPLOCKS" target="_top">oplocks</a> support rather
    17381749        than this parameter.</p><p>If you enable this option on all read-only shares or
    17391750        shares that you know will only be accessed from one client at a
    … …  
    17441755        this option carefully!</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>fake oplocks</code></em> = <code class="literal">no</code>
    17451756</em></span>
    1746 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id307624"></a>
     1757</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540713"></a>
    17471758
    17481759follow symlinks (S)
    1749 </h3></div></div></div><a class="indexterm" name="id307625"></a><a name="FOLLOWSYMLINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1760</h3></div></div></div><a class="indexterm" name="id2540714"></a><a name="FOLLOWSYMLINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    17501761        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
    17511762        parameter to <code class="constant">no</code> prevents any file or directory that is a symbolic link from being
    … …  
    17571768        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>follow symlinks</code></em> = <code class="literal">yes</code>
    17581769</em></span>
    1759 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id307689"></a>
     1770</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540783"></a>
    17601771
    17611772force create mode (S)
    1762 </h3></div></div></div><a class="indexterm" name="id307690"></a><a name="FORCECREATEMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a set of UNIX mode bit
     1773</h3></div></div></div><a class="indexterm" name="id2540784"></a><a name="FORCECREATEMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a set of UNIX mode bit
    17631774    permissions that will <span class="emphasis"><em>always</em></span> be set on a
    17641775    file created by Samba. This is done by bitwise 'OR'ing these bits onto
    … …  
    17731784</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force create mode</code></em> = <code class="literal">0755</code>
    17741785</em></span>
    1775 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id307758"></a>
     1786</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540858"></a>
    17761787
    17771788force directory mode (S)
    1778 </h3></div></div></div><a class="indexterm" name="id307760"></a><a name="FORCEDIRECTORYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a set of UNIX mode bit
     1789</h3></div></div></div><a class="indexterm" name="id2540859"></a><a name="FORCEDIRECTORYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a set of UNIX mode bit
    17791790    permissions that will <span class="emphasis"><em>always</em></span> be set on a directory
    17801791    created by Samba. This is done by bitwise 'OR'ing these bits onto the
    … …  
    17891800</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force directory mode</code></em> = <code class="literal">0755</code>
    17901801</em></span>
    1791 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id307828"></a>
     1802</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540932"></a>
    17921803
    17931804force directory security mode (S)
    1794 </h3></div></div></div><a class="indexterm" name="id307829"></a><a name="FORCEDIRECTORYSECURITYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1805</h3></div></div></div><a class="indexterm" name="id2540933"></a><a name="FORCEDIRECTORYSECURITYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    17951806        This parameter controls what UNIX permission bits can be modified when a Windows NT client is manipulating
    17961807        the UNIX permission on a directory using the native NT security dialog box.
    17971808        </p><p>
    17981809        This parameter is applied as a mask (OR'ed with) to the changed permission bits, thus forcing any bits in this
    1799         mask that the user may have modified to be on.  Make sure not to mix up this parameter with <a class="link" href="smb.conf.5.html#DIRECTORYSECURITYMASK">directory security mask</a>, which works in a similar manner to this one, but uses a logical AND instead
     1810        mask that the user may have modified to be on.  Make sure not to mix up this parameter with <a class="link" href="smb.conf.5.html#DIRECTORYSECURITYMASK" target="_top">directory security mask</a>, which works in a similar manner to this one, but uses a logical AND instead
    18001811        of an OR.
    18011812        </p><p>
    … …  
    18131824</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force directory security mode</code></em> = <code class="literal">700</code>
    18141825</em></span>
    1815 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id307912"></a>
     1826</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541029"></a>
    18161827
    18171828<a name="GROUP"></a>group
    1818 </h3></div></div></div><a class="indexterm" name="id307913"></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="id307938"></a>
     1829</h3></div></div></div><a class="indexterm" name="id2541030"></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="id2541056"></a>
    18191830
    18201831force group (S)
    1821 </h3></div></div></div><a class="indexterm" name="id307939"></a><a name="FORCEGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies a UNIX group name that will be
     1832</h3></div></div></div><a class="indexterm" name="id2541057"></a><a name="FORCEGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies a UNIX group name that will be
    18221833    assigned as the default primary group for all users connecting
    18231834    to this service. This is useful for sharing files by ensuring
    … …  
    18371848    primary group assigned to sys when accessing this Samba share. All
    18381849    other users will retain their ordinary primary group.</p><p>
    1839         If the <a class="link" href="smb.conf.5.html#FORCEUSER">force user</a> parameter is also set the group specified in
     1850        If the <a class="link" href="smb.conf.5.html#FORCEUSER" target="_top">force user</a> parameter is also set the group specified in
    18401851    <em class="parameter"><code>force group</code></em> will override the primary group
    18411852    set in <em class="parameter"><code>force user</code></em>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>force group</code></em> = <code class="literal"></code>
    … …  
    18431854</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force group</code></em> = <code class="literal">agroup</code>
    18441855</em></span>
    1845 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id308029"></a>
     1856</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541161"></a>
    18461857
    18471858force printername (S)
    1848 </h3></div></div></div><a class="indexterm" name="id308030"></a><a name="FORCEPRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>When printing from Windows NT (or later),
     1859</h3></div></div></div><a class="indexterm" name="id2541162"></a><a name="FORCEPRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>When printing from Windows NT (or later),
    18491860    each printer in <code class="filename">smb.conf</code> has two
    18501861    associated names which can be used by the client.  The first
    … …  
    18691880    folder.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>force printername</code></em> = <code class="literal">no</code>
    18701881</em></span>
    1871 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id308103"></a>
     1882</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541246"></a>
    18721883
    18731884force security mode (S)
    1874 </h3></div></div></div><a class="indexterm" name="id308104"></a><a name="FORCESECURITYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1885</h3></div></div></div><a class="indexterm" name="id2541247"></a><a name="FORCESECURITYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    18751886        This parameter controls what UNIX permission bits can be modified when a Windows NT client is manipulating
    18761887    the UNIX permission on a file using the native NT security dialog box.
    18771888        </p><p>
    18781889        This parameter is applied as a mask (OR'ed with) to the changed permission bits, thus forcing any bits in this
    1879         mask that the user may have modified to be on.  Make sure not to mix up this parameter with <a class="link" href="smb.conf.5.html#SECURITYMASK">security mask</a>, which works similar like this one but uses logical AND instead of OR.
     1890        mask that the user may have modified to be on.  Make sure not to mix up this parameter with <a class="link" href="smb.conf.5.html#SECURITYMASK" target="_top">security mask</a>, which works similar like this one but uses logical AND instead of OR.
    18801891        </p><p>
    18811892        Essentially, one bits in this mask may be treated as a set of bits that, when modifying security on a file,
    … …  
    18921903</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force security mode</code></em> = <code class="literal">700</code>
    18931904</em></span>
    1894 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id308187"></a>
     1905</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541339"></a>
    18951906
    18961907force unknown acl user (S)
    1897 </h3></div></div></div><a class="indexterm" name="id308188"></a><a name="FORCEUNKNOWNACLUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1908</h3></div></div></div><a class="indexterm" name="id2541340"></a><a name="FORCEUNKNOWNACLUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    18981909    If this parameter is set, a Windows NT ACL that contains an unknown SID (security descriptor, or
    18991910    representation of a user or group id) as the owner or group owner of the file will be silently
    … …  
    19091920    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>force unknown acl user</code></em> = <code class="literal">no</code>
    19101921</em></span>
    1911 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id308238"></a>
     1922</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541398"></a>
    19121923
    19131924force user (S)
    1914 </h3></div></div></div><a class="indexterm" name="id308239"></a><a name="FORCEUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies a UNIX user name that will be
     1925</h3></div></div></div><a class="indexterm" name="id2541399"></a><a name="FORCEUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies a UNIX user name that will be
    19151926    assigned as the default user for all users connecting to this service.
    19161927    This is useful for sharing files. You should also use it carefully
    … …  
    19261937</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force user</code></em> = <code class="literal">auser</code>
    19271938</em></span>
    1928 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id308303"></a>
     1939</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541470"></a>
    19291940
    19301941fstype (S)
    1931 </h3></div></div></div><a class="indexterm" name="id308304"></a><a name="FSTYPE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1942</h3></div></div></div><a class="indexterm" name="id2541471"></a><a name="FSTYPE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    19321943        This parameter allows the administrator to configure the string that specifies the type of filesystem a share
    19331944        is using that is reported by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>
    … …  
    19391950</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>fstype</code></em> = <code class="literal">Samba</code>
    19401951</em></span>
    1941 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id308376"></a>
     1952</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541545"></a>
    19421953
    19431954get quota command (G)
    1944 </h3></div></div></div><a class="indexterm" name="id308377"></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
     1955</h3></div></div></div><a class="indexterm" name="id2541546"></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
    19451956        whenever there is no operating system API available from the OS that
    19461957        samba can use.</p><p>This option is only available you have compiled Samba with the
    … …  
    19551966</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>
    19561967</em></span>
    1957 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id308538"></a>
     1968</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541720"></a>
    19581969
    19591970getwd cache (G)
    1960 </h3></div></div></div><a class="indexterm" name="id308539"></a><a name="GETWDCACHE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a tuning option. When this is enabled a
     1971</h3></div></div></div><a class="indexterm" name="id2541721"></a><a name="GETWDCACHE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a tuning option. When this is enabled a
    19611972    caching algorithm will be used to reduce the time taken for getwd()
    19621973    calls. This can have a significant impact on performance, especially
    1963     when the <a class="link" href="smb.conf.5.html#WIDESMBCONFOPTIONS">wide smbconfoptions</a> parameter is set to <code class="constant">no</code>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>getwd cache</code></em> = <code class="literal">yes</code>
    1964 </em></span>
    1965 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id308587"></a>
     1974    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>
     1975</em></span>
     1976</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541773"></a>
    19661977
    19671978guest account (G)
    1968 </h3></div></div></div><a class="indexterm" name="id308588"></a><a name="GUESTACCOUNT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a username which will be used for access
    1969     to services which are specified as <a class="link" href="smb.conf.5.html#GUESTOK">guest ok</a> (see below). Whatever privileges this
     1979</h3></div></div></div><a class="indexterm" name="id2541774"></a><a name="GUESTACCOUNT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a username which will be used for access
     1980    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
    19701981    user has will be available to any client connecting to the guest service.
    19711982    This user must exist in the password file, but does not require
    … …  
    19841995</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>guest account</code></em> = <code class="literal">ftp</code>
    19851996</em></span>
    1986 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id308676"></a>
     1997</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541870"></a>
    19871998
    19881999<a name="PUBLIC"></a>public
    1989 </h3></div></div></div><a class="indexterm" name="id308678"></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="id308703"></a>
     2000</h3></div></div></div><a class="indexterm" name="id2541871"></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="id2541897"></a>
    19902001
    19912002guest ok (S)
    1992 </h3></div></div></div><a class="indexterm" name="id308704"></a><a name="GUESTOK"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code> for
     2003</h3></div></div></div><a class="indexterm" name="id2541898"></a><a name="GUESTOK"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code> for
    19932004    a service, then no password is required to connect to the service.
    1994     Privileges will be those of the <a class="link" href="smb.conf.5.html#GUESTACCOUNT">guest account</a>.</p><p>This paramater nullifies the benifits of setting
    1995     <a class="link" href="smb.conf.5.html#RESTRICTANONYMOUS">restrict anonymous = 2</a>
    1996         </p><p>See the section below on <a class="link" href="smb.conf.5.html#SECURITY">security</a> for more information about this option.
     2005    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
     2006    <a class="link" href="smb.conf.5.html#RESTRICTANONYMOUS" target="_top">restrict anonymous = 2</a>
     2007        </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.
    19972008        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>guest ok</code></em> = <code class="literal">no</code>
    19982009</em></span>
    1999 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id308772"></a>
     2010</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541972"></a>
    20002011
    20012012<a name="ONLYGUEST"></a>only guest
    2002 </h3></div></div></div><a class="indexterm" name="id308773"></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="id308798"></a>
     2013</h3></div></div></div><a class="indexterm" name="id2541973"></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="id2541999"></a>
    20032014
    20042015guest only (S)
    2005 </h3></div></div></div><a class="indexterm" name="id308799"></a><a name="GUESTONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code> for
     2016</h3></div></div></div><a class="indexterm" name="id2542000"></a><a name="GUESTONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code> for
    20062017    a service, then only guest connections to the service are permitted.
    2007     This parameter will have no effect if <a class="link" href="smb.conf.5.html#GUESTOK">guest ok</a> is not set for the service.</p><p>See the section below on <a class="link" href="smb.conf.5.html#SECURITY">security</a> for more information about this option.
     2018    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.
    20082019        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>guest only</code></em> = <code class="literal">no</code>
    20092020</em></span>
    2010 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id308857"></a>
     2021</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542069"></a>
    20112022
    20122023hide dot files (S)
    2013 </h3></div></div></div><a class="indexterm" name="id308858"></a><a name="HIDEDOTFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls whether
     2024</h3></div></div></div><a class="indexterm" name="id2542070"></a><a name="HIDEDOTFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls whether
    20142025        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>
    20152026</em></span>
    2016 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id308895"></a>
     2027</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542111"></a>
    20172028
    20182029hide files (S)
    2019 </h3></div></div></div><a class="indexterm" name="id308896"></a><a name="HIDEFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of files or directories that are not
     2030</h3></div></div></div><a class="indexterm" name="id2542112"></a><a name="HIDEFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of files or directories that are not
    20202031        visible but are accessible.  The DOS 'hidden' attribute is applied
    20212032        to any files or directories that match.</p><p>Each entry in the list must be separated by a '/',
    … …  
    20392050# no file are hidden</code>
    20402051</em></span>
    2041 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id308970"></a>
     2052</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542200"></a>
    20422053
    20432054hide special files (S)
    2044 </h3></div></div></div><a class="indexterm" name="id308971"></a><a name="HIDESPECIALFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2055</h3></div></div></div><a class="indexterm" name="id2542201"></a><a name="HIDESPECIALFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    20452056        This parameter prevents clients from seeing special files such as sockets, devices and
    20462057        fifo's in directory listings.
    20472058        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>hide special files</code></em> = <code class="literal">no</code>
    20482059</em></span>
    2049 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id309008"></a>
     2060</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542243"></a>
    20502061
    20512062hide unreadable (S)
    2052 </h3></div></div></div><a class="indexterm" name="id309009"></a><a name="HIDEUNREADABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter prevents clients from seeing the
     2063</h3></div></div></div><a class="indexterm" name="id2542244"></a><a name="HIDEUNREADABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter prevents clients from seeing the
    20532064                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>
    20542065</em></span>
    2055 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id309046"></a>
     2066</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542285"></a>
    20562067
    20572068hide unwriteable files (S)
    2058 </h3></div></div></div><a class="indexterm" name="id309047"></a><a name="HIDEUNWRITEABLEFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2069</h3></div></div></div><a class="indexterm" name="id2542286"></a><a name="HIDEUNWRITEABLEFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    20592070    This parameter prevents clients from seeing the existance of files that cannot be written to.
    20602071    Defaults to off. Note that unwriteable directories are shown as usual.
    20612072    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>hide unwriteable files</code></em> = <code class="literal">no</code>
    20622073</em></span>
    2063 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id309084"></a>
     2074</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542330"></a>
    20642075
    20652076homedir map (G)
    2066 </h3></div></div></div><a class="indexterm" name="id309085"></a><a name="HOMEDIRMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    2067         If <a class="link" href="smb.conf.5.html#NISHOMEDIR">nis homedir</a> is <code class="constant">yes</code>, and <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> is also acting       as a Win95/98 <em class="parameter"><code>logon server</code></em>
     2077</h3></div></div></div><a class="indexterm" name="id2542331"></a><a name="HOMEDIRMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2078        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>
    20682079        then this parameter specifies the NIS (or YP) map from which the server for the user's  home directory should be extracted. 
    20692080        At present, only the Sun auto.home map format is understood. The form of the map is:
    … …  
    20792090</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>homedir map</code></em> = <code class="literal">amd.homedir</code>
    20802091</em></span>
    2081 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id309178"></a>
     2092</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542442"></a>
    20822093
    20832094host msdfs (G)
    2084 </h3></div></div></div><a class="indexterm" name="id309179"></a><a name="HOSTMSDFS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2095</h3></div></div></div><a class="indexterm" name="id2542444"></a><a name="HOSTMSDFS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    20852096        If set to <code class="constant">yes</code>, Samba will act as a Dfs server, and allow Dfs-aware clients to browse
    20862097        Dfs trees hosted on the server.
    20872098        </p><p>
    2088         See also the <a class="link" href="smb.conf.5.html#MSDFSROOT">msdfs root</a> share  level  parameter.  For more  information  on
     2099        See also the <a class="link" href="smb.conf.5.html#MSDFSROOT" target="_top">msdfs root</a> share  level  parameter.  For more  information  on
    20892100        setting  up a Dfs tree on Samba, refer to the MSFDS chapter in the book Samba3-HOWTO.
    20902101        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>host msdfs</code></em> = <code class="literal">yes</code>
    20912102</em></span>
    2092 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id309234"></a>
     2103</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542507"></a>
    20932104
    20942105hostname lookups (G)
    2095 </h3></div></div></div><a class="indexterm" name="id309236"></a><a name="HOSTNAMELOOKUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies whether samba should use (expensive)
     2106</h3></div></div></div><a class="indexterm" name="id2542508"></a><a name="HOSTNAMELOOKUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies whether samba should use (expensive)
    20962107    hostname lookups or use the ip addresses instead. An example place
    20972108    where hostname lookups are currently used is when checking
    … …  
    21012112</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>hostname lookups</code></em> = <code class="literal">yes</code>
    21022113</em></span>
    2103 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id309305"></a>
     2114</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542580"></a>
    21042115
    21052116<a name="ALLOWHOSTS"></a>allow hosts
    2106 </h3></div></div></div><a class="indexterm" name="id309306"></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="id309337"></a>
     2117</h3></div></div></div><a class="indexterm" name="id2542581"></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="id2542612"></a>
    21072118
    21082119hosts allow (S)
    2109 </h3></div></div></div><a class="indexterm" name="id309338"></a><a name="HOSTSALLOW"></a><div class="variablelist"><dl><dt></dt><dd><p>A synonym for this parameter is <a class="link" href="smb.conf.5.html#ALLOWHOSTS">allow hosts</a>.</p><p>This parameter is a comma, space, or tab delimited
     2120</h3></div></div></div><a class="indexterm" name="id2542614"></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
    21102121    set of hosts which are permitted to access a service.</p><p>If specified in the [global] section then it will
    21112122    apply to all services, regardless of whether the individual
    … …  
    21172128    page may not be present on your system, so a brief description will
    21182129    be given here also.</p><p>Note that the localhost address 127.0.0.1 will always
    2119     be allowed access unless specifically denied by a <a class="link" href="smb.conf.5.html#HOSTSDENY">hosts deny</a> option.</p><p>You can also specify hosts by network/netmask pairs and
     2130    be allowed access unless specifically denied by a <a class="link" href="smb.conf.5.html#HOSTSDENY" target="_top">hosts deny</a> option.</p><p>You can also specify hosts by network/netmask pairs and
    21202131    by netgroup names if your system supports netgroups. The
    21212132    <span class="emphasis"><em>EXCEPT</em></span> keyword can also be used to limit a
    … …  
    21272138</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>
    21282139</em></span>
    2129 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id309525"></a>
     2140</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542815"></a>
    21302141
    21312142<a name="DENYHOSTS"></a>deny hosts
    2132 </h3></div></div></div><a class="indexterm" name="id309526"></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="id309556"></a>
     2143</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="#HOSTSDENY">hosts deny</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542846"></a>
    21332144
    21342145hosts deny (S)
    2135 </h3></div></div></div><a class="indexterm" name="id309557"></a><a name="HOSTSDENY"></a><div class="variablelist"><dl><dt></dt><dd><p>The opposite of <em class="parameter"><code>hosts allow</code></em>
     2146</h3></div></div></div><a class="indexterm" name="id2542847"></a><a name="HOSTSDENY"></a><div class="variablelist"><dl><dt></dt><dd><p>The opposite of <em class="parameter"><code>hosts allow</code></em>
    21362147    - hosts listed here are <span class="emphasis"><em>NOT</em></span> permitted access to
    21372148    services unless the specific services have their own lists to override
    … …  
    21402151        In the event that it is necessary to deny all by default, use the keyword
    21412152        ALL (or the netmask <code class="literal">0.0.0.0/0</code>) and then explicitly specify
    2142         to the <a class="link" href="smb.conf.5.html#HOSTSALLOW">hosts allow = hosts allow</a> parameter those hosts
     2153        to the <a class="link" href="smb.conf.5.html#HOSTSALLOW" target="_top">hosts allow = hosts allow</a> parameter those hosts
    21432154        that should be permitted access.
    21442155        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>hosts deny</code></em> = <code class="literal">
    … …  
    21472158</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>
    21482159</em></span>
    2149 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id309652"></a>
     2160</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542948"></a>
    21502161
    21512162idmap alloc backend (G)
    2152 </h3></div></div></div><a class="indexterm" name="id309654"></a><a name="IDMAPALLOCBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2163</h3></div></div></div><a class="indexterm" name="id2542949"></a><a name="IDMAPALLOCBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    21532164        The idmap alloc backend provides a plugin interface for Winbind to use
    21542165        when allocating Unix uids/gids for Windows SIDs.  This option is
    2155         to be used in conjunction with the <a class="link" href="smb.conf.5.html#IDMAPDOMAINS">idmap domains</a>
     2166        to be used in conjunction with the <a class="link" href="smb.conf.5.html#IDMAPDOMAINS" target="_top">idmap domains</a>
    21562167        parameter and refers to the name of the idmap module which will provide
    21572168        the id allocation functionality.  Please refer to the man page
    … …  
    21592170        the allocation feature.  The most common plugins are the tdb (<a class="citerefentry" href="idmap_tdb.8.html"><span class="citerefentry"><span class="refentrytitle">idmap_tdb</span>(8)</span></a>)
    21602171        and ldap (<a class="citerefentry" href="idmap_ldap.8.html"><span class="citerefentry"><span class="refentrytitle">idmap_ldap</span>(8)</span></a>) libraries.
    2161         </p><p>Also refer to the <a class="link" href="smb.conf.5.html#IDMAPALLOCCONFIG">idmap alloc config</a> option.
     2172        </p><p>Also refer to the <a class="link" href="smb.conf.5.html#IDMAPALLOCCONFIG" target="_top">idmap alloc config</a> option.
    21622173        </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>
    21632174</em></span>
    2164 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id309743"></a>
     2175</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543046"></a>
    21652176
    21662177idmap alloc config (G)
    2167 </h3></div></div></div><a class="indexterm" name="id309744"></a><a name="IDMAPALLOCCONFIG"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2178</h3></div></div></div><a class="indexterm" name="id2543048"></a><a name="IDMAPALLOCCONFIG"></a><div class="variablelist"><dl><dt></dt><dd><p>
    21682179        The idmap alloc config prefix provides a means of managing settings
    2169         for the backend defined by the <a class="link" href="smb.conf.5.html#IDMAPALLOCBACKEND">idmap alloc backend</a>
     2180        for the backend defined by the <a class="link" href="smb.conf.5.html#IDMAPALLOCBACKEND" target="_top">idmap alloc backend</a>
    21702181        parameter.  Refer to the man page for each idmap plugin regarding
    21712182        specific configuration details.
    2172         </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="id309783"></a>
     2183        </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="id2543091"></a>
    21732184
    21742185idmap backend (G)
    2175 </h3></div></div></div><a class="indexterm" name="id309784"></a><a name="IDMAPBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2186</h3></div></div></div><a class="indexterm" name="id2543092"></a><a name="IDMAPBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    21762187        The idmap backend provides a plugin interface for Winbind to use
    21772188        varying backends to store SID/uid/gid mapping tables.  This
    21782189        option is mutually exclusive with the newer and more flexible
    2179         <a class="link" href="smb.conf.5.html#IDMAPDOMAINS">idmap domains</a> parameter. The main difference
     2190        <a class="link" href="smb.conf.5.html#IDMAPDOMAINS" target="_top">idmap domains</a> parameter. The main difference
    21802191        between the "idmap backend" and the "idmap domains"
    21812192        is that the former only allows one backend for all domains while the
    … …  
    21862197        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>idmap backend</code></em> = <code class="literal">tdb</code>
    21872198</em></span>
    2188 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id309873"></a>
     2199</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543186"></a>
    21892200
    21902201idmap cache time (G)
    2191 </h3></div></div></div><a class="indexterm" name="id309874"></a><a name="IDMAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of seconds that Winbind's
     2202</h3></div></div></div><a class="indexterm" name="id2543187"></a><a name="IDMAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of seconds that Winbind's
    21922203        idmap interface will cache positive SID/uid/gid query results.
    21932204        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>idmap cache time</code></em> = <code class="literal">900</code>
    21942205</em></span>
    2195 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id309914"></a>
     2206</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543230"></a>
    21962207
    21972208idmap config (G)
    2198 </h3></div></div></div><a class="indexterm" name="id309915"></a><a name="IDMAPCONFIG"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2209</h3></div></div></div><a class="indexterm" name="id2543231"></a><a name="IDMAPCONFIG"></a><div class="variablelist"><dl><dt></dt><dd><p>
    21992210        The idmap config prefix provides a means of managing each domain
    2200         defined by the <a class="link" href="smb.conf.5.html#IDMAPDOMAINS">idmap domains</a> option using Samba's
     2211        defined by the <a class="link" href="smb.conf.5.html#IDMAPDOMAINS" target="_top">idmap domains</a> option using Samba's
    22012212        parametric option support. The idmap config prefix should be
    22022213        followed by the name of the domain, a colon, and a setting specific to
    … …  
    22122223                </p></dd><dt><span class="term">readonly = [yes|no]</span></dt><dd><p>
    22132224                        Mark the domain as readonly which means that no attempts to
    2214                         allocate a uid or gid (by the <a class="link" href="smb.conf.5.html#IDMAPALLOCBACKEND">idmap alloc     backend</a>) for any user or group in that domain
     2225                        allocate a uid or gid (by the <a class="link" href="smb.conf.5.html#IDMAPALLOCBACKEND" target="_top">idmap alloc     backend</a>) for any user or group in that domain
    22152226                        will be attempted.
    22162227                </p></dd></dl></div><p>
    … …  
    22292240        idmap config TRUSTEDDOMAINS:default = yes
    22302241        idmap config TRUSTEDDOMAINS:range   = 1000 - 9999
    2231         </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="id310035"></a>
     2242        </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="id2543367"></a>
    22322243
    22332244idmap domains (G)
    2234 </h3></div></div></div><a class="indexterm" name="id310036"></a><a name="IDMAPDOMAINS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2245</h3></div></div></div><a class="indexterm" name="id2543368"></a><a name="IDMAPDOMAINS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    22352246        The idmap domains option defines a list of Windows domains which will each
    22362247        have a separately configured backend for managing Winbind's SID/uid/gid
    2237         tables.  This parameter is mutually exclusive with the older <a class="link" href="smb.conf.5.html#IDMAPBACKEND">idmap backend</a> option.
     2248        tables.  This parameter is mutually exclusive with the older <a class="link" href="smb.conf.5.html#IDMAPBACKEND" target="_top">idmap backend</a> option.
    22382249        </p><p>
    22392250        Values consist of the short domain name for Winbind's primary or collection
    … …  
    22412252        domain backend for any domain not explicitly listed.
    22422253        </p><p>
    2243         Refer to the <a class="link" href="smb.conf.5.html#IDMAPCONFIG">idmap config</a> for details about
     2254        Refer to the <a class="link" href="smb.conf.5.html#IDMAPCONFIG" target="_top">idmap config</a> for details about
    22442255        managing the SID/uid/gid backend for each domain.
    22452256        </p><p><span class="emphasis"><em>No default</em></span></p><p>Example: <span class="emphasis"><em><em class="parameter"><code>idmap domains</code></em> = <code class="literal">default AD CORP</code>
    22462257</em></span>
    2247 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id310113"></a>
     2258</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543452"></a>
    22482259
    22492260<a name="WINBINDGID"></a>winbind gid
    2250 </h3></div></div></div><a class="indexterm" name="id310114"></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="id310145"></a>
     2261</h3></div></div></div><a class="indexterm" name="id2543453"></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="id2543484"></a>
    22512262
    22522263idmap gid (G)
    2253 </h3></div></div></div><a class="indexterm" name="id310146"></a><a name="IDMAPGID"></a><div class="variablelist"><dl><dt></dt><dd><p>The idmap gid parameter specifies the range of group ids
     2264</h3></div></div></div><a class="indexterm" name="id2543485"></a><a name="IDMAPGID"></a><div class="variablelist"><dl><dt></dt><dd><p>The idmap gid parameter specifies the range of group ids
    22542265        that are allocated for the purpose of mapping UNX groups to NT group
    22552266        SIDs. This range of group ids should have no
    22562267        existing local or NIS groups within it as strange conflicts can
    2257         occur otherwise.</p><p>See also the <a class="link" href="smb.conf.5.html#IDMAPBACKEND">idmap backend</a>, <a class="link" href="smb.conf.5.html#IDMAPDOMAINS">idmap domains</a>, and <a class="link" href="smb.conf.5.html#IDMAPCONFIG">idmap config</a> options.
     2268        occur otherwise.</p><p>See also the <a class="link" href="smb.conf.5.html#IDMAPBACKEND" target="_top">idmap backend</a>, <a class="link" href="smb.conf.5.html#IDMAPDOMAINS" target="_top">idmap domains</a>, and <a class="link" href="smb.conf.5.html#IDMAPCONFIG" target="_top">idmap config</a> options.
    22582269        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>idmap gid</code></em> = <code class="literal"></code>
    22592270</em></span>
    22602271</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>idmap gid</code></em> = <code class="literal">10000-20000</code>
    22612272</em></span>
    2262 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id310238"></a>
     2273</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543582"></a>
    22632274
    22642275idmap negative cache time (G)
    2265 </h3></div></div></div><a class="indexterm" name="id310239"></a><a name="IDMAPNEGATIVECACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of seconds that Winbind's
     2276</h3></div></div></div><a class="indexterm" name="id2543583"></a><a name="IDMAPNEGATIVECACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of seconds that Winbind's
    22662277        idmap interface will cache negative SID/uid/gid query results.
    22672278        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>idmap negative cache time</code></em> = <code class="literal">120</code>
    22682279</em></span>
    2269 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id310280"></a>
     2280</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543626"></a>
    22702281
    22712282<a name="WINBINDUID"></a>winbind uid
    2272 </h3></div></div></div><a class="indexterm" name="id310281"></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="id310312"></a>
     2283</h3></div></div></div><a class="indexterm" name="id2543627"></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="id2543658"></a>
    22732284
    22742285idmap uid (G)
    2275 </h3></div></div></div><a class="indexterm" name="id310313"></a><a name="IDMAPUID"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2286</h3></div></div></div><a class="indexterm" name="id2543659"></a><a name="IDMAPUID"></a><div class="variablelist"><dl><dt></dt><dd><p>
    22762287        The idmap uid parameter specifies the range of user ids that are
    22772288        allocated for use in mapping UNIX users to NT user SIDs. This
    22782289        range of ids should have no existing local
    2279         or NIS users within it as strange conflicts can occur otherwise.</p><p>See also the <a class="link" href="smb.conf.5.html#IDMAPBACKEND">idmap backend</a>, <a class="link" href="smb.conf.5.html#IDMAPDOMAINS">idmap domains</a>, and <a class="link" href="smb.conf.5.html#IDMAPCONFIG">idmap config</a> options.
     2290        or NIS users within it as strange conflicts can occur otherwise.</p><p>See also the <a class="link" href="smb.conf.5.html#IDMAPBACKEND" target="_top">idmap backend</a>, <a class="link" href="smb.conf.5.html#IDMAPDOMAINS" target="_top">idmap domains</a>, and <a class="link" href="smb.conf.5.html#IDMAPCONFIG" target="_top">idmap config</a> options.
    22802291        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>idmap uid</code></em> = <code class="literal"></code>
    22812292</em></span>
    22822293</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>idmap uid</code></em> = <code class="literal">10000-20000</code>
    22832294</em></span>
    2284 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id310404"></a>
     2295</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543756"></a>
    22852296
    22862297include (G)
    2287 </h3></div></div></div><a class="indexterm" name="id310406"></a><a name="INCLUDE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2298</h3></div></div></div><a class="indexterm" name="id2543757"></a><a name="INCLUDE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    22882299        This allows you to include one config file inside another.  The file is included literally, as though typed
    22892300        in place.
    … …  
    22952306</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>
    22962307</em></span>
    2297 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id310482"></a>
     2308</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543835"></a>
    22982309
    22992310inherit acls (S)
    2300 </h3></div></div></div><a class="indexterm" name="id310483"></a><a name="INHERITACLS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter can be used to ensure that if default acls
     2311</h3></div></div></div><a class="indexterm" name="id2543836"></a><a name="INHERITACLS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter can be used to ensure that if default acls
    23012312    exist on parent directories, they are always honored when creating a
    23022313    new file or subdirectory in these parent directories. The default
    … …  
    23062317</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>inherit acls</code></em> = <code class="literal">no</code>
    23072318</em></span>
    2308 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id310525"></a>
     2319</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543882"></a>
    23092320
    23102321inherit owner (S)
    2311 </h3></div></div></div><a class="indexterm" name="id310526"></a><a name="INHERITOWNER"></a><div class="variablelist"><dl><dt></dt><dd><p>The ownership of new files and directories
     2322</h3></div></div></div><a class="indexterm" name="id2543883"></a><a name="INHERITOWNER"></a><div class="variablelist"><dl><dt></dt><dd><p>The ownership of new files and directories
    23122323        is normally governed by effective uid of the connected user.
    23132324        This option allows the Samba administrator to specify that
    … …  
    23182329        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>
    23192330</em></span>
    2320 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id310573"></a>
     2331</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543936"></a>
    23212332
    23222333inherit permissions (S)
    2323 </h3></div></div></div><a class="indexterm" name="id310574"></a><a name="INHERITPERMISSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    2324         The permissions on new files and directories are normally governed by <a class="link" href="smb.conf.5.html#CREATEMASK">create mask</a>,
    2325         <a class="link" href="smb.conf.5.html#DIRECTORYMASK">directory mask</a>, <a class="link" href="smb.conf.5.html#FORCECREATEMODE">force create mode</a> and <a class="link" href="smb.conf.5.html#FORCEDIRECTORYMODE">force directory mode</a> but the boolean inherit permissions parameter overrides this.
     2334</h3></div></div></div><a class="indexterm" name="id2543937"></a><a name="INHERITPERMISSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2335        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>,
     2336        <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.
    23262337        </p><p>New directories inherit the mode of the parent directory,
    23272338    including bits such as setgid.</p><p>
    23282339        New files inherit their read/write bits from the parent directory.  Their execute bits continue to be
    2329         determined by <a class="link" href="smb.conf.5.html#MAPARCHIVE">map archive</a>, <a class="link" href="smb.conf.5.html#MAPHIDDEN">map hidden</a> and <a class="link" href="smb.conf.5.html#MAPSYSTEM">map system</a> as usual.
     2340        determined by <a class="link" href="smb.conf.5.html#MAPARCHIVE" target="_top">map archive</a>, <a class="link" href="smb.conf.5.html#MAPHIDDEN" target="_top">map hidden</a> and <a class="link" href="smb.conf.5.html#MAPSYSTEM" target="_top">map system</a> as usual.
    23302341        </p><p>Note that the setuid bit is <span class="emphasis"><em>never</em></span> set via
    23312342    inheritance (the code explicitly prohibits this).</p><p>This can be particularly useful on large systems with
    … …  
    23332344    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>
    23342345</em></span>
    2335 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id310710"></a>
     2346</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544085"></a>
    23362347
    23372348interfaces (G)
    2338 </h3></div></div></div><a class="indexterm" name="id310711"></a><a name="INTERFACES"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to override the default
     2349</h3></div></div></div><a class="indexterm" name="id2544086"></a><a name="INTERFACES"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to override the default
    23392350        network interfaces list that Samba will use for browsing, name
    23402351        registration and other NBT traffic. By default Samba will query
    … …  
    23602371</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>
    23612372</em></span>
    2362 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id310815"></a>
     2373</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544201"></a>
    23632374
    23642375invalid users (S)
    2365 </h3></div></div></div><a class="indexterm" name="id310816"></a><a name="INVALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of users that should not be allowed
     2376</h3></div></div></div><a class="indexterm" name="id2544202"></a><a name="INVALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of users that should not be allowed
    23662377    to login to this service. This is really a <span class="emphasis"><em>paranoid</em></span>
    23672378    check to absolutely ensure an improper setting does not breach
    … …  
    23832394</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>invalid users</code></em> = <code class="literal">root fred admin @wheel</code>
    23842395</em></span>
    2385 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id310916"></a>
     2396</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544315"></a>
    23862397
    23872398iprint server (G)
    2388 </h3></div></div></div><a class="indexterm" name="id310917"></a><a name="IPRINTSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    2389     This parameter is only applicable if <a class="link" href="smb.conf.5.html#PRINTING">printing</a> is set to <code class="constant">iprint</code>.
     2399</h3></div></div></div><a class="indexterm" name="id2544316"></a><a name="IPRINTSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2400    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>.
    23902401    </p><p>
    23912402   If set, this option overrides the ServerName option in the CUPS <code class="filename">client.conf</code>. This is
    … …  
    23952406</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>iprint server</code></em> = <code class="literal">MYCUPSSERVER</code>
    23962407</em></span>
    2397 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id310998"></a>
     2408</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544401"></a>
    23982409
    23992410keepalive (G)
    2400 </h3></div></div></div><a class="indexterm" name="id310999"></a><a name="KEEPALIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (an integer) represents
     2411</h3></div></div></div><a class="indexterm" name="id2544402"></a><a name="KEEPALIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (an integer) represents
    24012412    the number of seconds between <em class="parameter"><code>keepalive</code></em>
    24022413    packets. If this parameter is zero, no keepalive packets will be
    24032414    sent. Keepalive packets, if sent, allow the server to tell whether
    24042415    a client is still present and responding.</p><p>Keepalives should, in general, not be needed if the socket
    2405     has the SO_KEEPALIVE attribute set on it by default. (see <a class="link" href="smb.conf.5.html#SOCKETOPTIONS">socket options</a>).
     2416    has the SO_KEEPALIVE attribute set on it by default. (see <a class="link" href="smb.conf.5.html#SOCKETOPTIONS" target="_top">socket options</a>).
    24062417Basically you should only use this option if you strike difficulties.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>keepalive</code></em> = <code class="literal">300</code>
    24072418</em></span>
    24082419</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>keepalive</code></em> = <code class="literal">600</code>
    24092420</em></span>
    2410 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id311080"></a>
     2421</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544489"></a>
    24112422
    24122423kernel change notify (S)
    2413 </h3></div></div></div><a class="indexterm" name="id311081"></a><a name="KERNELCHANGENOTIFY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should ask the
     2424</h3></div></div></div><a class="indexterm" name="id2544490"></a><a name="KERNELCHANGENOTIFY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should ask the
    24142425        kernel for change notifications in directories so that
    24152426        SMB clients can refresh whenever the data on the server changes.
    … …  
    24182429        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>kernel change notify</code></em> = <code class="literal">yes</code>
    24192430</em></span>
    2420 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id311125"></a>
     2431</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544539"></a>
    24212432
    24222433kernel oplocks (G)
    2423 </h3></div></div></div><a class="indexterm" name="id311126"></a><a name="KERNELOPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>For UNIXes that support kernel based <a class="link" href="smb.conf.5.html#OPLOCKS">oplocks</a>
     2434</h3></div></div></div><a class="indexterm" name="id2544540"></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>
    24242435        (currently only IRIX and the Linux 2.4 kernel), this parameter
    24252436        allows the use of them to be turned on or off.</p><p>Kernel oplocks support allows Samba <em class="parameter"><code>oplocks
    … …  
    24312442        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>
    24322443</em></span>
    2433 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id311208"></a>
     2444</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544627"></a>
    24342445
    24352446lanman auth (G)
    2436 </h3></div></div></div><a class="indexterm" name="id311209"></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
     2447</h3></div></div></div><a class="indexterm" name="id2544628"></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
    24372448    authenticate users or permit password changes
    24382449    using the LANMAN password hash. If disabled, only clients which support NT
    … …  
    24512462    special configuration to use it.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>lanman auth</code></em> = <code class="literal">yes</code>
    24522463</em></span>
    2453 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id311291"></a>
     2464</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544720"></a>
    24542465
    24552466large readwrite (G)
    2456 </h3></div></div></div><a class="indexterm" name="id311292"></a><a name="LARGEREADWRITE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not
     2467</h3></div></div></div><a class="indexterm" name="id2544721"></a><a name="LARGEREADWRITE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not
    24572468    <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> supports the new 64k
    24582469    streaming read and write varient SMB requests introduced with
    … …  
    24632474        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>
    24642475</em></span>
    2465 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id311346"></a>
     2476</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544783"></a>
    24662477
    24672478ldap admin dn (G)
    2468 </h3></div></div></div><a class="indexterm" name="id311347"></a><a name="LDAPADMINDN"></a><div class="variablelist"><dl><dt></dt><dd><p>
    2469         The <a class="link" href="smb.conf.5.html#LDAPADMINDN">ldap admin dn</a> defines the Distinguished  Name (DN) name used by Samba to contact
    2470         the ldap server when retreiving  user account information. The <a class="link" href="smb.conf.5.html#LDAPADMINDN">ldap admin dn</a> is used
     2479</h3></div></div></div><a class="indexterm" name="id2544784"></a><a name="LDAPADMINDN"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2480        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
     2481        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
    24712482        in conjunction with the admin dn password stored in the <code class="filename">private/secrets.tdb</code>
    24722483        file.  See the <a class="citerefentry" href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a>
    24732484        man page for more information on how  to accomplish this.
    24742485        </p><p>
    2475         The <a class="link" href="smb.conf.5.html#LDAPADMINDN">ldap admin dn</a> requires a fully specified DN. The <a class="link" href="smb.conf.5.html#LDAPSUFFIX">ldap  suffix</a> is not appended to the <a class="link" href="smb.conf.5.html#LDAPADMINDN">ldap admin dn</a>.
    2476         </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="id311447"></a>
     2486        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>.
     2487        </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="id2544892"></a>
    24772488
    24782489ldap delete dn (G)
    2479 </h3></div></div></div><a class="indexterm" name="id311448"></a><a name="LDAPDELETEDN"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter specifies whether a delete
     2490</h3></div></div></div><a class="indexterm" name="id2544894"></a><a name="LDAPDELETEDN"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter specifies whether a delete
    24802491        operation in the ldapsam deletes the complete entry or only the attributes
    24812492        specific to Samba.
    24822493        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap delete dn</code></em> = <code class="literal">no</code>
    24832494</em></span>
    2484 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id311489"></a>
     2495</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544936"></a>
    24852496
    24862497ldap group suffix (G)
    2487 </h3></div></div></div><a class="indexterm" name="id311490"></a><a name="LDAPGROUPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the suffix that is
     2498</h3></div></div></div><a class="indexterm" name="id2544937"></a><a name="LDAPGROUPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the suffix that is
    24882499        used for groups when these are added to the LDAP directory.
    2489         If this parameter is unset, the value of <a class="link" href="smb.conf.5.html#LDAPSUFFIX">ldap suffix</a> will be used instead.  The suffix string is pre-pended to the
    2490         <a class="link" href="smb.conf.5.html#LDAPSUFFIX">ldap suffix</a> string so use a partial DN.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap group suffix</code></em> = <code class="literal"></code>
     2500        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
     2501        <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap suffix</a> string so use a partial DN.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap group suffix</code></em> = <code class="literal"></code>
    24912502</em></span>
    24922503</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap group suffix</code></em> = <code class="literal">ou=Groups</code>
    24932504</em></span>
    2494 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id311568"></a>
     2505</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545020"></a>
    24952506
    24962507ldap idmap suffix (G)
    2497 </h3></div></div></div><a class="indexterm" name="id311569"></a><a name="LDAPIDMAPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2508</h3></div></div></div><a class="indexterm" name="id2545021"></a><a name="LDAPIDMAPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
    24982509        This parameters specifies the suffix that is used when storing idmap mappings. If this parameter
    2499         is unset, the value of <a class="link" href="smb.conf.5.html#LDAPSUFFIX">ldap suffix</a> will be used instead.  The suffix
    2500         string is pre-pended to the <a class="link" href="smb.conf.5.html#LDAPSUFFIX">ldap suffix</a> string so use a partial DN.
     2510        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
     2511        string is pre-pended to the <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap suffix</a> string so use a partial DN.
    25012512        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap idmap suffix</code></em> = <code class="literal"></code>
    25022513</em></span>
    25032514</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap idmap suffix</code></em> = <code class="literal">ou=Idmap</code>
    25042515</em></span>
    2505 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id311647"></a>
     2516</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545102"></a>
    25062517
    25072518ldap machine suffix (G)
    2508 </h3></div></div></div><a class="indexterm" name="id311648"></a><a name="LDAPMACHINESUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2519</h3></div></div></div><a class="indexterm" name="id2545104"></a><a name="LDAPMACHINESUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
    25092520        It specifies where machines should be added to the ldap tree.  If this parameter is unset, the value of
    2510         <a class="link" href="smb.conf.5.html#LDAPSUFFIX">ldap suffix</a> will be used instead.  The suffix string is pre-pended to the
    2511         <a class="link" href="smb.conf.5.html#LDAPSUFFIX">ldap suffix</a> string so use a partial DN.
     2521        <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
     2522        <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap suffix</a> string so use a partial DN.
    25122523        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap machine suffix</code></em> = <code class="literal"></code>
    25132524</em></span>
    25142525</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap machine suffix</code></em> = <code class="literal">ou=Computers</code>
    25152526</em></span>
    2516 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id311725"></a>
     2527</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545185"></a>
    25172528
    25182529ldap passwd sync (G)
    2519 </h3></div></div></div><a class="indexterm" name="id311726"></a><a name="LDAPPASSWDSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2530</h3></div></div></div><a class="indexterm" name="id2545186"></a><a name="LDAPPASSWDSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    25202531        This option is used to define whether or not Samba should sync the LDAP password with the NT
    25212532        and LM hashes for normal accounts (NOT for workstation, server or domain trusts) on a password
    25222533        change via SAMBA. 
    25232534        </p><p>
    2524         The <a class="link" href="smb.conf.5.html#LDAPPASSWDSYNC">ldap passwd sync</a> can be set to one of three values:
     2535        The <a class="link" href="smb.conf.5.html#LDAPPASSWDSYNC" target="_top">ldap passwd sync</a> can be set to one of three values:
    25252536        </p><div class="itemizedlist"><ul type="disc"><li><p><em class="parameter"><code>Yes</code></em>  =  Try
    25262537                        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
    … …  
    25282539                        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>
    25292540</em></span>
    2530 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id311821"></a>
     2541</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545286"></a>
    25312542
    25322543ldap replication sleep (G)
    2533 </h3></div></div></div><a class="indexterm" name="id311822"></a><a name="LDAPREPLICATIONSLEEP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2544</h3></div></div></div><a class="indexterm" name="id2545287"></a><a name="LDAPREPLICATIONSLEEP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    25342545        When Samba is asked to write to a read-only LDAP replica, we are redirected to talk to the read-write master server.
    25352546        This server then replicates our changes back to the 'local' server, however the replication might take some seconds,
    … …  
    25442555        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap replication sleep</code></em> = <code class="literal">1000</code>
    25452556</em></span>
    2546 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id311876"></a>
     2557</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545349"></a>
    25472558
    25482559ldapsam:editposix (G)
    2549 </h3></div></div></div><a class="indexterm" name="id311877"></a><a name="LDAPSAM:EDITPOSIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2560</h3></div></div></div><a class="indexterm" name="id2545350"></a><a name="LDAPSAM:EDITPOSIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
    25502561        Editposix is an option that leverages ldapsam:trusted to make it simpler to manage a domain controller
    25512562        eliminating the need to set up custom scripts to add and manage the posix users and groups. This option
    … …  
    25602571        the smb.conf ldap options must be properly configured.
    25612572
    2562         The typical ldap setup used with the <a class="link" href="smb.conf.5.html#LDAPSAM:TRUSTED">ldapsam:trusted = yes</a> option
    2563         is usually sufficient to use <a class="link" href="smb.conf.5.html#LDAPSAM:EDITPOSIX">ldapsam:editposix = yes</a> as well.
     2573        The typical ldap setup used with the <a class="link" href="smb.conf.5.html#LDAPSAM:TRUSTED" target="_top">ldapsam:trusted = yes</a> option
     2574        is usually sufficient to use <a class="link" href="smb.conf.5.html#LDAPSAM:EDITPOSIX" target="_top">ldapsam:editposix = yes</a> as well.
    25642575        </p><p>
    25652576        An example configuration can be the following:
    … …  
    26262637        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldapsam:editposix</code></em> = <code class="literal">no</code>
    26272638</em></span>
    2628 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id311981"></a>
     2639</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545476"></a>
    26292640
    26302641ldapsam:trusted (G)
    2631 </h3></div></div></div><a class="indexterm" name="id311982"></a><a name="LDAPSAM:TRUSTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2642</h3></div></div></div><a class="indexterm" name="id2545477"></a><a name="LDAPSAM:TRUSTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
    26322643        By default, Samba as a Domain Controller with an LDAP backend needs to use the Unix-style NSS subsystem to
    26332644        access user and group information. Due to the way Unix stores user information in /etc/passwd and /etc/group
    … …  
    26372648        are used to deal with user and group attributes lack such optimization.
    26382649        </p><p>
    2639         To make Samba scale well in large environments, the <a class="link" href="smb.conf.5.html#LDAPSAM:TRUSTED">ldapsam:trusted = yes</a>
     2650        To make Samba scale well in large environments, the <a class="link" href="smb.conf.5.html#LDAPSAM:TRUSTED" target="_top">ldapsam:trusted = yes</a>
    26402651        option assumes that the complete user and group database that is relevant to Samba is stored in LDAP with the
    26412652        standard posixAccount/posixGroup attributes. It further assumes that the Samba auxiliary object classes are
    26422653        stored together with the POSIX data in the same LDAP object. If these assumptions are met,
    2643         <a class="link" href="smb.conf.5.html#LDAPSAM:TRUSTED">ldapsam:trusted = yes</a> can be activated and Samba can bypass the
     2654        <a class="link" href="smb.conf.5.html#LDAPSAM:TRUSTED" target="_top">ldapsam:trusted = yes</a> can be activated and Samba can bypass the
    26442655        NSS system to query user group memberships. Optimized LDAP queries can greatly speed up domain logon and
    26452656        administration tasks. Depending on the size of the LDAP database a factor of 100 or more for common queries
    … …  
    26472658        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldapsam:trusted</code></em> = <code class="literal">no</code>
    26482659</em></span>
    2649 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id312056"></a>
     2660</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545565"></a>
    26502661
    26512662ldap ssl (G)
    2652 </h3></div></div></div><a class="indexterm" name="id312057"></a><a name="LDAPSSL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used to define whether or not Samba should
     2663</h3></div></div></div><a class="indexterm" name="id2545566"></a><a name="LDAPSSL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used to define whether or not Samba should
    26532664        use SSL when connecting to the ldap server
    26542665        This is <span class="emphasis"><em>NOT</em></span> related to
    2655         Samba's previous SSL support which was enabled by specifying the
    2656          <code class="literal">--with-ssl</code> option to the <code class="filename">configure</code>
    2657         script.</p><p>The <a class="link" href="smb.conf.5.html#LDAPSSL">ldap ssl</a> can be set to one of three values:</p><div class="itemizedlist"><ul type="disc"><li><p><em class="parameter"><code>Off</code></em> = Never
    2658                         use SSL when querying the directory.</p></li><li><p><em class="parameter"><code>Start_tls</code></em> = Use
    2659                         the LDAPv3 StartTLS extended operation (RFC2830) for
    2660                         communicating with the directory server.</p></li><li><p><em class="parameter"><code>On</code></em>  = Use SSL
    2661                         on the ldaps port when contacting the <em class="parameter"><code>ldap server</code></em>. Only available when the
    2662                         backwards-compatiblity <code class="literal">--with-ldapsam</code> option is specified
    2663                 to configure. See <a class="link" href="smb.conf.5.html#PASSDBBACKEND">passdb backend</a></p>.
    2664                 </li></ul></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap ssl</code></em> = <code class="literal">start_tls</code>
    2665 </em></span>
    2666 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id312188"></a>
     2666        Samba's previous SSL support which was enabled by specifying the
     2667        <code class="literal">--with-ssl</code> option to the
     2668        <code class="filename">configure</code>
     2669        script.</p><p>LDAP connections should be secured where possible. This may be
     2670        done setting either this parameter to
     2671        <em class="parameter"><code>Start_tls</code></em>
     2672        or by specifying <em class="parameter"><code>ldaps://</code></em> in
     2673        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
     2674        two values:</p><div class="itemizedlist"><ul type="disc"><li><p><em class="parameter"><code>Off</code></em> = Never
     2675                        use SSL when querying the directory.</p></li><li><p><em class="parameter"><code>Start_tls</code></em> = Use
     2676                        the LDAPv3 StartTLS extended operation (RFC2830) for
     2677                        communicating with the directory server.</p></li></ul></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap ssl</code></em> = <code class="literal">no</code>
     2678</em></span>
     2679</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545697"></a>
    26672680
    26682681ldap suffix (G)
    2669 </h3></div></div></div><a class="indexterm" name="id312190"></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>
    2670         The ldap suffix will be appended to the values specified for the <a class="link" href="smb.conf.5.html#LDAPUSERSUFFIX">ldap user suffix</a>,
    2671          <a class="link" href="smb.conf.5.html#LDAPGROUPSUFFIX">ldap group suffix</a>, <a class="link" href="smb.conf.5.html#LDAPMACHINESUFFIX">ldap machine suffix</a>, and the
    2672          <a class="link" href="smb.conf.5.html#LDAPIDMAPSUFFIX">ldap idmap suffix</a>. Each of these should be given only a DN relative to the
    2673          <a class="link" href="smb.conf.5.html#LDAPSUFFIX">ldap suffix</a>.
     2682</h3></div></div></div><a class="indexterm" name="id2545698"></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>
     2683        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>,
     2684         <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
     2685         <a class="link" href="smb.conf.5.html#LDAPIDMAPSUFFIX" target="_top">ldap idmap suffix</a>. Each of these should be given only a DN relative to the
     2686         <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap suffix</a>.
    26742687        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap suffix</code></em> = <code class="literal"></code>
    26752688</em></span>
    26762689</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap suffix</code></em> = <code class="literal">dc=samba,dc=org</code>
    26772690</em></span>
    2678 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id312305"></a>
     2691</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545819"></a>
    26792692
    26802693ldap timeout (G)
    2681 </h3></div></div></div><a class="indexterm" name="id312306"></a><a name="LDAPTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2694</h3></div></div></div><a class="indexterm" name="id2545820"></a><a name="LDAPTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    26822695        When Samba connects to an ldap server that servermay be down or unreachable. To prevent Samba from hanging whilst
    26832696        waiting for the connection this parameter specifies in seconds how long Samba should wait before failing the
    … …  
    26852698        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap timeout</code></em> = <code class="literal">15</code>
    26862699</em></span>
    2687 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id312347"></a>
     2700</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545866"></a>
    26882701
    26892702ldap user suffix (G)
    2690 </h3></div></div></div><a class="indexterm" name="id312348"></a><a name="LDAPUSERSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2703</h3></div></div></div><a class="indexterm" name="id2545867"></a><a name="LDAPUSERSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
    26912704        This parameter specifies where users are added to the tree. If this parameter is unset,
    2692         the value of <a class="link" href="smb.conf.5.html#LDAPSUFFIX">ldap suffix</a> will be used instead.  The suffix
    2693         string is pre-pended to the  <a class="link" href="smb.conf.5.html#LDAPSUFFIX">ldap suffix</a> string so use a partial DN.
     2705        the value of <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap suffix</a> will be used instead.  The suffix
     2706        string is pre-pended to the  <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap suffix</a> string so use a partial DN.
    26942707        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap user suffix</code></em> = <code class="literal"></code>
    26952708</em></span>
    26962709</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap user suffix</code></em> = <code class="literal">ou=people</code>
    26972710</em></span>
    2698 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id312426"></a>
     2711</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545947"></a>
    26992712
    27002713level2 oplocks (S)
    2701 </h3></div></div></div><a class="indexterm" name="id312427"></a><a name="LEVEL2OPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether Samba supports
     2714</h3></div></div></div><a class="indexterm" name="id2545948"></a><a name="LEVEL2OPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether Samba supports
    27022715        level2 (read-only) oplocks on a share.</p><p>Level2, or read-only oplocks allow Windows NT clients
    27032716        that have an oplock on a file to downgrade from a read-write oplock
    … …  
    27132726        delete any read-ahead caches.</p><p>It is recommended that this parameter be turned on to
    27142727        speed access to shared executables.</p><p>For more discussions on level2 oplocks see the CIFS spec.</p><p>
    2715         Currently, if <a class="link" href="smb.conf.5.html#KERNELOPLOCKS">kernel oplocks</a> are supported then
     2728        Currently, if <a class="link" href="smb.conf.5.html#KERNELOPLOCKS" target="_top">kernel oplocks</a> are supported then
    27162729        level2 oplocks are not granted (even if this parameter is set to
    2717         <code class="constant">yes</code>).  Note also, the <a class="link" href="smb.conf.5.html#OPLOCKS">oplocks</a>
     2730        <code class="constant">yes</code>).  Note also, the <a class="link" href="smb.conf.5.html#OPLOCKS" target="_top">oplocks</a>
    27182731        parameter must be set to <code class="constant">yes</code> on this share in order for
    27192732        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>
    27202733</em></span>
    2721 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id312521"></a>
     2734</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546054"></a>
    27222735
    27232736lm announce (G)
    2724 </h3></div></div></div><a class="indexterm" name="id312522"></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
     2737</h3></div></div></div><a class="indexterm" name="id2546055"></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
    27252738        broadcasts that are needed by OS/2 clients in order for them to see
    27262739        the Samba server in their browse list. This parameter can have three
    … …  
    27302743        broadcasts. If set to <code class="constant">yes</code> Samba will produce
    27312744        Lanman announce broadcasts at a frequency set by the parameter
    2732         <a class="link" href="smb.conf.5.html#LMINTERVAL">lm interval</a>. If set to <code class="constant">auto</code>
     2745        <a class="link" href="smb.conf.5.html#LMINTERVAL" target="_top">lm interval</a>. If set to <code class="constant">auto</code>
    27332746        Samba will not send Lanman announce broadcasts by default but will
    27342747        listen for them. If it hears such a broadcast on the wire it will
    27352748        then start sending them at a frequency set by the parameter
    2736         <a class="link" href="smb.conf.5.html#LMINTERVAL">lm interval</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>lm announce</code></em> = <code class="literal">auto</code>
     2749        <a class="link" href="smb.conf.5.html#LMINTERVAL" target="_top">lm interval</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>lm announce</code></em> = <code class="literal">auto</code>
    27372750</em></span>
    27382751</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lm announce</code></em> = <code class="literal">yes</code>
    27392752</em></span>
    2740 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id312636"></a>
     2753</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546176"></a>
    27412754
    27422755lm interval (G)
    2743 </h3></div></div></div><a class="indexterm" name="id312638"></a><a name="LMINTERVAL"></a><div class="variablelist"><dl><dt></dt><dd><p>If Samba is set to produce Lanman announce
     2756</h3></div></div></div><a class="indexterm" name="id2546177"></a><a name="LMINTERVAL"></a><div class="variablelist"><dl><dt></dt><dd><p>If Samba is set to produce Lanman announce
    27442757        broadcasts needed by OS/2 clients (see the
    2745                 <a class="link" href="smb.conf.5.html#LMANNOUNCE">lm announce</a> parameter) then this
     2758                <a class="link" href="smb.conf.5.html#LMANNOUNCE" target="_top">lm announce</a> parameter) then this
    27462759        parameter defines the frequency in seconds with which they will be
    27472760        made.  If this is set to zero then no Lanman announcements will be
    2748         made despite the setting of the <a class="link" href="smb.conf.5.html#LMANNOUNCE">lm announce</a>
     2761        made despite the setting of the <a class="link" href="smb.conf.5.html#LMANNOUNCE" target="_top">lm announce</a>
    27492762        parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>lm interval</code></em> = <code class="literal">60</code>
    27502763</em></span>
    27512764</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lm interval</code></em> = <code class="literal">120</code>
    27522765</em></span>
    2753 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id312717"></a>
     2766</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546261"></a>
    27542767
    27552768load printers (G)
    2756 </h3></div></div></div><a class="indexterm" name="id312718"></a><a name="LOADPRINTERS"></a><div class="variablelist"><dl><dt></dt><dd><p>A boolean variable that controls whether all
     2769</h3></div></div></div><a class="indexterm" name="id2546262"></a><a name="LOADPRINTERS"></a><div class="variablelist"><dl><dt></dt><dd><p>A boolean variable that controls whether all
    27572770    printers in the printcap will be loaded for browsing by default.
    2758     See the <a class="link" href="smb.conf.5.html#PRINTERS">printers</a> section for
     2771    See the <a class="link" href="smb.conf.5.html#PRINTERS" target="_top">printers</a> section for
    27592772    more details.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>load printers</code></em> = <code class="literal">yes</code>
    27602773</em></span>
    2761 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id312770"></a>
     2774</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546317"></a>
    27622775
    27632776local master (G)
    2764 </h3></div></div></div><a class="indexterm" name="id312772"></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
     2777</h3></div></div></div><a class="indexterm" name="id2546318"></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
    27652778        on a subnet. If set to <code class="constant">no</code> then <code class="literal">
    27662779        nmbd</code> will not attempt to become a local master browser
    … …  
    27722785master browser.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>local master</code></em> = <code class="literal">yes</code>
    27732786</em></span>
    2774 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id312867"></a>
     2787</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546417"></a>
    27752788
    27762789<a name="LOCKDIR"></a>lock dir
    2777 </h3></div></div></div><a class="indexterm" name="id312868"></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="id312898"></a>
     2790</h3></div></div></div><a class="indexterm" name="id2546418"></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="id2546449"></a>
    27782791
    27792792lock directory (G)
    2780 </h3></div></div></div><a class="indexterm" name="id312899"></a><a name="LOCKDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the directory where lock
     2793</h3></div></div></div><a class="indexterm" name="id2546450"></a><a name="LOCKDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the directory where lock
    27812794        files will be placed.  The lock files are used to implement the
    2782         <a class="link" href="smb.conf.5.html#MAXCONNECTIONS">max connections</a> option.
     2795        <a class="link" href="smb.conf.5.html#MAXCONNECTIONS" target="_top">max connections</a> option.
    27832796        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>lock directory</code></em> = <code class="literal">${prefix}/var/locks</code>
    27842797</em></span>
    27852798</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lock directory</code></em> = <code class="literal">/var/run/samba/locks</code>
    27862799</em></span>
    2787 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id312969"></a>
     2800</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546523"></a>
    27882801
    27892802locking (S)
    2790 </h3></div></div></div><a class="indexterm" name="id312970"></a><a name="LOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether or not locking will be
     2803</h3></div></div></div><a class="indexterm" name="id2546524"></a><a name="LOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether or not locking will be
    27912804        performed by the server in response to lock requests from the
    27922805        client.</p><p>If <code class="literal">locking = no</code>, all lock and unlock
    … …  
    27982811        is not really recommended even in this case.</p><p>Be careful about disabling locking either globally or in a
    27992812        specific service, as lack of locking may result in data corruption.
    2800         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="id313038"></a>
     2813        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="id2546598"></a>
    28012814
    28022815lock spin count (G)
    2803 </h3></div></div></div><a class="indexterm" name="id313039"></a><a name="LOCKSPINCOUNT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter has been made inoperative in Samba 3.0.24.
     2816</h3></div></div></div><a class="indexterm" name="id2546599"></a><a name="LOCKSPINCOUNT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter has been made inoperative in Samba 3.0.24.
    28042817        The functionality it contolled is now controlled by the parameter
    2805         <a class="link" href="smb.conf.5.html#LOCKSPINTIME">lock spin time</a>.
     2818        <a class="link" href="smb.conf.5.html#LOCKSPINTIME" target="_top">lock spin time</a>.
    28062819        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>lock spin count</code></em> = <code class="literal">0</code>
    28072820</em></span>
    2808 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id313091"></a>
     2821</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546654"></a>
    28092822
    28102823lock spin time (G)
    2811 </h3></div></div></div><a class="indexterm" name="id313092"></a><a name="LOCKSPINTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The time in microseconds that smbd should
     2824</h3></div></div></div><a class="indexterm" name="id2546655"></a><a name="LOCKSPINTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The time in microseconds that smbd should
    28122825        keep waiting to see if a failed lock request can
    28132826        be granted. This parameter has changed in default
    28142827        value from Samba 3.0.23 from 10 to 200. The associated
    2815         <a class="link" href="smb.conf.5.html#LOCKSPINCOUNT">lock spin count</a> parameter is
     2828        <a class="link" href="smb.conf.5.html#LOCKSPINCOUNT" target="_top">lock spin count</a> parameter is
    28162829        no longer used in Samba 3.0.24. You should not need
    28172830        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>
    28182831</em></span>
    2819 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id313145"></a>
     2832</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546712"></a>
    28202833
    28212834log file (G)
    2822 </h3></div></div></div><a class="indexterm" name="id313146"></a><a name="LOGFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2835</h3></div></div></div><a class="indexterm" name="id2546713"></a><a name="LOGFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    28232836    This option allows you to override the name of the Samba log file (also known as the debug file).
    28242837    </p><p>
    … …  
    28262839    </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>
    28272840</em></span>
    2828 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id313195"></a>
     2841</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546764"></a>
    28292842
    28302843<a name="DEBUGLEVEL"></a>debuglevel
    2831 </h3></div></div></div><a class="indexterm" name="id313196"></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="id313226"></a>
     2844</h3></div></div></div><a class="indexterm" name="id2546766"></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="id2546796"></a>
    28322845
    28332846log level (G)
    2834 </h3></div></div></div><a class="indexterm" name="id313227"></a><a name="LOGLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2847</h3></div></div></div><a class="indexterm" name="id2546797"></a><a name="LOGLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    28352848    The value of the parameter (a astring) allows the debug level (logging level) to be specified in the
    28362849    <code class="filename">smb.conf</code> file.
    … …  
    28432856</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>
    28442857</em></span>
    2845 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id313455"></a>
     2858</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547030"></a>
    28462859
    28472860logon drive (G)
    2848 </h3></div></div></div><a class="indexterm" name="id313456"></a><a name="LOGONDRIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2861</h3></div></div></div><a class="indexterm" name="id2547031"></a><a name="LOGONDRIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    28492862        This parameter specifies the local path to which the home directory will be
    2850         connected (see <a class="link" href="smb.conf.5.html#LOGONHOME">logon home</a>) and is only used by NT
     2863        connected (see <a class="link" href="smb.conf.5.html#LOGONHOME" target="_top">logon home</a>) and is only used by NT
    28512864        Workstations.
    28522865        </p><p>
    … …  
    28562869</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>logon drive</code></em> = <code class="literal">h:</code>
    28572870</em></span>
    2858 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id313527"></a>
     2871</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547104"></a>
    28592872
    28602873logon home (G)
    2861 </h3></div></div></div><a class="indexterm" name="id313528"></a><a name="LOGONHOME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2874</h3></div></div></div><a class="indexterm" name="id2547105"></a><a name="LOGONHOME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    28622875        This parameter specifies the home directory location when a Win95/98 or NT Workstation logs into a Samba PDC. 
    28632876        It allows you to do
    … …  
    28782891         <code class="literal">net use /home</code> but use the whole string when dealing with profiles.
    28792892        </p><p>
    2880         Note that in prior versions of Samba, the <a class="link" href="smb.conf.5.html#LOGONPATH">logon path</a> was returned rather than
     2893        Note that in prior versions of Samba, the <a class="link" href="smb.conf.5.html#LOGONPATH" target="_top">logon path</a> was returned rather than
    28812894        <em class="parameter"><code>logon home</code></em>.  This broke <code class="literal">net use /home</code>
    28822895        but allowed profiles outside the home directory. The current implementation is correct, and can be used for
    28832896        profiles if you use the above trick.
    28842897        </p><p>
    2885         Disable this feature by setting <a class="link" href="smb.conf.5.html#LOGONHOME">logon home = ""</a> - using the empty string.
     2898        Disable this feature by setting <a class="link" href="smb.conf.5.html#LOGONHOME" target="_top">logon home = ""</a> - using the empty string.
    28862899        </p><p>
    28872900        This option is only useful if Samba is set up as a logon server.
    … …  
    28902903</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>logon home</code></em> = <code class="literal">\\remote_smb_server\%U</code>
    28912904</em></span>
    2892 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id313680"></a>
     2905</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547269"></a>
    28932906
    28942907logon path (G)
    2895 </h3></div></div></div><a class="indexterm" name="id313681"></a><a name="LOGONPATH"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2908</h3></div></div></div><a class="indexterm" name="id2547270"></a><a name="LOGONPATH"></a><div class="variablelist"><dl><dt></dt><dd><p>
    28962909        This parameter specifies the directory where roaming profiles (Desktop, NTuser.dat, etc) are
    28972910        stored.  Contrary to previous versions of these manual pages, it has nothing to do with Win 9X roaming
    28982911        profiles.  To find out how to handle roaming profiles for Win 9X system, see the
    2899         <a class="link" href="smb.conf.5.html#LOGONHOME">logon home</a> parameter.
     2912        <a class="link" href="smb.conf.5.html#LOGONHOME" target="_top">logon home</a> parameter.
    29002913        </p><p>
    29012914        This option takes the standard substitutions, allowing you to have separate logon scripts for each user or
    … …  
    29262939        </p></div><p>Note that this option is only useful if Samba is set up as a domain controller.</p><p>
    29272940        Disable the use of roaming profiles by setting the value of this parameter to the empty string. For
    2928         example, <a class="link" href="smb.conf.5.html#LOGONPATH">logon path = ""</a>. Take note that even if the default setting
     2941        example, <a class="link" href="smb.conf.5.html#LOGONPATH" target="_top">logon path = ""</a>. Take note that even if the default setting
    29292942        in the smb.conf file is the empty string, any value specified in the user account settings in the passdb
    29302943        backend will over-ride the effect of setting this parameter to null. Disabling of all roaming profile use
    … …  
    29372950        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>logon path</code></em> = <code class="literal">\\%N\%U\profile</code>
    29382951</em></span>
    2939 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id313826"></a>
     2952</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547437"></a>
    29402953
    29412954logon script (G)
    2942 </h3></div></div></div><a class="indexterm" name="id313827"></a><a name="LOGONSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2955</h3></div></div></div><a class="indexterm" name="id2547438"></a><a name="LOGONSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    29432956        This parameter specifies the batch file (<code class="filename">.bat</code>) or NT command file
    29442957        (<code class="filename">.cmd</code>) to be downloaded and run on a machine when a user successfully logs in.  The file
    … …  
    29462959        </p><p>
    29472960        The script must be a relative path to the <em class="parameter"><code>[netlogon]</code></em> service.  If the [netlogon]
    2948         service specifies a <a class="link" href="smb.conf.5.html#PATH">path</a> of <code class="filename">/usr/local/samba/netlogon</code>, and <a class="link" href="smb.conf.5.html#LOGONSCRIPT">logon  script = STARTUP.BAT</a>, then the file that will be downloaded is:
     2961        service specifies a <a class="link" href="smb.conf.5.html#PATH" target="_top">path</a> of <code class="filename">/usr/local/samba/netlogon</code>, and <a class="link" href="smb.conf.5.html#LOGONSCRIPT" target="_top">logon  script = STARTUP.BAT</a>, then the file that will be downloaded is:
    29492962</p><pre class="programlisting">
    29502963        /usr/local/samba/netlogon/STARTUP.BAT
    … …  
    29712984</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>logon script</code></em> = <code class="literal">scripts\%U.bat</code>
    29722985</em></span>
    2973 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id313983"></a>
     2986</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547607"></a>
    29742987
    29752988lppause command (S)
    2976 </h3></div></div></div><a class="indexterm" name="id313984"></a><a name="LPPAUSECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     2989</h3></div></div></div><a class="indexterm" name="id2547608"></a><a name="LPPAUSECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    29772990    executed on the server host in order to stop printing or spooling
    29782991    a specific print job.</p><p>This command should be a program or script which takes
    … …  
    29893002    in the lppause command as the PATH may not be available to the server.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>lppause command</code></em> = <code class="literal">
    29903003# Currently no default value is given to
    2991     this string, unless the value of the <a class="link" href="smb.conf.5.html#PRINTING">printing</a>
     3004    this string, unless the value of the <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing</a>
    29923005    parameter is <code class="constant">SYSV</code>, in which case the default is :
    29933006    <code class="literal">lp -i %p-%j -H hold</code> or if the value of the
    … …  
    29983011</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>
    29993012</em></span>
    3000 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id314119"></a>
     3013</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547755"></a>
    30013014
    30023015lpq cache time (G)
    3003 </h3></div></div></div><a class="indexterm" name="id314120"></a><a name="LPQCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls how long lpq info will be cached
     3016</h3></div></div></div><a class="indexterm" name="id2547756"></a><a name="LPQCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls how long lpq info will be cached
    30043017        for to prevent the <code class="literal">lpq</code> command being called too
    30053018        often. A separate cache is kept for each variation of the <code class="literal">
    … …  
    30143027</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lpq cache time</code></em> = <code class="literal">10</code>
    30153028</em></span>
    3016 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id314232"></a>
     3029</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547874"></a>
    30173030
    30183031lpq command (S)
    3019 </h3></div></div></div><a class="indexterm" name="id314233"></a><a name="LPQCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     3032</h3></div></div></div><a class="indexterm" name="id2547875"></a><a name="LPQCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    30203033    executed on the server host in order to obtain <code class="literal">lpq
    30213034    </code>-style printer status information.</p><p>This command should be a program or script which
    … …  
    30393052</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lpq command</code></em> = <code class="literal">/usr/bin/lpq -P%p</code>
    30403053</em></span>
    3041 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id314348"></a>
     3054</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548000"></a>
    30423055
    30433056lpresume command (S)
    3044 </h3></div></div></div><a class="indexterm" name="id314349"></a><a name="LPRESUMECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     3057</h3></div></div></div><a class="indexterm" name="id2548002"></a><a name="LPRESUMECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    30453058    executed on the server host in order to restart or continue
    30463059    printing or spooling a specific print job.</p><p>This command should be a program or script which takes
    30473060    a printer name and job number to resume the print job. See
    3048     also the <a class="link" href="smb.conf.5.html#LPPAUSECOMMAND">lppause command</a> parameter.</p><p>If a <em class="parameter"><code>%p</code></em> is given then the printer name
     3061    also the <a class="link" href="smb.conf.5.html#LPPAUSECOMMAND" target="_top">lppause command</a> parameter.</p><p>If a <em class="parameter"><code>%p</code></em> is given then the printer name
    30493062    is put in its place. A <em class="parameter"><code>%j</code></em> is replaced with
    30503063    the job number (an integer).</p><p>Note that it is good practice to include the absolute path
    30513064    in the <em class="parameter"><code>lpresume command</code></em> as the PATH may not
    3052     be available to the server.</p><p>See also the <a class="link" href="smb.conf.5.html#PRINTING">printing</a> parameter.</p><p>Default: Currently no default value is given
     3065    be available to the server.</p><p>See also the <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing</a> parameter.</p><p>Default: Currently no default value is given
    30533066    to this string, unless the value of the <em class="parameter"><code>printing</code></em>
    30543067    parameter is <code class="constant">SYSV</code>, in which case the default is:</p><p><code class="literal">lp -i %p-%j -H resume</code></p><p>or if the value of the <em class="parameter"><code>printing</code></em> parameter
    30553068    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>
    30563069</em></span>
    3057 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id314491"></a>
     3070</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548154"></a>
    30583071
    30593072lprm command (S)
    3060 </h3></div></div></div><a class="indexterm" name="id314492"></a><a name="LPRMCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     3073</h3></div></div></div><a class="indexterm" name="id2548155"></a><a name="LPRMCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    30613074    executed on the server host in order to delete a print job.</p><p>This command should be a program or script which takes
    30623075    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
    … …  
    30753088        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>lprm command</code></em> = <code class="literal"> determined by printing parameter</code>
    30763089</em></span>
    3077 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id314572"></a>
     3090</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548241"></a>
    30783091
    30793092machine password timeout (G)
    3080 </h3></div></div></div><a class="indexterm" name="id314573"></a><a name="MACHINEPASSWORDTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    3081         If a Samba server is a member of a Windows NT Domain (see the <a class="link" href="smb.conf.5.html#SECURITY">security = domain</a> parameter) then periodically a running smbd process will try and change
     3093</h3></div></div></div><a class="indexterm" name="id2548242"></a><a name="MACHINEPASSWORDTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3094        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
    30823095        the MACHINE ACCOUNT PASSWORD stored in the TDB called <code class="filename">private/secrets.tdb
    30833096        </code>.  This parameter specifies how often this password will be changed, in seconds. The default is one
    … …  
    30853098        </p><p>
    30863099        See also <a class="citerefentry" href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a>,
    3087         and the <a class="link" href="smb.conf.5.html#SECURITY">security = domain</a> parameter.
     3100        and the <a class="link" href="smb.conf.5.html#SECURITY" target="_top">security = domain</a> parameter.
    30883101        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>machine password timeout</code></em> = <code class="literal">604800</code>
    30893102</em></span>
    3090 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id314654"></a>
     3103</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548329"></a>
    30913104
    30923105magic output (S)
    3093 </h3></div></div></div><a class="indexterm" name="id314656"></a><a name="MAGICOUTPUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3106</h3></div></div></div><a class="indexterm" name="id2548330"></a><a name="MAGICOUTPUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    30943107        This parameter specifies the name of a file which will contain output created by a magic script (see the
    3095         <a class="link" href="smb.conf.5.html#MAGICSCRIPT">magic script</a> parameter below).
     3108        <a class="link" href="smb.conf.5.html#MAGICSCRIPT" target="_top">magic script</a> parameter below).
    30963109        </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
    30973110        </code></em> in the same directory the output file content is undefined.
    … …  
    31003113</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>magic output</code></em> = <code class="literal">myfile.txt</code>
    31013114</em></span>
    3102 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id314735"></a>
     3115</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548413"></a>
    31033116
    31043117magic script (S)
    3105 </h3></div></div></div><a class="indexterm" name="id314736"></a><a name="MAGICSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the name of a file which,
     3118</h3></div></div></div><a class="indexterm" name="id2548414"></a><a name="MAGICSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the name of a file which,
    31063119        if opened, will be executed by the server when the file is closed.
    31073120        This allows a UNIX script to be sent to the Samba host and
    … …  
    31093122        completion assuming that the user has the appropriate level
    31103123        of privilege and the file permissions allow the deletion.</p><p>If the script generates output, output will be sent to
    3111         the file specified by the <a class="link" href="smb.conf.5.html#MAGICOUTPUT">magic output</a>
     3124        the file specified by the <a class="link" href="smb.conf.5.html#MAGICOUTPUT" target="_top">magic output</a>
    31123125        parameter (see above).</p><p>Note that some shells are unable to interpret scripts
    31133126        containing CR/LF instead of CR as
    … …  
    31193132</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>magic script</code></em> = <code class="literal">user.csh</code>
    31203133</em></span>
    3121 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id314833"></a>
     3134</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548518"></a>
    31223135
    31233136mangled map (S)
    3124 </h3></div></div></div><a class="indexterm" name="id314834"></a><a name="MANGLEDMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3137</h3></div></div></div><a class="indexterm" name="id2548519"></a><a name="MANGLEDMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    31253138        This is for those who want to directly map UNIX file names which cannot be represented on
    31263139        Windows/DOS.  The mangling of names is not always what is needed.  In particular you may have
    … …  
    31333146        you would use:
    31343147        </p><p>
    3135         <a class="link" href="smb.conf.5.html#MANGLEDMAP">mangled map = (*.html *.htm)</a>.
     3148        <a class="link" href="smb.conf.5.html#MANGLEDMAP" target="_top">mangled map = (*.html *.htm)</a>.
    31363149        </p><p>
    31373150        One very useful case is to remove the annoying <code class="filename">;1</code> off
    … …  
    31433156</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>mangled map</code></em> = <code class="literal">(*;1 *;)</code>
    31443157</em></span>
    3145 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id314944"></a>
     3158</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548637"></a>
    31463159
    31473160mangled names (S)
    3148 </h3></div></div></div><a class="indexterm" name="id314946"></a><a name="MANGLEDNAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether non-DOS names under UNIX
     3161</h3></div></div></div><a class="indexterm" name="id2548638"></a><a name="MANGLEDNAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether non-DOS names under UNIX
    31493162        should be mapped to DOS-compatible names ("mangled") and made visible,
    3150         or whether non-DOS names should simply be ignored.</p><p>See the section on <a class="link" href="smb.conf.5.html#NAMEMANGLING">name mangling</a> for
     3163        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
    31513164        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
    31523165                        before the rightmost dot of the filename are preserved, forced
    … …  
    31583171                        only if it contains any upper case characters or is longer than three
    31593172                        characters.</p><p>Note that the character to use may be specified using
    3160                                 the <a class="link" href="smb.conf.5.html#MANGLINGCHAR">mangling char</a>
     3173                                the <a class="link" href="smb.conf.5.html#MANGLINGCHAR" target="_top">mangling char</a>
    31613174                        option, if you don't like '~'.</p></li><li><p>Files whose UNIX name begins with a dot will be
    31623175                        presented as DOS hidden files. The mangled name will be created as
    … …  
    31713184        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>
    31723185</em></span>
    3173 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id315066"></a>
     3186</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548774"></a>
    31743187
    31753188mangle prefix (G)
    3176 </h3></div></div></div><a class="indexterm" name="id315067"></a><a name="MANGLEPREFIX"></a><div class="variablelist"><dl><dt></dt><dd><p> controls the number of prefix
     3189</h3></div></div></div><a class="indexterm" name="id2548775"></a><a name="MANGLEPREFIX"></a><div class="variablelist"><dl><dt></dt><dd><p> controls the number of prefix
    31773190        characters from the original name used when generating
    31783191        the mangled names. A larger value will give a weaker
    … …  
    31843197</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>mangle prefix</code></em> = <code class="literal">4</code>
    31853198</em></span>
    3186 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id315129"></a>
     3199</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548841"></a>
    31873200
    31883201mangling char (S)
    3189 </h3></div></div></div><a class="indexterm" name="id315130"></a><a name="MANGLINGCHAR"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what character is used as
    3190         the <span class="emphasis"><em>magic</em></span> character in <a class="link" href="smb.conf.5.html#NAMEMANGLING">name mangling</a>. The
     3202</h3></div></div></div><a class="indexterm" name="id2548842"></a><a name="MANGLINGCHAR"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what character is used as
     3203        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
    31913204        default is a '~' but this may interfere with some software. Use this option to set
    31923205        it to whatever you prefer. This is effective only when mangling method is hash.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>mangling char</code></em> = <code class="literal">~</code>
    … …  
    31943207</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>mangling char</code></em> = <code class="literal">^</code>
    31953208</em></span>
    3196 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id315203"></a>
     3209</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548918"></a>
    31973210
    31983211mangling method (G)
    3199 </h3></div></div></div><a class="indexterm" name="id315204"></a><a name="MANGLINGMETHOD"></a><div class="variablelist"><dl><dt></dt><dd><p> controls the algorithm used for the generating
     3212</h3></div></div></div><a class="indexterm" name="id2548919"></a><a name="MANGLINGMETHOD"></a><div class="variablelist"><dl><dt></dt><dd><p> controls the algorithm used for the generating
    32003213        the mangled names. Can take two different values, "hash" and
    32013214        "hash2". "hash" is the algorithm that was used
    … …  
    32083221</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>mangling method</code></em> = <code class="literal">hash</code>
    32093222</em></span>
    3210 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id315264"></a>
     3223</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548986"></a>
    32113224
    32123225map acl inherit (S)
    3213 </h3></div></div></div><a class="indexterm" name="id315265"></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'
     3226</h3></div></div></div><a class="indexterm" name="id2548987"></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'
    32143227    access control entry flags stored in Windows ACLs into an extended attribute
    32153228    called user.SAMBA_PAI. This parameter only takes effect if Samba is being run
    … …  
    32193232    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>map acl inherit</code></em> = <code class="literal">no</code>
    32203233</em></span>
    3221 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id315317"></a>
     3234</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549049"></a>
    32223235
    32233236map archive (S)
    3224 </h3></div></div></div><a class="indexterm" name="id315318"></a><a name="MAPARCHIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3237</h3></div></div></div><a class="indexterm" name="id2549050"></a><a name="MAPARCHIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    32253238        This controls whether the DOS archive attribute
    32263239        should be mapped to the UNIX owner execute bit.  The DOS archive bit
    … …  
    32303243        be quite annoying for shared source code, documents, etc...
    32313244        </p><p>
    3232         Note that this requires the <a class="link" href="smb.conf.5.html#CREATEMASK">create mask</a>   parameter to be set such that owner
     3245        Note that this requires the <a class="link" href="smb.conf.5.html#CREATEMASK" target="_top">create mask</a>     parameter to be set such that owner
    32333246        execute bit is not masked out (i.e. it must include 100). See the parameter
    3234         <a class="link" href="smb.conf.5.html#CREATEMASK">create mask</a> for details.
     3247        <a class="link" href="smb.conf.5.html#CREATEMASK" target="_top">create mask</a> for details.
    32353248        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>map archive</code></em> = <code class="literal">yes</code>
    32363249</em></span>
    3237 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id315386"></a>
     3250</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549125"></a>
    32383251
    32393252map hidden (S)
    3240 </h3></div></div></div><a class="indexterm" name="id315387"></a><a name="MAPHIDDEN"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3253</h3></div></div></div><a class="indexterm" name="id2549126"></a><a name="MAPHIDDEN"></a><div class="variablelist"><dl><dt></dt><dd><p>
    32413254        This controls whether DOS style hidden files should be mapped to the UNIX world execute bit.
    32423255        </p><p>
    3243         Note that this requires the <a class="link" href="smb.conf.5.html#CREATEMASK">create mask</a> to be set such that the world execute
    3244         bit is not masked out (i.e. it must include 001). See the parameter <a class="link" href="smb.conf.5.html#CREATEMASK">create mask</a>
     3256        Note that this requires the <a class="link" href="smb.conf.5.html#CREATEMASK" target="_top">create mask</a> to be set such that the world execute
     3257        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>
    32453258        for details.
    3246         </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="id315440"></a>
     3259        </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="id2549182"></a>
    32473260
    32483261map read only (S)
    3249 </h3></div></div></div><a class="indexterm" name="id315441"></a><a name="MAPREADONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3262</h3></div></div></div><a class="indexterm" name="id2549183"></a><a name="MAPREADONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    32503263        This controls how the DOS read only attribute should be mapped from a UNIX filesystem.
    32513264        </p><p>
    32523265        This parameter can take three different values, which tell <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> how to display the read only attribute on files, where either
    3253         <a class="link" href="smb.conf.5.html#STOREDOSATTRIBUTES">store dos attributes</a> is set to <code class="constant">No</code>, or no extended attribute is
    3254         present. If <a class="link" href="smb.conf.5.html#STOREDOSATTRIBUTES">store dos attributes</a> is set to <code class="constant">yes</code> then this
     3266        <a class="link" href="smb.conf.5.html#STOREDOSATTRIBUTES" target="_top">store dos attributes</a> is set to <code class="constant">No</code>, or no extended attribute is
     3267        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
    32553268        parameter is <span class="emphasis"><em>ignored</em></span>. This is a new parameter introduced in Samba version 3.0.21.
    32563269        </p><p>The three settings are :</p><div class="itemizedlist"><ul type="disc"><li><p>
    … …  
    32653278                </p></li><li><p>
    32663279                <code class="constant">No</code> - The read only DOS attribute is unaffected by permissions, and can only be set by
    3267                 the <a class="link" href="smb.conf.5.html#STOREDOSATTRIBUTES">store dos attributes</a> method. This may be useful for exporting mounted CDs.
     3280                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.
    32683281                </p></li></ul></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>map read only</code></em> = <code class="literal">yes</code>
    32693282</em></span>
    3270 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id315581"></a>
     3283</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549335"></a>
    32713284
    32723285map system (S)
    3273 </h3></div></div></div><a class="indexterm" name="id315582"></a><a name="MAPSYSTEM"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3286</h3></div></div></div><a class="indexterm" name="id2549336"></a><a name="MAPSYSTEM"></a><div class="variablelist"><dl><dt></dt><dd><p>
    32743287        This controls whether DOS style system files should be mapped to the UNIX group execute bit.
    32753288        </p><p>
    3276         Note that this requires the <a class="link" href="smb.conf.5.html#CREATEMASK">create mask</a>   to be set such that the group
     3289        Note that this requires the <a class="link" href="smb.conf.5.html#CREATEMASK" target="_top">create mask</a>     to be set such that the group
    32773290        execute bit is not masked out (i.e. it must include 010). See the parameter
    3278         <a class="link" href="smb.conf.5.html#CREATEMASK">create mask</a> for details.
     3291        <a class="link" href="smb.conf.5.html#CREATEMASK" target="_top">create mask</a> for details.
    32793292        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>map system</code></em> = <code class="literal">no</code>
    32803293</em></span>
    3281 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id315647"></a>
     3294</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549404"></a>
    32823295
    32833296map to guest (G)
    3284 </h3></div></div></div><a class="indexterm" name="id315648"></a><a name="MAPTOGUEST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only useful in <a class="link" href="smb.conf.5.html#SECURITY">SECURITY =
     3297</h3></div></div></div><a class="indexterm" name="id2549405"></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 =
    32853298    security</a> modes other than <em class="parameter"><code>security = share</code></em>
    32863299    and <em class="parameter"><code>security = server</code></em>
    … …  
    32923305            logins with an invalid password are rejected, unless the username
    32933306            does not exist, in which case it is treated as a guest login and
    3294             mapped into the <a class="link" href="smb.conf.5.html#GUESTACCOUNT">guest account</a>.</p></li><li><p><code class="constant">Bad Password</code> - Means user logins
     3307            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
    32953308            with an invalid password are treated as a guest login and mapped
    3296             into the <a class="link" href="smb.conf.5.html#GUESTACCOUNT">guest account</a>. Note that
     3309            into the <a class="link" href="smb.conf.5.html#GUESTACCOUNT" target="_top">guest account</a>. Note that
    32973310            this can cause problems as it means that any user incorrectly typing
    32983311            their password will be silently logged on as "guest" - and
    … …  
    33243337</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>map to guest</code></em> = <code class="literal">Bad User</code>
    33253338</em></span>
    3326 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id315863"></a>
     3339</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549644"></a>
    33273340
    33283341max connections (S)
    3329 </h3></div></div></div><a class="indexterm" name="id315864"></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.
     3342</h3></div></div></div><a class="indexterm" name="id2549645"></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.
    33303343    If <em class="parameter"><code>max connections</code></em> is greater than 0 then connections
    33313344    will be refused if this number of connections to the service are already open. A value
    33323345    of zero mean an unlimited number of connections may be made.</p><p>Record lock files are used to implement this feature. The lock files will be stored in
    3333     the directory specified by the <a class="link" href="smb.conf.5.html#LOCKDIRECTORY">lock directory</a> option.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>max connections</code></em> = <code class="literal">0</code>
     3346    the directory specified by the <a class="link" href="smb.conf.5.html#LOCKDIRECTORY" target="_top">lock directory</a> option.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>max connections</code></em> = <code class="literal">0</code>
    33343347</em></span>
    33353348</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max connections</code></em> = <code class="literal">10</code>
    33363349</em></span>
    3337 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id315944"></a>
     3350</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549730"></a>
    33383351
    33393352max disk size (G)
    3340 </h3></div></div></div><a class="indexterm" name="id315945"></a><a name="MAXDISKSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to put an upper limit
     3353</h3></div></div></div><a class="indexterm" name="id2549731"></a><a name="MAXDISKSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to put an upper limit
    33413354    on the apparent size of disks. If you set this option to 100
    33423355    then all shares will appear to be not larger than 100 MB in
    … …  
    33523365</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max disk size</code></em> = <code class="literal">1000</code>
    33533366</em></span>
    3354 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id316029"></a>
     3367</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549822"></a>
    33553368
    33563369max log size (G)
    3357 </h3></div></div></div><a class="indexterm" name="id316030"></a><a name="MAXLOGSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3370</h3></div></div></div><a class="indexterm" name="id2549823"></a><a name="MAXLOGSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    33583371    This option (an integer in kilobytes) specifies the max size the log file should grow to.
    33593372    Samba periodically checks the size and if it is exceeded it will rename the file, adding
    … …  
    33643377</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max log size</code></em> = <code class="literal">1000</code>
    33653378</em></span>
    3366 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id316097"></a>
     3379</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549893"></a>
    33673380
    33683381max mux (G)
    3369 </h3></div></div></div><a class="indexterm" name="id316098"></a><a name="MAXMUX"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum number of
     3382</h3></div></div></div><a class="indexterm" name="id2549894"></a><a name="MAXMUX"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum number of
    33703383    outstanding simultaneous SMB operations that Samba tells the client
    33713384        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>
    33723385</em></span>
    3373 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id316139"></a>
     3386</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549936"></a>
    33743387
    33753388max open files (G)
    3376 </h3></div></div></div><a class="indexterm" name="id316140"></a><a name="MAXOPENFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of
     3389</h3></div></div></div><a class="indexterm" name="id2549937"></a><a name="MAXOPENFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of
    33773390    open files that one <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> file
    33783391    serving process may have open for a client at any one time. The
    … …  
    33823395    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>
    33833396</em></span>
    3384 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id316194"></a>
     3397</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549996"></a>
    33853398
    33863399max print jobs (S)
    3387 </h3></div></div></div><a class="indexterm" name="id316195"></a><a name="MAXPRINTJOBS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of
     3400</h3></div></div></div><a class="indexterm" name="id2549997"></a><a name="MAXPRINTJOBS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of
    33883401    jobs allowable in a Samba printer queue at any given moment.
    33893402    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.
    … …  
    33923405</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max print jobs</code></em> = <code class="literal">5000</code>
    33933406</em></span>
    3394 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id316262"></a>
     3407</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550066"></a>
    33953408
    33963409<a name="PROTOCOL"></a>protocol
    3397 </h3></div></div></div><a class="indexterm" name="id316263"></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="id316293"></a>
     3410</h3></div></div></div><a class="indexterm" name="id2550068"></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="id2550099"></a>
    33983411
    33993412max protocol (G)
    3400 </h3></div></div></div><a class="indexterm" name="id316294"></a><a name="MAXPROTOCOL"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a string) is the highest
     3413</h3></div></div></div><a class="indexterm" name="id2550100"></a><a name="MAXPROTOCOL"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a string) is the highest
    34013414    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
    34023415            concept of user names.</p></li><li><p><code class="constant">COREPLUS</code>: Slight improvements on
    … …  
    34103423</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max protocol</code></em> = <code class="literal">LANMAN1</code>
    34113424</em></span>
    3412 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id316413"></a>
     3425</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550224"></a>
    34133426
    34143427max reported print jobs (S)
    3415 </h3></div></div></div><a class="indexterm" name="id316414"></a><a name="MAXREPORTEDPRINTJOBS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3428</h3></div></div></div><a class="indexterm" name="id2550226"></a><a name="MAXREPORTEDPRINTJOBS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    34163429    This parameter limits the maximum number of jobs displayed in a port monitor for
    34173430    Samba printer queue at any given moment. If this number is exceeded, the excess
    … …  
    34223435</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max reported print jobs</code></em> = <code class="literal">1000</code>
    34233436</em></span>
    3424 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id316472"></a>
     3437</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550288"></a>
    34253438
    34263439max smbd processes (G)
    3427 </h3></div></div></div><a class="indexterm" name="id316473"></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
     3440</h3></div></div></div><a class="indexterm" name="id2550290"></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
    34283441    as a stopgap to prevent degrading service to clients in the event that the server has insufficient
    34293442    resources to handle more than this number of connections.  Remember that under normal operating
    … …  
    34333446</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max smbd processes</code></em> = <code class="literal">1000</code>
    34343447</em></span>
    3435 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id316549"></a>
     3448</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550370"></a>
    34363449
    34373450max stat cache size (G)
    3438 </h3></div></div></div><a class="indexterm" name="id316550"></a><a name="MAXSTATCACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the size in memory of any
     3451</h3></div></div></div><a class="indexterm" name="id2550371"></a><a name="MAXSTATCACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the size in memory of any
    34393452          <em class="parameter"><code>stat cache</code></em> being used
    34403453          to speed up case insensitive name mappings. It represents
    … …  
    34473460</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max stat cache size</code></em> = <code class="literal">100</code>
    34483461</em></span>
    3449 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id316615"></a>
     3462</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550440"></a>
    34503463
    34513464max ttl (G)
    3452 </h3></div></div></div><a class="indexterm" name="id316616"></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'
     3465</h3></div></div></div><a class="indexterm" name="id2550441"></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'
    34533466    of NetBIOS names should be (in seconds) when <code class="literal">nmbd</code> is
    34543467    requesting a name using either a broadcast packet or from a WINS server. You should
    34553468        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>
    34563469</em></span>
    3457 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id316671"></a>
     3470</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550499"></a>
    34583471
    34593472max wins ttl (G)
    3460 </h3></div></div></div><a class="indexterm" name="id316672"></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
    3461         (<a class="link" href="smb.conf.5.html#WINSSUPPORT">wins support = yes</a>) what the maximum
     3473</h3></div></div></div><a class="indexterm" name="id2550500"></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
     3474        (<a class="link" href="smb.conf.5.html#WINSSUPPORT" target="_top">wins support = yes</a>) what the maximum
    34623475    'time to live' of NetBIOS names that <code class="literal">nmbd</code>
    34633476    will grant will be (in seconds). You should never need to change this
    34643477        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>
    34653478</em></span>
    3466 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id316739"></a>
     3479</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550570"></a>
    34673480
    34683481max xmit (G)
    3469 </h3></div></div></div><a class="indexterm" name="id316740"></a><a name="MAXXMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum packet size
     3482</h3></div></div></div><a class="indexterm" name="id2550571"></a><a name="MAXXMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum packet size
    34703483    that will be negotiated by Samba. The default is 16644, which
    34713484    matches the behavior of Windows 2000.  A value below 2048 is likely to cause problems.
    … …  
    34753488</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max xmit</code></em> = <code class="literal">8192</code>
    34763489</em></span>
    3477 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id316799"></a>
     3490</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550632"></a>
    34783491
    34793492message command (G)
    3480 </h3></div></div></div><a class="indexterm" name="id316800"></a><a name="MESSAGECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies what command to run when the
     3493</h3></div></div></div><a class="indexterm" name="id2550633"></a><a name="MESSAGECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies what command to run when the
    34813494        server receives a WinPopup style message.</p><p>This would normally be a command that would
    34823495        deliver the message somehow. How this is to be done is
    … …  
    35173530</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>
    35183531</em></span>
    3519 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id316991"></a>
     3532</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550842"></a>
    35203533
    35213534min print space (S)
    3522 </h3></div></div></div><a class="indexterm" name="id316992"></a><a name="MINPRINTSPACE"></a><div class="variablelist"><dl><dt></dt><dd><p>This sets the minimum amount of free disk
     3535</h3></div></div></div><a class="indexterm" name="id2550843"></a><a name="MINPRINTSPACE"></a><div class="variablelist"><dl><dt></dt><dd><p>This sets the minimum amount of free disk
    35233536    space that must be available before a user will be able to spool
    35243537    a print job. It is specified in kilobytes. The default is 0, which
    … …  
    35273540</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>min print space</code></em> = <code class="literal">2000</code>
    35283541</em></span>
    3529 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id317051"></a>
     3542</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550905"></a>
    35303543
    35313544min protocol (G)
    3532 </h3></div></div></div><a class="indexterm" name="id317052"></a><a name="MINPROTOCOL"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a string) is the
     3545</h3></div></div></div><a class="indexterm" name="id2550906"></a><a name="MINPROTOCOL"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a string) is the
    35333546    lowest SMB protocol dialect than Samba will support.  Please refer
    3534     to the <a class="link" href="smb.conf.5.html#MAXPROTOCOL">max protocol</a>
     3547    to the <a class="link" href="smb.conf.5.html#MAXPROTOCOL" target="_top">max protocol</a>
    35353548    parameter for a list of valid protocol names and a brief description
    35363549    of each.  You may also wish to refer to the C source code in
    35373550    <code class="filename">source/smbd/negprot.c</code> for a listing of known protocol
    35383551    dialects supported by clients.</p><p>If you are viewing this parameter as a security measure, you should
    3539     also refer to the <a class="link" href="smb.conf.5.html#LANMANAUTH">lanman auth</a> parameter.  Otherwise, you should never need
     3552    also refer to the <a class="link" href="smb.conf.5.html#LANMANAUTH" target="_top">lanman auth</a> parameter.  Otherwise, you should never need
    35403553    to change this parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>min protocol</code></em> = <code class="literal">CORE</code>
    35413554</em></span>
    35423555</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>min protocol</code></em> = <code class="literal">NT1</code>
    35433556</em></span>
    3544 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id317143"></a>
     3557</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551003"></a>
    35453558
    35463559min wins ttl (G)
    3547 </h3></div></div></div><a class="indexterm" name="id317144"></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>
    3548     when acting as a WINS server (<a class="link" href="smb.conf.5.html#WINSSUPPORT">wins support = yes</a>) what the minimum 'time to live'
     3560</h3></div></div></div><a class="indexterm" name="id2551004"></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>
     3561    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'
    35493562    of NetBIOS names that <code class="literal">nmbd</code> will grant will be (in
    35503563    seconds). You should never need to change this parameter.  The default
    35513564    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>
    35523565</em></span>
    3553 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id317209"></a>
     3566</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551073"></a>
    35543567
    35553568msdfs proxy (S)
    3556 </h3></div></div></div><a class="indexterm" name="id317210"></a><a name="MSDFSPROXY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter indicates that the share is a
     3569</h3></div></div></div><a class="indexterm" name="id2551074"></a><a name="MSDFSPROXY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter indicates that the share is a
    35573570        stand-in for another CIFS share whose location is specified by
    35583571        the value of the parameter. When clients attempt to connect to
    35593572        this share, they are redirected to the proxied share using
    35603573        the SMB-Dfs protocol.</p><p>Only Dfs roots can act as proxy shares. Take a look at the
    3561         <a class="link" href="smb.conf.5.html#MSDFSROOT">msdfs root</a> and <a class="link" href="smb.conf.5.html#HOSTMSDFS">host msdfs</a>
     3574        <a class="link" href="smb.conf.5.html#MSDFSROOT" target="_top">msdfs root</a> and <a class="link" href="smb.conf.5.html#HOSTMSDFS" target="_top">host msdfs</a>
    35623575        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>
    35633576</em></span>
    3564 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id317282"></a>
     3577</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551151"></a>
    35653578
    35663579msdfs root (S)
    3567 </h3></div></div></div><a class="indexterm" name="id317283"></a><a name="MSDFSROOT"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to <code class="constant">yes</code>, Samba treats the
     3580</h3></div></div></div><a class="indexterm" name="id2551152"></a><a name="MSDFSROOT"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to <code class="constant">yes</code>, Samba treats the
    35683581        share as a Dfs root and allows clients to browse the
    35693582        distributed file system tree rooted at the share directory.
    … …  
    35733586        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>
    35743587</em></span>
    3575 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id317335"></a>
     3588</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551206"></a>
    35763589
    35773590name cache timeout (G)
    3578 </h3></div></div></div><a class="indexterm" name="id317336"></a><a name="NAMECACHETIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the number of seconds it takes before
     3591</h3></div></div></div><a class="indexterm" name="id2551207"></a><a name="NAMECACHETIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the number of seconds it takes before
    35793592    entries in samba's hostname resolve cache time out. If
    35803593    the timeout is set to 0. the caching is disabled.
    … …  
    35833596</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>name cache timeout</code></em> = <code class="literal">0</code>
    35843597</em></span>
    3585 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id317393"></a>
     3598</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551267"></a>
    35863599
    35873600name resolve order (G)
    3588 </h3></div></div></div><a class="indexterm" name="id317394"></a><a name="NAMERESOLVEORDER"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used by the programs in the Samba
     3601</h3></div></div></div><a class="indexterm" name="id2551268"></a><a name="NAMERESOLVEORDER"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used by the programs in the Samba
    35893602    suite to determine what naming services to use and in what order
    35903603    to resolve host names to IP addresses. Its main purpose to is to
    … …  
    36043617                _ldap._tcp.domain.
    36053618        </p></li><li><p><code class="constant">wins</code> : Query a name with
    3606             the IP address listed in the <a class="link" href="smb.conf.5.html#WINSSERVER">WINSSERVER</a> parameter.  If no WINS server has
     3619            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
    36073620            been specified this method will be ignored.</p></li><li><p><code class="constant">bcast</code> : Do a broadcast on
    3608             each of the known local interfaces listed in the <a class="link" href="smb.conf.5.html#INTERFACES">interfaces</a>
     3621            each of the known local interfaces listed in the <a class="link" href="smb.conf.5.html#INTERFACES" target="_top">interfaces</a>
    36093622            parameter. This is the least reliable of the name resolution
    36103623            methods as it depends on the target host being on a locally
    … …  
    36173630</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>name resolve order</code></em> = <code class="literal">lmhosts bcast host</code>
    36183631</em></span>
    3619 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id317574"></a>
     3632</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551469"></a>
    36203633
    36213634netbios aliases (G)
    3622 </h3></div></div></div><a class="indexterm" name="id317575"></a><a name="NETBIOSALIASES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of NetBIOS names that nmbd will
     3635</h3></div></div></div><a class="indexterm" name="id2551470"></a><a name="NETBIOSALIASES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of NetBIOS names that nmbd will
    36233636        advertise as additional names by which the Samba server is known. This allows one machine
    36243637        to appear in browse lists under multiple names. If a machine is acting as a browse server
    … …  
    36303643</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>netbios aliases</code></em> = <code class="literal">TEST TEST1 TEST2</code>
    36313644</em></span>
    3632 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id317635"></a>
     3645</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551536"></a>
    36333646
    36343647netbios name (G)
    3635 </h3></div></div></div><a class="indexterm" name="id317636"></a><a name="NETBIOSNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3648</h3></div></div></div><a class="indexterm" name="id2551537"></a><a name="NETBIOSNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    36363649                This sets the NetBIOS name by which a Samba server is known. By default it is the same as the first component
    36373650                of the host's DNS name. If a machine is a browse server or logon server this name (or the first component of
    … …  
    36463659</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>netbios name</code></em> = <code class="literal">MYNAME</code>
    36473660</em></span>
    3648 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id317712"></a>
     3661</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551617"></a>
    36493662
    36503663netbios scope (G)
    3651 </h3></div></div></div><a class="indexterm" name="id317713"></a><a name="NETBIOSSCOPE"></a><div class="variablelist"><dl><dt></dt><dd><p>This sets the NetBIOS scope that Samba will
     3664</h3></div></div></div><a class="indexterm" name="id2551618"></a><a name="NETBIOSSCOPE"></a><div class="variablelist"><dl><dt></dt><dd><p>This sets the NetBIOS scope that Samba will
    36523665        operate under. This should not be set unless every machine
    36533666        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>
    36543667</em></span>
    3655 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id317753"></a>
     3668</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551659"></a>
    36563669
    36573670nis homedir (G)
    3658 </h3></div></div></div><a class="indexterm" name="id317754"></a><a name="NISHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>Get the home share server from a NIS map. For
     3671</h3></div></div></div><a class="indexterm" name="id2551660"></a><a name="NISHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>Get the home share server from a NIS map. For
    36593672        UNIX systems that use an automounter, the user's home directory
    36603673        will often be mounted on a workstation on demand from a remote
    … …  
    36703683        server. When Samba is returning the home share to the client, it
    36713684        will consult the NIS map specified in
    3672         <a class="link" href="smb.conf.5.html#HOMEDIRMAP">homedir map</a> and return the server
     3685        <a class="link" href="smb.conf.5.html#HOMEDIRMAP" target="_top">homedir map</a> and return the server
    36733686        listed there.</p><p>Note that for this option to work there must be a working
    36743687        NIS system and the Samba server with this option must also
    36753688        be a logon server.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>nis homedir</code></em> = <code class="literal">no</code>
    36763689</em></span>
    3677 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id317824"></a>
     3690</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551739"></a>
    36783691
    36793692nt acl support (S)
    3680 </h3></div></div></div><a class="indexterm" name="id317825"></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
     3693</h3></div></div></div><a class="indexterm" name="id2551740"></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
    36813694    UNIX permissions into Windows NT access control lists.  The UNIX
    36823695    permissions considered are the the traditional UNIX owner and
    … …  
    36853698    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>
    36863699</em></span>
    3687 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id317875"></a>
     3700</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551794"></a>
    36883701
    36893702ntlm auth (G)
    3690 </h3></div></div></div><a class="indexterm" name="id317876"></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
     3703</h3></div></div></div><a class="indexterm" name="id2551795"></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
    36913704    authenticate users using the NTLM encrypted password response.
    36923705    If disabled, either the lanman password hash or an NTLMv2 response
    … …  
    36963709        special configuration to us it.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ntlm auth</code></em> = <code class="literal">yes</code>
    36973710</em></span>
    3698 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id317935"></a>
     3711</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551858"></a>
    36993712
    37003713nt pipe support (G)
    3701 </h3></div></div></div><a class="indexterm" name="id317936"></a><a name="NTPIPESUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether
     3714</h3></div></div></div><a class="indexterm" name="id2551859"></a><a name="NTPIPESUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether
    37023715    <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will allow Windows NT
    37033716    clients to connect to the NT SMB specific <code class="constant">IPC$</code>
    … …  
    37053718        alone.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>nt pipe support</code></em> = <code class="literal">yes</code>
    37063719</em></span>
    3707 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id317989"></a>
     3720</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551914"></a>
    37083721
    37093722nt status support (G)
    3710 </h3></div></div></div><a class="indexterm" name="id317990"></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
     3723</h3></div></div></div><a class="indexterm" name="id2551915"></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
    37113724    support with Windows NT/2k/XP clients. This is a developer debugging option and should be left alone.
    37123725    If this option is set to <code class="constant">no</code> then Samba offers
    … …  
    37143727    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>
    37153728</em></span>
    3716 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id318046"></a>
     3729</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551976"></a>
    37173730
    37183731null passwords (G)
    3719 </h3></div></div></div><a class="indexterm" name="id318048"></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>
    3720 </em></span>
    3721 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id318098"></a>
     3732</h3></div></div></div><a class="indexterm" name="id2551977"></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>
     3733</em></span>
     3734</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552029"></a>
    37223735
    37233736obey pam restrictions (G)
    3724 </h3></div></div></div><a class="indexterm" name="id318099"></a><a name="OBEYPAMRESTRICTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba 3.0 is configured to enable PAM support
     3737</h3></div></div></div><a class="indexterm" name="id2552030"></a><a name="OBEYPAMRESTRICTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba 3.0 is configured to enable PAM support
    37253738    (i.e. --with-pam), this parameter will control whether or not Samba
    37263739    should obey PAM's account and session management directives.  The
    37273740    default behavior is to use PAM for clear text authentication only
    37283741    and to ignore any account or session management.  Note that Samba
    3729     always ignores PAM for authentication in the case of <a class="link" href="smb.conf.5.html#ENCRYPTPASSWORDS">encrypt passwords = yes</a>.  The reason
     3742    always ignores PAM for authentication in the case of <a class="link" href="smb.conf.5.html#ENCRYPTPASSWORDS" target="_top">encrypt passwords = yes</a>.  The reason
    37303743    is that PAM modules cannot support the challenge/response
    37313744    authentication mechanism needed in the presence of SMB password encryption.
    37323745</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>obey pam restrictions</code></em> = <code class="literal">no</code>
    37333746</em></span>
    3734 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id318154"></a>
     3747</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552094"></a>
    37353748
    37363749only user (S)
    3737 </h3></div></div></div><a class="indexterm" name="id318155"></a><a name="ONLYUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean option that controls whether
     3750</h3></div></div></div><a class="indexterm" name="id2552095"></a><a name="ONLYUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean option that controls whether
    37383751    connections with usernames not in the <em class="parameter"><code>user</code></em>
    37393752    list will be allowed. By default this option is disabled so that a
    … …  
    37413754    this parameter will force the server to only use the login
    37423755    names from the <em class="parameter"><code>user</code></em> list and is only really
    3743     useful in <a class="link" href="smb.conf.5.html#SECURITY">security = share</a> level security.</p><p>Note that this also means Samba won't try to deduce
     3756    useful in <a class="link" href="smb.conf.5.html#SECURITY" target="_top">security = share</a> level security.</p><p>Note that this also means Samba won't try to deduce
    37443757    usernames from the service name. This can be annoying for
    37453758    the [homes] section. To get around this you could use <code class="literal">user =
    … …  
    37483761    name of the user.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>only user</code></em> = <code class="literal">no</code>
    37493762</em></span>
    3750 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id318237"></a>
     3763</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552183"></a>
    37513764
    37523765open files database hash size (G)
    3753 </h3></div></div></div><a class="indexterm" name="id318238"></a><a name="OPENFILESDATABASEHASHSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter was added in Samba 3.0.23. This is an internal tuning parameter that sets
     3766</h3></div></div></div><a class="indexterm" name="id2552184"></a><a name="OPENFILESDATABASEHASHSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter was added in Samba 3.0.23. This is an internal tuning parameter that sets
    37543767        the hash size of the tdb used for the open file databases. The presence of this parameter
    37553768        allows tuning of the system for very large (thousands of concurrent users) Samba setups.
    … …  
    37593772</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>open files database hash size</code></em> = <code class="literal">1338457</code>
    37603773</em></span>
    3761 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id318299"></a>
     3774</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552249"></a>
    37623775
    37633776oplock break wait time (G)
    3764 </h3></div></div></div><a class="indexterm" name="id318300"></a><a name="OPLOCKBREAKWAITTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3777</h3></div></div></div><a class="indexterm" name="id2552250"></a><a name="OPLOCKBREAKWAITTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    37653778        This is a tuning parameter added due to bugs in both Windows 9x and WinNT. If Samba responds to a client too
    37663779        quickly when that client issues an SMB that can cause an oplock break request, then the network client can
    … …  
    37713784        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>oplock break wait time</code></em> = <code class="literal">0</code>
    37723785</em></span>
    3773 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id318348"></a>
     3786</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552304"></a>
    37743787
    37753788oplock contention limit (S)
    3776 </h3></div></div></div><a class="indexterm" name="id318349"></a><a name="OPLOCKCONTENTIONLIMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3789</h3></div></div></div><a class="indexterm" name="id2552305"></a><a name="OPLOCKCONTENTIONLIMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    37773790        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
    37783791        granting of oplocks under multiple client contention for the same file.
    … …  
    37863799        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>oplock contention limit</code></em> = <code class="literal">2</code>
    37873800</em></span>
    3788 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id318426"></a>
     3801</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552386"></a>
    37893802
    37903803oplocks (S)
    3791 </h3></div></div></div><a class="indexterm" name="id318427"></a><a name="OPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3804</h3></div></div></div><a class="indexterm" name="id2552387"></a><a name="OPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    37923805        This boolean option tells <code class="literal">smbd</code> whether to
    37933806        issue oplocks (opportunistic locks) to file open requests on this
    … …  
    38013814        </p><p>
    38023815        Oplocks may be selectively turned off on certain files with a share. See
    3803         the <a class="link" href="smb.conf.5.html#VETOOPLOCKFILES">veto oplock files</a> parameter. On some systems
     3816        the <a class="link" href="smb.conf.5.html#VETOOPLOCKFILES" target="_top">veto oplock files</a> parameter. On some systems
    38043817        oplocks are recognized by the underlying operating system. This
    38053818        allows data synchronization between all access to oplocked files,
    38063819        whether it be via Samba or NFS or a local UNIX process. See the
    3807         <a class="link" href="smb.conf.5.html#KERNELOPLOCKS">kernel oplocks</a> parameter for details.
     3820        <a class="link" href="smb.conf.5.html#KERNELOPLOCKS" target="_top">kernel oplocks</a> parameter for details.
    38083821        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>oplocks</code></em> = <code class="literal">yes</code>
    38093822</em></span>
    3810 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id318516"></a>
     3823</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552493"></a>
    38113824
    38123825os2 driver map (G)
    3813 </h3></div></div></div><a class="indexterm" name="id318517"></a><a name="OS2DRIVERMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>The parameter is used to define the absolute
     3826</h3></div></div></div><a class="indexterm" name="id2552494"></a><a name="OS2DRIVERMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>The parameter is used to define the absolute
    38143827    path to a file containing a mapping of Windows NT printer driver
    38153828    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
    … …  
    38213834    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>os2 driver map</code></em> = <code class="literal"></code>
    38223835</em></span>
    3823 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id318576"></a>
     3836</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552560"></a>
    38243837
    38253838os level (G)
    3826 </h3></div></div></div><a class="indexterm" name="id318578"></a><a name="OSLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3839</h3></div></div></div><a class="indexterm" name="id2552561"></a><a name="OSLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    38273840        This integer value controls what level Samba advertises itself as for browse elections. The value of this
    3828         parameter determines whether <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> has a chance of becoming a local master browser for the <a class="link" href="smb.conf.5.html#WORKGROUP">workgroup</a> in the local broadcast area.
     3841        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.
    38293842</p><p><span class="emphasis"><em>
    38303843        Note:</em></span> By default, Samba will win a local master browsing election over all Microsoft operating
    … …  
    38403853</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>os level</code></em> = <code class="literal">65</code>
    38413854</em></span>
    3842 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id318668"></a>
     3855</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552659"></a>
    38433856
    38443857pam password change (G)
    3845 </h3></div></div></div><a class="indexterm" name="id318669"></a><a name="PAMPASSWORDCHANGE"></a><div class="variablelist"><dl><dt></dt><dd><p>With the addition of better PAM support in Samba 2.2,
     3858</h3></div></div></div><a class="indexterm" name="id2552660"></a><a name="PAMPASSWORDCHANGE"></a><div class="variablelist"><dl><dt></dt><dd><p>With the addition of better PAM support in Samba 2.2,
    38463859    this parameter, it is possible to use PAM's password change control
    38473860    flag for Samba.  If enabled, then PAM will be used for password
    38483861    changes when requested by an SMB client instead of the program listed in
    3849     <a class="link" href="smb.conf.5.html#PASSWDPROGRAM">passwd program</a>.
     3862    <a class="link" href="smb.conf.5.html#PASSWDPROGRAM" target="_top">passwd program</a>.
    38503863    It should be possible to enable this without changing your
    3851     <a class="link" href="smb.conf.5.html#PASSWDCHAT">passwd chat</a> parameter for most setups.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>pam password change</code></em> = <code class="literal">no</code>
    3852 </em></span>
    3853 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id318735"></a>
     3864    <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>
     3865</em></span>
     3866</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552732"></a>
    38543867
    38553868panic action (G)
    3856 </h3></div></div></div><a class="indexterm" name="id318736"></a><a name="PANICACTION"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a Samba developer option that allows a
     3869</h3></div></div></div><a class="indexterm" name="id2552733"></a><a name="PANICACTION"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a Samba developer option that allows a
    38573870        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
    38583871        draw attention to the fact that a problem occurred.
    … …  
    38613874</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>panic action</code></em> = <code class="literal">"/bin/sleep 90000"</code>
    38623875</em></span>
    3863 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id318809"></a>
     3876</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552808"></a>
    38643877
    38653878paranoid server security (G)
    3866 </h3></div></div></div><a class="indexterm" name="id318810"></a><a name="PARANOIDSERVERSECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>Some version of NT 4.x allow non-guest
     3879</h3></div></div></div><a class="indexterm" name="id2552809"></a><a name="PARANOIDSERVERSECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>Some version of NT 4.x allow non-guest
    38673880    users with a bad passowrd. When this option is enabled, samba will not
    38683881    use a broken NT 4.x server as password server, but instead complain
    … …  
    38723885    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>
    38733886</em></span>
    3874 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id318856"></a>
     3887</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552859"></a>
    38753888
    38763889passdb backend (G)
    3877 </h3></div></div></div><a class="indexterm" name="id318857"></a><a name="PASSDBBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows the administrator to chose which backend
     3890</h3></div></div></div><a class="indexterm" name="id2552860"></a><a name="PASSDBBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows the administrator to chose which backend
    38783891    will be used for storing user and possibly group information.  This allows
    38793892    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'
    … …  
    38843897                </p></li><li><p><code class="literal">tdbsam</code> - The TDB based password storage
    38853898                backend.  Takes a path to the TDB as an optional argument (defaults to passdb.tdb
    3886                 in the <a class="link" href="smb.conf.5.html#PRIVATEDIR">private dir</a> directory.</p></li><li><p><code class="literal">ldapsam</code> - The LDAP based passdb
     3899                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
    38873900                backend.  Takes an LDAP URL as an optional argument (defaults to
    38883901                <code class="literal">ldap://localhost</code>)</p><p>LDAP connections should be secured where possible.  This may be done using either
    3889                 Start-TLS (see <a class="link" href="smb.conf.5.html#LDAPSSL">ldap ssl</a>) or by
     3902                Start-TLS (see <a class="link" href="smb.conf.5.html#LDAPSSL" target="_top">ldap ssl</a>) or by
    38903903                specifying <em class="parameter"><code>ldaps://</code></em> in
    38913904                the URL argument. </p><p>Multiple servers may also be specified in double-quotes.
    … …  
    39083921</pre><p>Default: <span class="emphasis"><em><em class="parameter"><code>passdb backend</code></em> = <code class="literal">smbpasswd</code>
    39093922</em></span>
    3910 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id318998"></a>
     3923</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553016"></a>
    39113924
    39123925passdb expand explicit (G)
    3913 </h3></div></div></div><a class="indexterm" name="id318999"></a><a name="PASSDBEXPANDEXPLICIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3926</h3></div></div></div><a class="indexterm" name="id2553017"></a><a name="PASSDBEXPANDEXPLICIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    39143927        This parameter controls whether Samba substitutes %-macros in the passdb fields if they are explicitly set. We
    39153928        used to expand macros here, but this turned out to be a bug because the Windows client can expand a variable
    … …  
    39173930    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>passdb expand explicit</code></em> = <code class="literal">no</code>
    39183931</em></span>
    3919 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id319041"></a>
     3932</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553064"></a>
    39203933
    39213934passwd chat debug (G)
    3922 </h3></div></div></div><a class="indexterm" name="id319042"></a><a name="PASSWDCHATDEBUG"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean specifies if the passwd chat script
     3935</h3></div></div></div><a class="indexterm" name="id2553065"></a><a name="PASSWDCHATDEBUG"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean specifies if the passwd chat script
    39233936    parameter is run in <span class="emphasis"><em>debug</em></span> mode. In this mode the
    39243937    strings passed to and received from the passwd chat are printed
    39253938    in the <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> log with a
    3926     <a class="link" href="smb.conf.5.html#DEBUGLEVEL">debug level</a>
     3939    <a class="link" href="smb.conf.5.html#DEBUGLEVEL" target="_top">debug level</a>
    39273940    of 100. This is a dangerous option as it will allow plaintext passwords
    39283941    to be seen in the <code class="literal">smbd</code> log. It is available to help
    … …  
    39303943    when calling the <em class="parameter"><code>passwd program</code></em> and should
    39313944    be turned off after this has been done. This option has no effect if the
    3932     <a class="link" href="smb.conf.5.html#PAMPASSWORDCHANGE">pam password change</a>
     3945    <a class="link" href="smb.conf.5.html#PAMPASSWORDCHANGE" target="_top">pam password change</a>
    39333946        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>
    39343947</em></span>
    3935 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id319137"></a>
     3948</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553167"></a>
    39363949
    39373950passwd chat timeout (G)
    3938 </h3></div></div></div><a class="indexterm" name="id319138"></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
     3951</h3></div></div></div><a class="indexterm" name="id2553168"></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
    39393952    answer from a passwd chat script being run. Once the initial answer is received
    39403953    the subsequent answers must be received in one tenth of this time. The default it
    39413954    two seconds.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>passwd chat timeout</code></em> = <code class="literal">2</code>
    39423955</em></span>
    3943 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id319179"></a>
     3956</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553211"></a>
    39443957
    39453958passwd chat (G)
    3946 </h3></div></div></div><a class="indexterm" name="id319180"></a><a name="PASSWDCHAT"></a><div class="variablelist"><dl><dt></dt><dd><p>This string controls the <span class="emphasis"><em>"chat"</em></span>
     3959</h3></div></div></div><a class="indexterm" name="id2553212"></a><a name="PASSWDCHAT"></a><div class="variablelist"><dl><dt></dt><dd><p>This string controls the <span class="emphasis"><em>"chat"</em></span>
    39473960    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
    39483961    program to change the user's password. The string describes a
    39493962    sequence of response-receive pairs that <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> uses to determine what to send to the
    3950     <a class="link" href="smb.conf.5.html#PASSWDPROGRAM">passwd program</a> and what to expect back. If the expected output is not
     3963    <a class="link" href="smb.conf.5.html#PASSWDPROGRAM" target="_top">passwd program</a> and what to expect back. If the expected output is not
    39513964    received then the password is not changed.</p><p>This chat sequence is often quite site specific, depending
    39523965    on what local methods are used for password control (such as NIS
    3953     etc).</p><p>Note that this parameter only is only used if the <a class="link" href="smb.conf.5.html#UNIXPASSWORDSYNC">unix password sync</a> parameter is set  to <code class="constant">yes</code>. This sequence is
     3966    etc).</p><p>Note that this parameter only is only used if the <a class="link" href="smb.conf.5.html#UNIXPASSWORDSYNC" target="_top">unix password sync</a> parameter is set  to <code class="constant">yes</code>. This sequence is
    39543967    then called <span class="emphasis"><em>AS ROOT</em></span> when the SMB password  in the
    39553968    smbpasswd file is being changed, without access to the old password
    39563969    cleartext. This means that root must be able to reset the user's password without
    39573970    knowing the text of the previous password. In the presence of
    3958     NIS/YP,  this means that the <a class="link" href="smb.conf.5.html#PASSWDPROGRAM">passwd program</a> must
     3971    NIS/YP,  this means that the <a class="link" href="smb.conf.5.html#PASSWDPROGRAM" target="_top">passwd program</a> must
    39593972    be executed on the NIS master.
    39603973    </p><p>The string can contain the macro <em class="parameter"><code>%n</code></em> which is substituted
    39613974    for the new password.  The old passsword (<em class="parameter"><code>%o</code></em>) is only available when
    3962     <a class="link" href="smb.conf.5.html#ENCRYPTPASSWORDS">encrypt passwords</a> has been disabled.
     3975    <a class="link" href="smb.conf.5.html#ENCRYPTPASSWORDS" target="_top">encrypt passwords</a> has been disabled.
    39633976    The chat sequence can also contain the standard macros
    39643977    \n, \r, \t and \s to give line-feed, carriage-return, tab
    … …  
    39683981    string.</p><p>If the send string in any part of the chat sequence  is a full
    39693982    stop ".",  then no string is sent. Similarly,  if the
    3970     expect string is a full stop then no string is expected.</p><p>If the <a class="link" href="smb.conf.5.html#PAMPASSWORDCHANGE">pam password change</a> parameter is set to <code class="constant">yes</code>, the
     3983    expect string is a full stop then no string is expected.</p><p>If the <a class="link" href="smb.conf.5.html#PAMPASSWORDCHANGE" target="_top">pam password change</a> parameter is set to <code class="constant">yes</code>, the
    39713984        chat pairs may be matched in any order, and success is determined by the PAM result, not any particular
    39723985        output. The \n macro is ignored for PAM conversions.
    … …  
    39753988</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>
    39763989</em></span>
    3977 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id319362"></a>
     3990</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553417"></a>
    39783991
    39793992passwd program (G)
    3980 </h3></div></div></div><a class="indexterm" name="id319364"></a><a name="PASSWDPROGRAM"></a><div class="variablelist"><dl><dt></dt><dd><p>The name of a program that can be used to set
     3993</h3></div></div></div><a class="indexterm" name="id2553418"></a><a name="PASSWDPROGRAM"></a><div class="variablelist"><dl><dt></dt><dd><p>The name of a program that can be used to set
    39813994    UNIX user passwords.  Any occurrences of <em class="parameter"><code>%u</code></em>
    39823995    will be replaced with the user name. The user name is checked for
    … …  
    39994012</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>passwd program</code></em> = <code class="literal">/bin/passwd %u</code>
    40004013</em></span>
    4001 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id319489"></a>
     4014</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553553"></a>
    40024015
    40034016password level (G)
    4004 </h3></div></div></div><a class="indexterm" name="id319490"></a><a name="PASSWORDLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>Some client/server combinations have difficulty
     4017</h3></div></div></div><a class="indexterm" name="id2553554"></a><a name="PASSWORDLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>Some client/server combinations have difficulty
    40054018    with mixed-case passwords.  One offending client is Windows for
    40064019    Workgroups, which for some reason forces passwords to upper
    … …  
    40204033    made - the password as is and the password in all-lower case.</p><p>This parameter is used only when using plain-text passwords. It is
    40214034    not at all used when encrypted passwords as in use (that is the default
    4022     since samba-3.0.0). Use this only when <a class="link" href="smb.conf.5.html#ENCRYPTPASSWORDS">encrypt passwords = No</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>password level</code></em> = <code class="literal">0</code>
     4035    since samba-3.0.0). Use this only when <a class="link" href="smb.conf.5.html#ENCRYPTPASSWORDS" target="_top">encrypt passwords = No</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>password level</code></em> = <code class="literal">0</code>
    40234036</em></span>
    40244037</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>password level</code></em> = <code class="literal">4</code>
    40254038</em></span>
    4026 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id319610"></a>
     4039</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553690"></a>
    40274040
    40284041password server (G)
    4029 </h3></div></div></div><a class="indexterm" name="id319611"></a><a name="PASSWORDSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>By specifying the name of another SMB server
     4042</h3></div></div></div><a class="indexterm" name="id2553691"></a><a name="PASSWORDSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>By specifying the name of another SMB server
    40304043    or Active Directory domain controller with this option,
    40314044    and using <code class="literal">security = [ads|domain|server]</code>
    … …  
    40394052    have no effect on password servers for Windows NT 4.0 domains or netbios
    40404053    connections.</p><p>If parameter is a name, it is looked up using the
    4041     parameter <a class="link" href="smb.conf.5.html#NAMERESOLVEORDER">name resolve order</a> and so may resolved
     4054    parameter <a class="link" href="smb.conf.5.html#NAMERESOLVEORDER" target="_top">name resolve order</a> and so may resolved
    40424055    by any method and order described in that parameter.</p><p>The password server must be a machine capable of using
    40434056    the "LM1.2X002" or the "NT LM 0.12" protocol, and it must be in
    … …  
    40874100</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>
    40884101</em></span>
    4089 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id319876"></a>
     4102</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553988"></a>
    40904103
    40914104<a name="DIRECTORY"></a>directory
    4092 </h3></div></div></div><a class="indexterm" name="id319877"></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="id319907"></a>
     4105</h3></div></div></div><a class="indexterm" name="id2553989"></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="id2554019"></a>
    40934106
    40944107path (S)
    4095 </h3></div></div></div><a class="indexterm" name="id319908"></a><a name="PATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a directory to which
     4108</h3></div></div></div><a class="indexterm" name="id2554020"></a><a name="PATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a directory to which
    40964109        the user of the service is to be given access. In the case of
    40974110        printable services, this is where print data will spool prior to
    … …  
    41054118        will be replaced by the NetBIOS name of the machine they are
    41064119        connecting from. These replacements are very useful for setting
    4107         up pseudo home directories for users.</p><p>Note that this path will be based on <a class="link" href="smb.conf.5.html#ROOTDIR">root dir</a>
     4120        up pseudo home directories for users.</p><p>Note that this path will be based on <a class="link" href="smb.conf.5.html#ROOTDIR" target="_top">root dir</a>
    41084121         if one was specified.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>path</code></em> = <code class="literal"></code>
    41094122</em></span>
    41104123</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>path</code></em> = <code class="literal">/home/fred</code>
    41114124</em></span>
    4112 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id320003"></a>
     4125</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554123"></a>
    41134126
    41144127pid directory (G)
    4115 </h3></div></div></div><a class="indexterm" name="id320004"></a><a name="PIDDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4128</h3></div></div></div><a class="indexterm" name="id2554124"></a><a name="PIDDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    41164129        This option specifies the directory where pid files will be placed. 
    41174130        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>pid directory</code></em> = <code class="literal">${prefix}/var/locks</code>
    … …  
    41194132</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>pid directory</code></em> = <code class="literal">pid directory = /var/run/</code>
    41204133</em></span>
    4121 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id320061"></a>
     4134</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554184"></a>
    41224135
    41234136posix locking (S)
    4124 </h3></div></div></div><a class="indexterm" name="id320062"></a><a name="POSIXLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4137</h3></div></div></div><a class="indexterm" name="id2554185"></a><a name="POSIXLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
    41254138        The <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>
    41264139        daemon maintains an database of file locks obtained by SMB clients. The default behavior is
    … …  
    41304143        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>posix locking</code></em> = <code class="literal">yes</code>
    41314144</em></span>
    4132 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id320113"></a>
     4145</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554245"></a>
    41334146
    41344147postexec (S)
    4135 </h3></div></div></div><a class="indexterm" name="id320114"></a><a name="POSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run
     4148</h3></div></div></div><a class="indexterm" name="id2554246"></a><a name="POSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run
    41364149        whenever the service is disconnected. It takes the usual
    41374150        substitutions. The command may be run as the root on some
    … …  
    41414154</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>
    41424155</em></span>
    4143 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id320182"></a>
     4156</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554318"></a>
    41444157
    41454158preexec close (S)
    4146 </h3></div></div></div><a class="indexterm" name="id320183"></a><a name="PREEXECCLOSE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    4147         This boolean option controls whether a non-zero return code from <a class="link" href="smb.conf.5.html#PREEXEC">preexec</a>
     4159</h3></div></div></div><a class="indexterm" name="id2554319"></a><a name="PREEXECCLOSE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4160        This boolean option controls whether a non-zero return code from <a class="link" href="smb.conf.5.html#PREEXEC" target="_top">preexec</a>
    41484161        should close the service being connected to.
    41494162        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preexec close</code></em> = <code class="literal">no</code>
    41504163</em></span>
    4151 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id320234"></a>
     4164</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554373"></a>
    41524165
    41534166<a name="EXEC"></a>exec
    4154 </h3></div></div></div><a class="indexterm" name="id320235"></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="id320265"></a>
     4167</h3></div></div></div><a class="indexterm" name="id2554374"></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="id2554404"></a>
    41554168
    41564169preexec (S)
    4157 </h3></div></div></div><a class="indexterm" name="id320266"></a><a name="PREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run whenever
     4170</h3></div></div></div><a class="indexterm" name="id2554406"></a><a name="PREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run whenever
    41584171        the service is connected to. It takes the usual substitutions.</p><p>An interesting example is to send the users a welcome
    41594172        message every time they log in. Maybe a message of the day? Here
    … …  
    41624175        /usr/local/samba/bin/smbclient -M %m -I %I' &amp; </code>
    41634176        </p><p>Of course, this could get annoying after a while :-)</p><p>
    4164         See also <a class="link" href="smb.conf.5.html#PREEXECCLOSE">preexec close</a> and <a class="link" href="smb.conf.5.html#POSTEXEC">postexec</a>.
     4177        See also <a class="link" href="smb.conf.5.html#PREEXECCLOSE" target="_top">preexec close</a> and <a class="link" href="smb.conf.5.html#POSTEXEC" target="_top">postexec</a>.
    41654178        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preexec</code></em> = <code class="literal"></code>
    41664179</em></span>
    41674180</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>
    41684181</em></span>
    4169 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id320366"></a>
     4182</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554513"></a>
    41704183
    41714184<a name="PREFEREDMASTER"></a>prefered master
    4172 </h3></div></div></div><a class="indexterm" name="id320367"></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="id320397"></a>
     4185</h3></div></div></div><a class="indexterm" name="id2554514"></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="id2554546"></a>
    41734186
    41744187preferred master (G)
    4175 </h3></div></div></div><a class="indexterm" name="id320398"></a><a name="PREFERREDMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4188</h3></div></div></div><a class="indexterm" name="id2554547"></a><a name="PREFERREDMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    41764189        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.
    41774190        </p><p>
    41784191        If this is set to <code class="constant">yes</code>, on startup, <code class="literal">nmbd</code> will force
    41794192        an election, and it will have a slight advantage in winning the election.  It is recommended that this
    4180         parameter is used in conjunction with <a class="link" href="smb.conf.5.html#DOMAINMASTER">domain master = yes</a>, so that
     4193        parameter is used in conjunction with <a class="link" href="smb.conf.5.html#DOMAINMASTER" target="_top">domain master = yes</a>, so that
    41814194        <code class="literal">nmbd</code> can guarantee becoming a domain master.
    41824195        </p><p>
    … …  
    41874200        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preferred master</code></em> = <code class="literal">auto</code>
    41884201</em></span>
    4189 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id320484"></a>
     4202</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554639"></a>
    41904203
    41914204preload modules (G)
    4192 </h3></div></div></div><a class="indexterm" name="id320485"></a><a name="PRELOADMODULES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of paths to modules that should
     4205</h3></div></div></div><a class="indexterm" name="id2554640"></a><a name="PRELOADMODULES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of paths to modules that should
    41934206        be loaded into smbd before a client connects. This improves
    41944207        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>
    … …  
    41964209</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>
    41974210</em></span>
    4198 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id320541"></a>
     4211</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554700"></a>
    41994212
    42004213<a name="AUTOSERVICES"></a>auto services
    4201 </h3></div></div></div><a class="indexterm" name="id320542"></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="id320573"></a>
     4214</h3></div></div></div><a class="indexterm" name="id2554701"></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="id2554732"></a>
    42024215
    42034216preload (G)
    4204 </h3></div></div></div><a class="indexterm" name="id320574"></a><a name="PRELOAD"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of services that you want to be
     4217</h3></div></div></div><a class="indexterm" name="id2554734"></a><a name="PRELOAD"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of services that you want to be
    42054218        automatically added to the browse lists. This is most useful
    42064219        for homes and printers services that would otherwise not be
    42074220        visible.</p><p>
    42084221        Note that if you just want all printers in your
    4209         printcap file loaded then the <a class="link" href="smb.conf.5.html#LOADPRINTERS">load printers</a>
     4222        printcap file loaded then the <a class="link" href="smb.conf.5.html#LOADPRINTERS" target="_top">load printers</a>
    42104223         option is easier.
    42114224        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preload</code></em> = <code class="literal"></code>
    … …  
    42134226</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>preload</code></em> = <code class="literal">fred lp colorlp</code>
    42144227</em></span>
    4215 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id320647"></a>
     4228</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554810"></a>
    42164229
    42174230preserve case (S)
    4218 </h3></div></div></div><a class="indexterm" name="id320648"></a><a name="PRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4231</h3></div></div></div><a class="indexterm" name="id2554812"></a><a name="PRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    42194232        This controls if new filenames are created with the case that the client passes, or if
    4220         they are forced to be the <a class="link" href="smb.conf.5.html#DEFAULTCASE">default case</a>.
     4233        they are forced to be the <a class="link" href="smb.conf.5.html#DEFAULTCASE" target="_top">default case</a>.
    42214234        </p><p>
    42224235        See the section on <a class="link" href="#NAMEMANGLINGSECT" title="NAME MANGLING">NAME MANGLING</a> for a fuller discussion.
    42234236        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preserve case</code></em> = <code class="literal">yes</code>
    42244237</em></span>
    4225 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id320710"></a>
     4238</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554877"></a>
    42264239
    42274240<a name="PRINTOK"></a>print ok
    4228 </h3></div></div></div><a class="indexterm" name="id320711"></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="id320741"></a>
     4241</h3></div></div></div><a class="indexterm" name="id2554878"></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="id2554908"></a>
    42294242
    42304243printable (S)
    4231 </h3></div></div></div><a class="indexterm" name="id320742"></a><a name="PRINTABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code>, then
     4244</h3></div></div></div><a class="indexterm" name="id2554909"></a><a name="PRINTABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code>, then
    42324245    clients may open, write to and submit spool files on the directory
    42334246    specified for the service. </p><p>Note that a printable service will ALWAYS allow writing
    42344247    to the service path (user privileges permitting) via the spooling
    4235     of print data. The <a class="link" href="smb.conf.5.html#READONLY">read only</a> parameter controls only non-printing access to
     4248    of print data. The <a class="link" href="smb.conf.5.html#READONLY" target="_top">read only</a> parameter controls only non-printing access to
    42364249    the resource.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>printable</code></em> = <code class="literal">no</code>
    42374250</em></span>
    4238 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id320801"></a>
     4251</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554971"></a>
    42394252
    42404253printcap cache time (G)
    4241 </h3></div></div></div><a class="indexterm" name="id320802"></a><a name="PRINTCAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the number of seconds before the printing
     4254</h3></div></div></div><a class="indexterm" name="id2554972"></a><a name="PRINTCAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the number of seconds before the printing
    42424255    subsystem is again asked for the known printers.  If the value
    42434256    is greater than 60 the initial waiting time is set to 60 seconds
    … …  
    42494262</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printcap cache time</code></em> = <code class="literal">600</code>
    42504263</em></span>
    4251 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id320865"></a>
     4264</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555040"></a>
    42524265
    42534266<a name="PRINTCAP"></a>printcap
    4254 </h3></div></div></div><a class="indexterm" name="id320866"></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="id320897"></a>
     4267</h3></div></div></div><a class="indexterm" name="id2555041"></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="id2555073"></a>
    42554268
    42564269printcap name (G)
    4257 </h3></div></div></div><a class="indexterm" name="id320898"></a><a name="PRINTCAPNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4270</h3></div></div></div><a class="indexterm" name="id2555074"></a><a name="PRINTCAPNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    42584271        This parameter may be used to override the compiled-in default printcap name used by the server (usually
    42594272        <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.
    42604273        </p><p>
    42614274        To use the CUPS printing interface set <code class="literal">printcap name = cups </code>. This should
    4262         be supplemented by an addtional setting <a class="link" href="smb.conf.5.html#PRINTING">printing = cups</a> in the [global]
     4275        be supplemented by an addtional setting <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing = cups</a> in the [global]
    42634276        section.  <code class="literal">printcap name = cups</code> will use the  "dummy" printcap
    42644277        created by CUPS, as specified in your CUPS configuration file.
    … …  
    42904303</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printcap name</code></em> = <code class="literal">/etc/myprintcap</code>
    42914304</em></span>
    4292 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id321069"></a>
     4305</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555257"></a>
    42934306
    42944307print command (S)
    4295 </h3></div></div></div><a class="indexterm" name="id321070"></a><a name="PRINTCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>After a print job has finished spooling to
     4308</h3></div></div></div><a class="indexterm" name="id2555258"></a><a name="PRINTCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>After a print job has finished spooling to
    42964309    a service, this command will be used via a <code class="literal">system()</code>
    42974310    call to process the spool file. Typically the command specified will
    … …  
    43164329    be created but not processed and (most importantly) not removed.</p><p>Note that printing may fail on some UNIXes from the
    43174330    <code class="constant">nobody</code> account. If this happens then create
    4318     an alternative guest account that can print and set the <a class="link" href="smb.conf.5.html#GUESTACCOUNT">guest account</a>
     4331    an alternative guest account that can print and set the <a class="link" href="smb.conf.5.html#GUESTACCOUNT" target="_top">guest account</a>
    43194332    in the [global] section.</p><p>You can form quite complex print commands by realizing
    43204333    that they are just passed to a shell. For example the following
    … …  
    43234336    /tmp/print.log; lpr -P %p %s; rm %s</code></p><p>You may have to vary this command considerably depending
    43244337    on how you normally print files on your system. The default for
    4325     the parameter varies depending on the setting of the <a class="link" href="smb.conf.5.html#PRINTING">printing</a>
     4338    the parameter varies depending on the setting of the <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing</a>
    43264339        parameter.</p><p>Default: For <code class="literal">printing = BSD, AIX, QNX, LPRNG
    43274340    or PLP :</code></p><p><code class="literal">print command = lpr -r -P%p %s</code></p><p>For <code class="literal">printing = SYSV or HPUX :</code></p><p><code class="literal">print command = lp -c -d%p %s; rm %s</code></p><p>For <code class="literal">printing = SOFTQ :</code></p><p><code class="literal">print command = lp -d%p -s %s; rm %s</code></p><p>For printing = CUPS :   If SAMBA is compiled against
    4328     libcups, then <a class="link" href="smb.conf.5.html#PRINTCAP">printcap = cups</a>
     4341    libcups, then <a class="link" href="smb.conf.5.html#PRINTCAP" target="_top">printcap = cups</a>
    43294342    uses the CUPS API to
    43304343    submit jobs, etc.  Otherwise it maps to the System V
    … …  
    43354348        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>
    43364349</em></span>
    4337 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id321311"></a>
     4350</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555527"></a>
    43384351
    43394352printer admin (S)
    4340 </h3></div></div></div><a class="indexterm" name="id321312"></a><a name="PRINTERADMIN"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4353</h3></div></div></div><a class="indexterm" name="id2555528"></a><a name="PRINTERADMIN"></a><div class="variablelist"><dl><dt></dt><dd><p>
    43414354        This lists users who can do anything to printers
    43424355        via the remote administration interfaces offered
    … …  
    43544367</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printer admin</code></em> = <code class="literal">admin, @staff</code>
    43554368</em></span>
    4356 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id321375"></a>
     4369</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555596"></a>
    43574370
    43584371<a name="PRINTER"></a>printer
    4359 </h3></div></div></div><a class="indexterm" name="id321376"></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="id321406"></a>
     4372</h3></div></div></div><a class="indexterm" name="id2555597"></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="id2555628"></a>
    43604373
    43614374printer name (S)
    4362 </h3></div></div></div><a class="indexterm" name="id321407"></a><a name="PRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4375</h3></div></div></div><a class="indexterm" name="id2555629"></a><a name="PRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    43634376        This parameter specifies the name of the printer to which print jobs spooled through a printable service
    43644377        will be sent.
    … …  
    43674380        does not have its own printer name specified.
    43684381        </p><p>
    4369         The default value of the <a class="link" href="smb.conf.5.html#PRINTERNAME">printer name</a> may be <code class="literal">lp</code> on many
     4382        The default value of the <a class="link" href="smb.conf.5.html#PRINTERNAME" target="_top">printer name</a> may be <code class="literal">lp</code> on many
    43704383        systems.
    43714384        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>printer name</code></em> = <code class="literal">none</code>
    … …  
    43734386</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printer name</code></em> = <code class="literal">laserwriter</code>
    43744387</em></span>
    4375 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id321489"></a>
     4388</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555716"></a>
    43764389
    43774390printing (S)
    4378 </h3></div></div></div><a class="indexterm" name="id321490"></a><a name="PRINTING"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters controls how printer status  information is
     4391</h3></div></div></div><a class="indexterm" name="id2555717"></a><a name="PRINTING"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters controls how printer status  information is
    43794392    interpreted on your system. It also affects the  default values for
    43804393    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
    … …  
    43904403    the value for the <em class="parameter"><code>printing</code></em> option since it will
    43914404    reset the printing commands to default values.</p><p>See also the discussion in the <a class="link" href="#PRINTERSSECT" title="The [printers] section">
    4392     [printers]</a> section.</p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id321618"></a>
     4405    [printers]</a> section.</p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555851"></a>
    43934406
    43944407printjob username (S)
    4395 </h3></div></div></div><a class="indexterm" name="id321619"></a><a name="PRINTJOBUSERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies which user information will be
     4408</h3></div></div></div><a class="indexterm" name="id2555852"></a><a name="PRINTJOBUSERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies which user information will be
    43964409    passed to the printing system. Usually, the username is sent,
    43974410    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>
    … …  
    43994412</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printjob username</code></em> = <code class="literal">%D\%U</code>
    44004413</em></span>
    4401 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id321676"></a>
     4414</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555913"></a>
    44024415
    44034416private dir (G)
    4404 </h3></div></div></div><a class="indexterm" name="id321678"></a><a name="PRIVATEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters defines the directory
     4417</h3></div></div></div><a class="indexterm" name="id2555914"></a><a name="PRIVATEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters defines the directory
    44054418    smbd will use for storing such files as <code class="filename">smbpasswd</code>
    44064419    and <code class="filename">secrets.tdb</code>.
    44074420</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>private dir</code></em> = <code class="literal">${prefix}/private</code>
    44084421</em></span>
    4409 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id321730"></a>
     4422</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555967"></a>
    44104423
    44114424profile acls (S)
    4412 </h3></div></div></div><a class="indexterm" name="id321731"></a><a name="PROFILEACLS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4425</h3></div></div></div><a class="indexterm" name="id2555968"></a><a name="PROFILEACLS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    44134426        This boolean parameter was added to fix the problems that people have been
    44144427        having with storing user profiles on Samba shares from Windows 2000 or
    … …  
    44384451        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>profile acls</code></em> = <code class="literal">no</code>
    44394452</em></span>
    4440 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id321793"></a>
     4453</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556047"></a>
    44414454
    44424455queuepause command (S)
    4443 </h3></div></div></div><a class="indexterm" name="id321794"></a><a name="QUEUEPAUSECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     4456</h3></div></div></div><a class="indexterm" name="id2556048"></a><a name="QUEUEPAUSECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    44444457    executed on the server host in order to pause the printer queue.</p><p>This command should be a program or script which takes
    44454458    a printer name as its only parameter and stops the printer queue,
    … …  
    44524465        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>
    44534466</em></span>
    4454 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id321863"></a>
     4467</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556124"></a>
    44554468
    44564469queueresume command (S)
    4457 </h3></div></div></div><a class="indexterm" name="id321864"></a><a name="QUEUERESUMECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     4470</h3></div></div></div><a class="indexterm" name="id2556125"></a><a name="QUEUERESUMECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    44584471    executed on the server host in order to resume the printer queue. It
    44594472    is the command to undo the behavior that is caused by the
    4460     previous parameter (<a class="link" href="smb.conf.5.html#QUEUEPAUSECOMMAND">queuepause command</a>).</p><p>This command should be a program or script which takes
     4473    previous parameter (<a class="link" href="smb.conf.5.html#QUEUEPAUSECOMMAND" target="_top">queuepause command</a>).</p><p>This command should be a program or script which takes
    44614474    a printer name as its only parameter and resumes the printer queue,
    44624475    such that queued jobs are resubmitted to the printer.</p><p>This command is not supported by Windows for Workgroups,
    … …  
    44704483</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>queueresume command</code></em> = <code class="literal">enable %p</code>
    44714484</em></span>
    4472 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id321956"></a>
     4485</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556227"></a>
    44734486
    44744487read bmpx (G)
    4475 </h3></div></div></div><a class="indexterm" name="id321957"></a><a name="READBMPX"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether
     4488</h3></div></div></div><a class="indexterm" name="id2556228"></a><a name="READBMPX"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether
    44764489    <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will support the "Read
    44774490    Block Multiplex" SMB. This is now rarely used and defaults to
    … …  
    44794492        parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>read bmpx</code></em> = <code class="literal">no</code>
    44804493</em></span>
    4481 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id322008"></a>
     4494</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556282"></a>
    44824495
    44834496read list (S)
    4484 </h3></div></div></div><a class="indexterm" name="id322010"></a><a name="READLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4497</h3></div></div></div><a class="indexterm" name="id2556283"></a><a name="READLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
    44854498        This is a list of users that are given read-only access to a service. If the connecting user is in this list
    4486         then they will not be given write access, no matter what the <a class="link" href="smb.conf.5.html#READONLY">read only</a> option is set
    4487         to. The list can include group names using the syntax described in the <a class="link" href="smb.conf.5.html#INVALIDUSERS">invalid users</a>
     4499        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
     4500        to. The list can include group names using the syntax described in the <a class="link" href="smb.conf.5.html#INVALIDUSERS" target="_top">invalid users</a>
    44884501        parameter.
    4489         </p><p>This parameter will not work with the <a class="link" href="smb.conf.5.html#SECURITY">security = share</a> in
     4502        </p><p>This parameter will not work with the <a class="link" href="smb.conf.5.html#SECURITY" target="_top">security = share</a> in
    44904503    Samba 3.0.  This is by design.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>read list</code></em> = <code class="literal"></code>
    44914504</em></span>
    44924505</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>read list</code></em> = <code class="literal">mary, @students</code>
    44934506</em></span>
    4494 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id322102"></a>
     4507</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556381"></a>
    44954508
    44964509read only (S)
    4497 </h3></div></div></div><a class="indexterm" name="id322104"></a><a name="READONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>An inverted synonym is <a class="link" href="smb.conf.5.html#WRITEABLE">writeable</a>.</p><p>If this parameter is <code class="constant">yes</code>, then users
     4510</h3></div></div></div><a class="indexterm" name="id2556382"></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
    44984511    of a service may not create or modify files in the service's
    44994512    directory.</p><p>Note that a printable service (<code class="literal">printable = yes</code>)
    … …  
    45014514    (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>
    45024515</em></span>
    4503 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id322175"></a>
     4516</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556458"></a>
    45044517
    45054518read raw (G)
    4506 </h3></div></div></div><a class="indexterm" name="id322176"></a><a name="READRAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
     4519</h3></div></div></div><a class="indexterm" name="id2556459"></a><a name="READRAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
    45074520    will support the raw read SMB requests when transferring data
    45084521    to clients.</p><p>If enabled, raw reads allow reads of 65535 bytes in
    … …  
    45134526        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>
    45144527</em></span>
    4515 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id322230"></a>
     4528</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556518"></a>
    45164529
    45174530realm (G)
    4518 </h3></div></div></div><a class="indexterm" name="id322231"></a><a name="REALM"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the kerberos realm to use. The realm is
     4531</h3></div></div></div><a class="indexterm" name="id2556519"></a><a name="REALM"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the kerberos realm to use. The realm is
    45194532        used as the ADS equivalent of the NT4 <code class="literal">domain</code>. It
    45204533        is usually set to the DNS name of the kerberos server.
    … …  
    45234536</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>realm</code></em> = <code class="literal">mysambabox.mycompany.com</code>
    45244537</em></span>
    4525 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id322294"></a>
     4538</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556583"></a>
    45264539
    45274540remote announce (G)
    4528 </h3></div></div></div><a class="indexterm" name="id322295"></a><a name="REMOTEANNOUNCE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4541</h3></div></div></div><a class="indexterm" name="id2556584"></a><a name="REMOTEANNOUNCE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    45294542        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
    45304543        to arbitrary IP addresses with an arbitrary workgroup name.
    … …  
    45404553        the above line would cause <code class="literal">nmbd</code> to announce itself
    45414554        to the two given IP addresses using the given workgroup names. If you leave out the
    4542         workgroup name then the one given in the <a class="link" href="smb.conf.5.html#WORKGROUP">workgroup</a> parameter
     4555        workgroup name then the one given in the <a class="link" href="smb.conf.5.html#WORKGROUP" target="_top">workgroup</a> parameter
    45434556        is used instead.
    45444557        </p><p>
    … …  
    45504563        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>remote announce</code></em> = <code class="literal"></code>
    45514564</em></span>
    4552 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id322389"></a>
     4565</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556688"></a>
    45534566
    45544567remote browse sync (G)
    4555 </h3></div></div></div><a class="indexterm" name="id322390"></a><a name="REMOTEBROWSESYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4568</h3></div></div></div><a class="indexterm" name="id2556689"></a><a name="REMOTEBROWSESYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    45564569        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
    45574570        synchronization of browse lists with the master browser of a Samba
    … …  
    45804593        is in fact the browse master on its segment.
    45814594        </p><p>
    4582         The <a class="link" href="smb.conf.5.html#REMOTEBROWSESYNC">remote browse sync</a> may be used on networks
     4595        The <a class="link" href="smb.conf.5.html#REMOTEBROWSESYNC" target="_top">remote browse sync</a> may be used on networks
    45834596        where there is no WINS server, and may be used on disjoint networks where
    45844597        each network has its own WINS server.
    45854598        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>remote browse sync</code></em> = <code class="literal"></code>
    45864599</em></span>
    4587 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id322489"></a>
     4600</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556800"></a>
    45884601
    45894602rename user script (G)
    4590 </h3></div></div></div><a class="indexterm" name="id322490"></a><a name="RENAMEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4603</h3></div></div></div><a class="indexterm" name="id2556802"></a><a name="RENAMEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    45914604        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.
    45924605        </p><p>
    … …  
    46064619        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>rename user script</code></em> = <code class="literal">no</code>
    46074620</em></span>
    4608 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id322568"></a>
     4621</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556891"></a>
    46094622
    46104623reset on zero vc (G)
    4611 </h3></div></div></div><a class="indexterm" name="id322569"></a><a name="RESETONZEROVC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4624</h3></div></div></div><a class="indexterm" name="id2556892"></a><a name="RESETONZEROVC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    46124625        This boolean option controls whether an incoming session setup
    46134626        should kill other connections coming from the same IP. This matches
    … …  
    46284641        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>reset on zero vc</code></em> = <code class="literal">no</code>
    46294642</em></span>
    4630 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id322614"></a>
     4643</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556944"></a>
    46314644
    46324645restrict anonymous (G)
    4633 </h3></div></div></div><a class="indexterm" name="id322615"></a><a name="RESTRICTANONYMOUS"></a><div class="variablelist"><dl><dt></dt><dd><p>The setting of this parameter determines whether user and
     4646</h3></div></div></div><a class="indexterm" name="id2556945"></a><a name="RESTRICTANONYMOUS"></a><div class="variablelist"><dl><dt></dt><dd><p>The setting of this parameter determines whether user and
    46344647    group list information is returned for an anonymous connection.
    46354648    and mirrors the effects of the
    … …  
    46514664        </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
    46524665    The security advantage of using restrict anonymous = 2 is removed
    4653     by setting <a class="link" href="smb.conf.5.html#GUESTOK">guest ok = yes</a> on any share.
     4666    by setting <a class="link" href="smb.conf.5.html#GUESTOK" target="_top">guest ok = yes</a> on any share.
    46544667        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>restrict anonymous</code></em> = <code class="literal">0</code>
    46554668</em></span>
    4656 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id322688"></a>
     4669</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557028"></a>
    46574670
    46584671<a name="ROOT"></a>root
    4659 </h3></div></div></div><a class="indexterm" name="id322689"></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="id322720"></a>
     4672</h3></div></div></div><a class="indexterm" name="id2557029"></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="id2557061"></a>
    46604673
    46614674<a name="ROOTDIR"></a>root dir
    4662 </h3></div></div></div><a class="indexterm" name="id322721"></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="id322751"></a>
     4675</h3></div></div></div><a class="indexterm" name="id2557062"></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="id2557092"></a>
    46634676
    46644677root directory (G)
    4665 </h3></div></div></div><a class="indexterm" name="id322752"></a><a name="ROOTDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>The server will <code class="literal">chroot()</code> (i.e.
     4678</h3></div></div></div><a class="indexterm" name="id2557093"></a><a name="ROOTDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>The server will <code class="literal">chroot()</code> (i.e.
    46664679    Change its root directory) to this directory on startup. This is
    46674680    not strictly necessary for secure operation. Even without it the
    … …  
    46704683    parts of the filesystem, or attempts to use ".." in file names
    46714684    to access other directories (depending on the setting of the
    4672         <a class="link" href="smb.conf.5.html#WIDESMBCONFOPTIONS">wide smbconfoptions</a> parameter).
     4685        <a class="link" href="smb.conf.5.html#WIDESMBCONFOPTIONS" target="_top">wide smbconfoptions</a> parameter).
    46734686    </p><p>Adding a <em class="parameter"><code>root directory</code></em> entry other
    46744687    than "/" adds an extra level of security, but at a price. It
    … …  
    46864699</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>root directory</code></em> = <code class="literal">/homes/smb</code>
    46874700</em></span>
    4688 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id322864"></a>
     4701</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557216"></a>
    46894702
    46904703root postexec (S)
    4691 </h3></div></div></div><a class="indexterm" name="id322865"></a><a name="ROOTPOSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4704</h3></div></div></div><a class="indexterm" name="id2557217"></a><a name="ROOTPOSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    46924705        This is the same as the <em class="parameter"><code>postexec</code></em>
    46934706        parameter except that the command is run as root. This is useful for
    … …  
    46954708        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>root postexec</code></em> = <code class="literal"></code>
    46964709</em></span>
    4697 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id322910"></a>
     4710</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557265"></a>
    46984711
    46994712root preexec close (S)
    4700 </h3></div></div></div><a class="indexterm" name="id322912"></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
     4713</h3></div></div></div><a class="indexterm" name="id2557266"></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
    47014714        </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>
    47024715</em></span>
    4703 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id322958"></a>
     4716</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557313"></a>
    47044717
    47054718root preexec (S)
    4706 </h3></div></div></div><a class="indexterm" name="id322959"></a><a name="ROOTPREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4719</h3></div></div></div><a class="indexterm" name="id2557314"></a><a name="ROOTPREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    47074720        This is the same as the <em class="parameter"><code>preexec</code></em>
    47084721        parameter except that the command is run as root. This is useful for
    … …  
    47104723        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>root preexec</code></em> = <code class="literal"></code>
    47114724</em></span>
    4712 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id323004"></a>
     4725</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557362"></a>
    47134726
    47144727security mask (S)
    4715 </h3></div></div></div><a class="indexterm" name="id323005"></a><a name="SECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4728</h3></div></div></div><a class="indexterm" name="id2557363"></a><a name="SECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
    47164729        This parameter controls what UNIX permission bits will be set when a Windows NT client is manipulating the
    47174730        UNIX permission on a file using the native NT security dialog box.
    47184731        </p><p>
    47194732        This parameter is applied as a mask (AND'ed with) to the incoming permission bits, thus resetting
    4720         any bits not in this mask. Make sure not to mix up this parameter with <a class="link" href="smb.conf.5.html#FORCESECURITYMODE">force  security mode</a>, which works in a manner similar to this one but uses a logical OR instead of an AND.
     4733        any bits not in this mask. Make sure not to mix up this parameter with <a class="link" href="smb.conf.5.html#FORCESECURITYMODE" target="_top">force  security mode</a>, which works in a manner similar to this one but uses a logical OR instead of an AND.
    47214734        </p><p>
    47224735        Essentially, all bits set to zero in this mask will result in setting to zero the corresponding bits on the
    … …  
    47324745</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>security mask</code></em> = <code class="literal">0770</code>
    47334746</em></span>
    4734 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id323100"></a>
     4747</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557468"></a>
    47354748
    47364749security (G)
    4737 </h3></div></div></div><a class="indexterm" name="id323101"></a><a name="SECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option affects how clients respond to
     4750</h3></div></div></div><a class="indexterm" name="id2557469"></a><a name="SECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option affects how clients respond to
    47384751    Samba and is one of the most important settings in the <code class="filename">
    47394752    smb.conf</code> file.</p><p>The option sets the "security mode bit" in replies to
    … …  
    47594772    is commonly used for a shared printer server. It is more difficult
    47604773    to setup guest shares with <code class="literal">security = user</code>, see
    4761     the <a class="link" href="smb.conf.5.html#MAPTOGUEST">map to guest</a>parameter for details.</p><p>It is possible to use <code class="literal">smbd</code> in a <span class="emphasis"><em>
     4774    the <a class="link" href="smb.conf.5.html#MAPTOGUEST" target="_top">map to guest</a>parameter for details.</p><p>It is possible to use <code class="literal">smbd</code> in a <span class="emphasis"><em>
    47624775    hybrid mode</em></span> where it is offers both user and share
    4763     level security under different <a class="link" href="smb.conf.5.html#NETBIOSALIASES">NetBIOS aliases</a>. </p><p>The different settings will now be explained.</p><p><a name="SECURITYEQUALSSHARE"></a><span class="emphasis"><em>SECURITY = SHARE</em></span></p><p>When clients connect to a share level security server they
     4776    level security under different <a class="link" href="smb.conf.5.html#NETBIOSALIASES" target="_top">NetBIOS aliases</a>. </p><p>The different settings will now be explained.</p><p><a name="SECURITYEQUALSSHARE"></a><span class="emphasis"><em>SECURITY = SHARE</em></span></p><p>When clients connect to a share level security server they
    47644777    need not log onto the server with a valid username and password before
    47654778    attempting to connect to a shared resource (although modern clients
    … …  
    47744787    techniques to determine the correct UNIX user to use on behalf
    47754788    of the client.</p><p>A list of possible UNIX usernames to match with the given
    4776     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">guest only</a> parameter is set, then all the other
    4777             stages are missed and only the <a class="link" href="smb.conf.5.html#GUESTACCOUNT">guest account</a> username is checked.
     4789    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
     4790            stages are missed and only the <a class="link" href="smb.conf.5.html#GUESTACCOUNT" target="_top">guest account</a> username is checked.
    47784791            </p></li><li><p>Is a username is sent with the share connection
    4779             request, then this username (after mapping - see <a class="link" href="smb.conf.5.html#USERNAMEMAP">username map</a>),
     4792            request, then this username (after mapping - see <a class="link" href="smb.conf.5.html#USERNAMEMAP" target="_top">username map</a>),
    47804793            is added as a potential username.
    47814794            </p></li><li><p>If the client did a previous <span class="emphasis"><em>logon
    … …  
    47864799            </p></li><li><p>The NetBIOS name of the client is added to
    47874800            the list as a potential username.
    4788             </p></li><li><p>Any users on the <a class="link" href="smb.conf.5.html#USER">user</a> list are added as potential usernames.
     4801            </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.
    47894802            </p></li></ul></div><p>If the <em class="parameter"><code>guest only</code></em> parameter is
    47904803    not set, then this list is then tried with the supplied password.
    … …  
    47984811    NOTE ABOUT USERNAME/PASSWORD VALIDATION</a>.</p><p><a name="SECURITYEQUALSUSER"></a><span class="emphasis"><em>SECURITY = USER</em></span></p><p>This is the default security setting in Samba 3.0.
    47994812    With user-level security a client must first "log-on" with a
    4800     valid username and password (which can be mapped using the <a class="link" href="smb.conf.5.html#USERNAMEMAP">username map</a>
    4801     parameter). Encrypted passwords (see the <a class="link" href="smb.conf.5.html#ENCRYPTEDPASSWORDS">encrypted passwords</a> parameter) can also
    4802     be used in this security mode. Parameters such as <a class="link" href="smb.conf.5.html#USER">user</a> and <a class="link" href="smb.conf.5.html#GUESTONLY">guest only</a> if set   are then applied and
     4813    valid username and password (which can be mapped using the <a class="link" href="smb.conf.5.html#USERNAMEMAP" target="_top">username map</a>
     4814    parameter). Encrypted passwords (see the <a class="link" href="smb.conf.5.html#ENCRYPTEDPASSWORDS" target="_top">encrypted passwords</a> parameter) can also
     4815    be used in this security mode. Parameters such as <a class="link" href="smb.conf.5.html#USER" target="_top">user</a> and <a class="link" href="smb.conf.5.html#GUESTONLY" target="_top">guest only</a> if set       are then applied and
    48034816    may change the UNIX user to use on this connection, but only after
    48044817    the user has been successfully authenticated.</p><p><span class="emphasis"><em>Note</em></span> that the name of the resource being
    … …  
    48064819    the server has successfully authenticated the client. This is why
    48074820    guest shares don't work in user level security without allowing
    4808     the server to automatically map unknown users into the <a class="link" href="smb.conf.5.html#GUESTACCOUNT">guest account</a>.
    4809     See the <a class="link" href="smb.conf.5.html#MAPTOGUEST">map to guest</a> parameter for details on doing this.</p><p>See also the section <a class="link" href="#VALIDATIONSECT" title="NOTE ABOUT USERNAME/PASSWORD VALIDATION">NOTE ABOUT USERNAME/PASSWORD VALIDATION</a>.</p><p><a name="SECURITYEQUALSDOMAIN"></a><span class="emphasis"><em>SECURITY = DOMAIN</em></span></p><p>This mode will only work correctly if <a class="citerefentry" href="net.8.html"><span class="citerefentry"><span class="refentrytitle">net</span>(8)</span></a> has been used to add this
    4810     machine into a Windows NT Domain. It expects the <a class="link" href="smb.conf.5.html#ENCRYPTEDPASSWORDS">encrypted passwords</a>
     4821    the server to automatically map unknown users into the <a class="link" href="smb.conf.5.html#GUESTACCOUNT" target="_top">guest account</a>.
     4822    See the <a class="link" href="smb.conf.5.html#MAPTOGUEST" target="_top">map to guest</a> parameter for details on doing this.</p><p>See also the section <a class="link" href="#VALIDATIONSECT" title="NOTE ABOUT USERNAME/PASSWORD VALIDATION">NOTE ABOUT USERNAME/PASSWORD VALIDATION</a>.</p><p><a name="SECURITYEQUALSDOMAIN"></a><span class="emphasis"><em>SECURITY = DOMAIN</em></span></p><p>This mode will only work correctly if <a class="citerefentry" href="net.8.html"><span class="citerefentry"><span class="refentrytitle">net</span>(8)</span></a> has been used to add this
     4823    machine into a Windows NT Domain. It expects the <a class="link" href="smb.conf.5.html#ENCRYPTEDPASSWORDS" target="_top">encrypted passwords</a>
    48114824        parameter to be set to <code class="constant">yes</code>. In this
    48124825    mode Samba will try to validate the username/password by passing
    … …  
    48224835    the server has successfully authenticated the client. This is why
    48234836    guest shares don't work in user level security without allowing
    4824     the server to automatically map unknown users into the <a class="link" href="smb.conf.5.html#GUESTACCOUNT">guest account</a>.
    4825     See the <a class="link" href="smb.conf.5.html#MAPTOGUEST">map to guest</a> parameter for details on doing this.</p><p>See also the section <a class="link" href="#VALIDATIONSECT" title="NOTE ABOUT USERNAME/PASSWORD VALIDATION">
    4826     NOTE ABOUT USERNAME/PASSWORD VALIDATION</a>.</p><p>See also the <a class="link" href="smb.conf.5.html#PASSWORDSERVER">password server</a> parameter and
    4827          the <a class="link" href="smb.conf.5.html#ENCRYPTEDPASSWORDS">encrypted passwords</a> parameter.</p><p><a name="SECURITYEQUALSSERVER"></a><span class="emphasis"><em>SECURITY = SERVER</em></span></p><p>
     4837    the server to automatically map unknown users into the <a class="link" href="smb.conf.5.html#GUESTACCOUNT" target="_top">guest account</a>.
     4838    See the <a class="link" href="smb.conf.5.html#MAPTOGUEST" target="_top">map to guest</a> parameter for details on doing this.</p><p>See also the section <a class="link" href="#VALIDATIONSECT" title="NOTE ABOUT USERNAME/PASSWORD VALIDATION">
     4839    NOTE ABOUT USERNAME/PASSWORD VALIDATION</a>.</p><p>See also the <a class="link" href="smb.conf.5.html#PASSWORDSERVER" target="_top">password server</a> parameter and
     4840         the <a class="link" href="smb.conf.5.html#ENCRYPTEDPASSWORDS" target="_top">encrypted passwords</a> parameter.</p><p><a name="SECURITYEQUALSSERVER"></a><span class="emphasis"><em>SECURITY = SERVER</em></span></p><p>
    48284841        In this mode Samba will try to validate the username/password by passing it to another SMB server, such as an
    48294842        NT box. If this fails it will revert to <code class="literal">security = user</code>. It expects the
    4830         <a class="link" href="smb.conf.5.html#ENCRYPTEDPASSWORDS">encrypted passwords</a> parameter to be set to <code class="constant">yes</code>, unless the remote
     4843        <a class="link" href="smb.conf.5.html#ENCRYPTEDPASSWORDS" target="_top">encrypted passwords</a> parameter to be set to <code class="constant">yes</code>, unless the remote
    48314844        server does not support them.  However note that if encrypted passwords have been negotiated then Samba cannot
    48324845        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
    … …  
    48484861    the server has successfully authenticated the client. This is why
    48494862    guest shares don't work in user level security without allowing
    4850     the server to automatically map unknown users into the <a class="link" href="smb.conf.5.html#GUESTACCOUNT">guest account</a>.
    4851     See the <a class="link" href="smb.conf.5.html#MAPTOGUEST">map to guest</a> parameter for details on doing this.</p><p>See also the section <a class="link" href="#VALIDATIONSECT" title="NOTE ABOUT USERNAME/PASSWORD VALIDATION">
    4852     NOTE ABOUT USERNAME/PASSWORD VALIDATION</a>.</p><p>See also the <a class="link" href="smb.conf.5.html#PASSWORDSERVER">password server</a> parameter and the
    4853         <a class="link" href="smb.conf.5.html#ENCRYPTEDPASSWORDS">encrypted passwords</a> parameter.</p><p><a name="SECURITYEQUALSADS"></a><span class="emphasis"><em>SECURITY = ADS</em></span></p><p>In this mode, Samba will act as a domain member in an ADS realm. To operate
     4863    the server to automatically map unknown users into the <a class="link" href="smb.conf.5.html#GUESTACCOUNT" target="_top">guest account</a>.
     4864    See the <a class="link" href="smb.conf.5.html#MAPTOGUEST" target="_top">map to guest</a> parameter for details on doing this.</p><p>See also the section <a class="link" href="#VALIDATIONSECT" title="NOTE ABOUT USERNAME/PASSWORD VALIDATION">
     4865    NOTE ABOUT USERNAME/PASSWORD VALIDATION</a>.</p><p>See also the <a class="link" href="smb.conf.5.html#PASSWORDSERVER" target="_top">password server</a> parameter and the
     4866        <a class="link" href="smb.conf.5.html#ENCRYPTEDPASSWORDS" target="_top">encrypted passwords</a> parameter.</p><p><a name="SECURITYEQUALSADS"></a><span class="emphasis"><em>SECURITY = ADS</em></span></p><p>In this mode, Samba will act as a domain member in an ADS realm. To operate
    48544867                in this mode, the machine running Samba will need to have Kerberos installed
    48554868                and configured and Samba will need to be joined to the ADS realm using the
    … …  
    48594872</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>security</code></em> = <code class="literal">DOMAIN</code>
    48604873</em></span>
    4861 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id323887"></a>
     4874</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558347"></a>
    48624875
    48634876server schannel (G)
    4864 </h3></div></div></div><a class="indexterm" name="id323888"></a><a name="SERVERSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4877</h3></div></div></div><a class="indexterm" name="id2558348"></a><a name="SERVERSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    48654878        This controls whether the server offers or even demands the use of the netlogon schannel.
    4866         <a class="link" href="smb.conf.5.html#SERVERSCHANNEL">server schannel = no</a> does not offer the schannel, <a class="link" href="smb.conf.5.html#SERVERSCHANNEL">server schannel = auto</a> offers the schannel but does not enforce it, and <a class="link" href="smb.conf.5.html#SERVERSCHANNEL">server schannel = yes</a> denies access if the client is not able to speak netlogon schannel.
     4879        <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.
    48674880        This is only the case for Windows NT4 before SP4.
    48684881        </p><p>
    … …  
    48734886</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>server schannel</code></em> = <code class="literal">yes</code>
    48744887</em></span>
    4875 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id323995"></a>
     4888</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558463"></a>
    48764889
    48774890server signing (G)
    4878 </h3></div></div></div><a class="indexterm" name="id323996"></a><a name="SERVERSIGNING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether the server offers or requires
     4891</h3></div></div></div><a class="indexterm" name="id2558464"></a><a name="SERVERSIGNING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether the server offers or requires
    48794892    the client it talks to to use SMB signing. Possible values
    48804893    are <span class="emphasis"><em>auto</em></span>, <span class="emphasis"><em>mandatory</em></span>
    … …  
    48844897        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>
    48854898</em></span>
    4886 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id324052"></a>
     4899</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558524"></a>
    48874900
    48884901server string (G)
    4889 </h3></div></div></div><a class="indexterm" name="id324053"></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
     4902</h3></div></div></div><a class="indexterm" name="id2558525"></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
    48904903        manager and next to the IPC connection in <code class="literal">net view</code>. It
    48914904        can be any string that you wish to show to your users.</p><p>It also sets what will appear in browse lists next
    … …  
    48964909</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>server string</code></em> = <code class="literal">University of GNUs Samba Server</code>
    48974910</em></span>
    4898 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id324140"></a>
     4911</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558615"></a>
    48994912
    49004913set directory (S)
    4901 </h3></div></div></div><a class="indexterm" name="id324141"></a><a name="SETDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4914</h3></div></div></div><a class="indexterm" name="id2558616"></a><a name="SETDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    49024915        If <code class="literal">set directory = no</code>, then        users of the
    49034916        service may not use the setdir command to change directory.
    … …  
    49084921        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>set directory</code></em> = <code class="literal">no</code>
    49094922</em></span>
    4910 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id324197"></a>
     4923</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558675"></a>
    49114924
    49124925set primary group script (G)
    4913 </h3></div></div></div><a class="indexterm" name="id324198"></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
     4926</h3></div></div></div><a class="indexterm" name="id2558676"></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
    49144927        primary group in addition to the auxiliary groups.  This script
    49154928        sets the primary group in the unix userdatase when an
    … …  
    49234936</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>
    49244937</em></span>
    4925 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id324275"></a>
     4938</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558757"></a>
    49264939
    49274940set quota command (G)
    4928 </h3></div></div></div><a class="indexterm" name="id324276"></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
     4941</h3></div></div></div><a class="indexterm" name="id2558758"></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
    49294942        whenever there is no operating system API available from the OS that
    49304943        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
    … …  
    49364949</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>
    49374950</em></span>
    4938 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id324428"></a>
     4951</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558921"></a>
    49394952
    49404953share modes (S)
    4941 </h3></div></div></div><a class="indexterm" name="id324429"></a><a name="SHAREMODES"></a><div class="variablelist"><dl><dt></dt><dd><p>This enables or disables the honoring of
     4954</h3></div></div></div><a class="indexterm" name="id2558922"></a><a name="SHAREMODES"></a><div class="variablelist"><dl><dt></dt><dd><p>This enables or disables the honoring of
    49424955        the <em class="parameter"><code>share modes</code></em> during a file open. These
    49434956        modes are used by clients to gain exclusive read or write access
    … …  
    49524965        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>
    49534966</em></span>
    4954 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id324516"></a>
     4967</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559014"></a>
    49554968
    49564969short preserve case (S)
    4957 </h3></div></div></div><a class="indexterm" name="id324517"></a><a name="SHORTPRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4970</h3></div></div></div><a class="indexterm" name="id2559015"></a><a name="SHORTPRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    49584971        This boolean parameter controls if new files which conform to 8.3 syntax, that is all in upper case and of
    4959         suitable length, are created upper case, or if they are forced to be the <a class="link" href="smb.conf.5.html#DEFAULTCASE">default case</a>.
    4960         This  option can be use with <a class="link" href="smb.conf.5.html#PRESERVECASE">preserve case = yes</a> to permit long filenames
     4972        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>.
     4973        This  option can be use with <a class="link" href="smb.conf.5.html#PRESERVECASE" target="_top">preserve case = yes</a> to permit long filenames
    49614974        to retain their case, while short names are lowered.
    49624975        </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>
    49634976</em></span>
    4964 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id324590"></a>
     4977</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559094"></a>
    49654978
    49664979show add printer wizard (G)
    4967 </h3></div></div></div><a class="indexterm" name="id324591"></a><a name="SHOWADDPRINTERWIZARD"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printing support
     4980</h3></div></div></div><a class="indexterm" name="id2559095"></a><a name="SHOWADDPRINTERWIZARD"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printing support
    49684981    for Windows NT/2000 client in Samba 2.2, a "Printers..." folder will
    49694982    appear on Samba hosts in the share listing.  Normally this folder will
    … …  
    49834996                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>
    49844997</em></span>
    4985 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id324663"></a>
     4998</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559177"></a>
    49864999
    49875000shutdown script (G)
    4988 </h3></div></div></div><a class="indexterm" name="id324664"></a><a name="SHUTDOWNSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This a full path name to a script called by
     5001</h3></div></div></div><a class="indexterm" name="id2559178"></a><a name="SHUTDOWNSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This a full path name to a script called by
    49895002         <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> that should
    49905003        start a shutdown procedure.</p><p>If the connected user posseses the <code class="constant">SeRemoteShutdownPrivilege</code>,
    … …  
    50115024</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>
    50125025</em></span>
    5013 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id324808"></a>
     5026</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559330"></a>
    50145027
    50155028smb passwd file (G)
    5016 </h3></div></div></div><a class="indexterm" name="id324810"></a><a name="SMBPASSWDFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option sets the path to the encrypted smbpasswd file. By
     5029</h3></div></div></div><a class="indexterm" name="id2559331"></a><a name="SMBPASSWDFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option sets the path to the encrypted smbpasswd file. By
    50175030    default the path to the smbpasswd file  is compiled into Samba.</p><p>
    50185031    An example of use is:
    … …  
    50225035    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>smb passwd file</code></em> = <code class="literal">${prefix}/private/smbpasswd</code>
    50235036</em></span>
    5024 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id324860"></a>
     5037</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559385"></a>
    50255038
    50265039smb ports (G)
    5027 </h3></div></div></div><a class="indexterm" name="id324861"></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>
    5028 </em></span>
    5029 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id324901"></a>
     5040</h3></div></div></div><a class="indexterm" name="id2559386"></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>
     5041</em></span>
     5042</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559426"></a>
    50305043
    50315044socket address (G)
    5032 </h3></div></div></div><a class="indexterm" name="id324902"></a><a name="SOCKETADDRESS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to control what
    5033         address Samba will listen for connections on. This is used to
    5034         support multiple virtual interfaces on the one server, each
    5035         with a different configuration.</p><p>By default Samba will accept connections on any
     5045</h3></div></div></div><a class="indexterm" name="id2559427"></a><a name="SOCKETADDRESS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to control what
     5046        address Samba will listen for connections on. This is used to
     5047        support multiple virtual interfaces on the one server, each
     5048        with a different configuration.</p><p>Setting this option should never be necessary on usual Samba
     5049        servers running only one nmbd.</p><p>By default Samba will accept connections on any
    50365050                address.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>socket address</code></em> = <code class="literal"></code>
    50375051</em></span>
    50385052</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>socket address</code></em> = <code class="literal">192.168.2.20</code>
    50395053</em></span>
    5040 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id324963"></a>
     5054</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559497"></a>
    50415055
    50425056socket options (G)
    5043 </h3></div></div></div><a class="indexterm" name="id324964"></a><a name="SOCKETOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to set socket options
     5057</h3></div></div></div><a class="indexterm" name="id2559498"></a><a name="SOCKETOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to set socket options
    50445058    to be used when talking with the client.</p><p>Socket options are controls on the networking layer
    50455059    of the operating systems which allow the connection to be
    … …  
    50695083</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>socket options</code></em> = <code class="literal">IPTOS_LOWDELAY</code>
    50705084</em></span>
    5071 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id325156"></a>
     5085</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559707"></a>
    50725086
    50735087stat cache (G)
    5074 </h3></div></div></div><a class="indexterm" name="id325157"></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
     5088</h3></div></div></div><a class="indexterm" name="id2559708"></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
    50755089        speed up case insensitive name mappings. You should never need
    50765090        to change this parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>stat cache</code></em> = <code class="literal">yes</code>
    50775091</em></span>
    5078 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id325205"></a>
     5092</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559758"></a>
    50795093
    50805094store dos attributes (S)
    5081 </h3></div></div></div><a class="indexterm" name="id325206"></a><a name="STOREDOSATTRIBUTES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5095</h3></div></div></div><a class="indexterm" name="id2559759"></a><a name="STOREDOSATTRIBUTES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    50825096        If this parameter is set Samba attempts to first read DOS attributes (SYSTEM, HIDDEN, ARCHIVE or
    50835097        READ-ONLY) from a filesystem extended attribute, before mapping DOS attributes to UNIX permission bits (such
    5084         as occurs with <a class="link" href="smb.conf.5.html#MAPHIDDEN">map hidden</a> and <a class="link" href="smb.conf.5.html#MAPREADONLY">map readonly</a>).  When set, DOS
     5098        as occurs with <a class="link" href="smb.conf.5.html#MAPHIDDEN" target="_top">map hidden</a> and <a class="link" href="smb.conf.5.html#MAPREADONLY" target="_top">map readonly</a>).  When set, DOS
    50855099        attributes will be stored onto an extended attribute in the UNIX filesystem, associated with the file or
    5086         directory.  For no other mapping to occur as a fall-back, the parameters <a class="link" href="smb.conf.5.html#MAPHIDDEN">map hidden</a>,
    5087         <a class="link" href="smb.conf.5.html#MAPSYSTEM">map system</a>, <a class="link" href="smb.conf.5.html#MAPARCHIVE">map archive</a> and <a class="link" href="smb.conf.5.html#MAPREADONLY">map  readonly</a> must be set to off.  This parameter writes the DOS attributes as a string into the extended
     5100        directory.  For no other mapping to occur as a fall-back, the parameters <a class="link" href="smb.conf.5.html#MAPHIDDEN" target="_top">map hidden</a>,
     5101        <a class="link" href="smb.conf.5.html#MAPSYSTEM" target="_top">map system</a>, <a class="link" href="smb.conf.5.html#MAPARCHIVE" target="_top">map archive</a> and <a class="link" href="smb.conf.5.html#MAPREADONLY" target="_top">map  readonly</a> must be set to off.  This parameter writes the DOS attributes as a string into the extended
    50885102        attribute named "user.DOSATTRIB". This extended attribute is explicitly hidden from smbd clients requesting an
    50895103        EA list. On Linux the filesystem must have been mounted with the mount option user_xattr in order for
    … …  
    50915105        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>store dos attributes</code></em> = <code class="literal">no</code>
    50925106</em></span>
    5093 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id325316"></a>
     5107</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559880"></a>
    50945108
    50955109strict allocate (S)
    5096 </h3></div></div></div><a class="indexterm" name="id325317"></a><a name="STRICTALLOCATE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean that controls the handling of
     5110</h3></div></div></div><a class="indexterm" name="id2559881"></a><a name="STRICTALLOCATE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean that controls the handling of
    50975111    disk space allocation in the server. When this is set to <code class="constant">yes</code>
    50985112    the server will change from UNIX behaviour of not committing real
    … …  
    51065120    of users.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>strict allocate</code></em> = <code class="literal">no</code>
    51075121</em></span>
    5108 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id325379"></a>
     5122</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559950"></a>
    51095123
    51105124strict locking (S)
    5111 </h3></div></div></div><a class="indexterm" name="id325380"></a><a name="STRICTLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5125</h3></div></div></div><a class="indexterm" name="id2559951"></a><a name="STRICTLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
    51125126        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>,
    51135127        the server will check every read and write access for file locks, and deny access if locks exist. This can be slow on
    … …  
    51255139        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>strict locking</code></em> = <code class="literal">Auto</code>
    51265140</em></span>
    5127 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id325451"></a>
     5141</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560029"></a>
    51285142
    51295143strict sync (S)
    5130 </h3></div></div></div><a class="indexterm" name="id325452"></a><a name="STRICTSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>Many Windows applications (including the Windows 98 explorer
     5144</h3></div></div></div><a class="indexterm" name="id2560030"></a><a name="STRICTSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>Many Windows applications (including the Windows 98 explorer
    51315145    shell) seem to confuse flushing buffer contents to disk with doing
    51325146    a sync to disk. Under UNIX, a sync call forces the process to be
    … …  
    51425156    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>
    51435157</em></span>
    5144 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id325509"></a>
     5158</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560094"></a>
    51455159
    51465160svcctl list (G)
    5147 </h3></div></div></div><a class="indexterm" name="id325510"></a><a name="SVCCTLLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of init scripts that smbd
     5161</h3></div></div></div><a class="indexterm" name="id2560095"></a><a name="SVCCTLLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of init scripts that smbd
    51485162    will use for starting and stopping Unix services via the Win32
    51495163    ServiceControl API.  This allows Windows administrators to
    … …  
    51585172</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>svcctl list</code></em> = <code class="literal">cups postfix portmap httpd</code>
    51595173</em></span>
    5160 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id325590"></a>
     5174</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560179"></a>
    51615175
    51625176sync always (S)
    5163 </h3></div></div></div><a class="indexterm" name="id325591"></a><a name="SYNCALWAYS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls
     5177</h3></div></div></div><a class="indexterm" name="id2560180"></a><a name="SYNCALWAYS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls
    51645178    whether writes will always be written to stable storage before
    51655179    the write call returns. If this is <code class="constant">no</code> then the server will be
    … …  
    51725186    any affect.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>sync always</code></em> = <code class="literal">no</code>
    51735187</em></span>
    5174 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id325657"></a>
     5188</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560251"></a>
    51755189
    51765190syslog only (G)
    5177 </h3></div></div></div><a class="indexterm" name="id325658"></a><a name="SYSLOGONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5191</h3></div></div></div><a class="indexterm" name="id2560252"></a><a name="SYSLOGONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    51785192    If this parameter is set then Samba debug messages are logged into the system
    51795193    syslog only, and not to the debug log files. There still will be some
    … …  
    51815195    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>syslog only</code></em> = <code class="literal">no</code>
    51825196</em></span>
    5183 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id325702"></a>
     5197</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560298"></a>
    51845198
    51855199syslog (G)
    5186 </h3></div></div></div><a class="indexterm" name="id325703"></a><a name="SYSLOG"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5200</h3></div></div></div><a class="indexterm" name="id2560299"></a><a name="SYSLOG"></a><div class="variablelist"><dl><dt></dt><dd><p>
    51875201    This parameter maps how Samba debug messages are logged onto the system syslog logging levels.
    51885202    Samba debug level zero maps onto syslog <code class="constant">LOG_ERR</code>, debug level one maps onto
    … …  
    51955209    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>syslog</code></em> = <code class="literal">1</code>
    51965210</em></span>
    5197 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id325768"></a>
     5211</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560369"></a>
    51985212
    51995213template homedir (G)
    5200 </h3></div></div></div><a class="indexterm" name="id325769"></a><a name="TEMPLATEHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
     5214</h3></div></div></div><a class="indexterm" name="id2560370"></a><a name="TEMPLATEHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
    52015215        user, the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon  uses this
    52025216        parameter to fill in the home directory for that user. If the
    … …  
    52065220        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>
    52075221</em></span>
    5208 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id325831"></a>
     5222</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560434"></a>
    52095223
    52105224template shell (G)
    5211 </h3></div></div></div><a class="indexterm" name="id325832"></a><a name="TEMPLATESHELL"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
     5225</h3></div></div></div><a class="indexterm" name="id2560436"></a><a name="TEMPLATESHELL"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
    52125226        user, the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon uses this
    5213         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="id325868"></a>
     5227        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="id2560474"></a>
    52145228
    52155229time offset (G)
    5216 </h3></div></div></div><a class="indexterm" name="id325869"></a><a name="TIMEOFFSET"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a setting in minutes to add
     5230</h3></div></div></div><a class="indexterm" name="id2560475"></a><a name="TIMEOFFSET"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a setting in minutes to add
    52175231        to the normal GMT to local time conversion. This is useful if
    52185232        you are serving a lot of PCs that have incorrect daylight
    … …  
    52215235</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>time offset</code></em> = <code class="literal">60</code>
    52225236</em></span>
    5223 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id325926"></a>
     5237</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560534"></a>
    52245238
    52255239time server (G)
    5226 </h3></div></div></div><a class="indexterm" name="id325927"></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
     5240</h3></div></div></div><a class="indexterm" name="id2560535"></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
    52275241clients.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>time server</code></em> = <code class="literal">no</code>
    52285242</em></span>
    5229 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id325976"></a>
     5243</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560584"></a>
    52305244
    52315245unix charset (G)
    5232 </h3></div></div></div><a class="indexterm" name="id325977"></a><a name="UNIXCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the charset the unix machine
     5246</h3></div></div></div><a class="indexterm" name="id2560585"></a><a name="UNIXCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the charset the unix machine
    52335247                Samba runs on uses. Samba needs to know this in order to be able to
    52345248                convert text to the charsets other SMB clients use.
    … …  
    52395253</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>unix charset</code></em> = <code class="literal">ASCII</code>
    52405254</em></span>
    5241 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id326039"></a>
     5255</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560650"></a>
    52425256
    52435257unix extensions (G)
    5244 </h3></div></div></div><a class="indexterm" name="id326040"></a><a name="UNIXEXTENSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
     5258</h3></div></div></div><a class="indexterm" name="id2560651"></a><a name="UNIXEXTENSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
    52455259    implments the CIFS UNIX extensions, as defined by HP.
    52465260    These extensions enable Samba to better serve UNIX CIFS clients
    … …  
    52495263    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>
    52505264</em></span>
    5251 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id326082"></a>
     5265</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560703"></a>
    52525266
    52535267unix password sync (G)
    5254 </h3></div></div></div><a class="indexterm" name="id326084"></a><a name="UNIXPASSWORDSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
     5268</h3></div></div></div><a class="indexterm" name="id2560704"></a><a name="UNIXPASSWORDSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
    52555269    attempts to synchronize the UNIX password with the SMB password
    52565270    when the encrypted SMB password in the smbpasswd file is changed.
    … …  
    52615275        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>
    52625276</em></span>
    5263 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id326140"></a>
     5277</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560764"></a>
    52645278
    52655279update encrypted (G)
    5266 </h3></div></div></div><a class="indexterm" name="id326141"></a><a name="UPDATEENCRYPTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5280</h3></div></div></div><a class="indexterm" name="id2560765"></a><a name="UPDATEENCRYPTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
    52675281        This boolean parameter allows a user logging on with a plaintext password to have their encrypted (hashed)
    52685282        password in the smbpasswd file to be updated automatically as they log on. This option allows a site to
    … …  
    52745288        in the smbpasswd file this parameter should be set to <code class="constant">no</code>.
    52755289        </p><p>
    5276         In order for this parameter to be operative the <a class="link" href="smb.conf.5.html#ENCRYPTPASSWORDS">encrypt passwords</a> parameter must
    5277     be set to <code class="constant">no</code>. The default value of <a class="link" href="smb.conf.5.html#ENCRYPTPASSWORDS">encrypt  passwords = Yes</a>. Note: This must be set to <code class="constant">no</code> for this <a class="link" href="smb.conf.5.html#UPDATEENCRYPTED">update encrypted</a> to work.
     5290        In order for this parameter to be operative the <a class="link" href="smb.conf.5.html#ENCRYPTPASSWORDS" target="_top">encrypt passwords</a> parameter must
     5291    be set to <code class="constant">no</code>. The default value of <a class="link" href="smb.conf.5.html#ENCRYPTPASSWORDS" target="_top">encrypt  passwords = Yes</a>. Note: This must be set to <code class="constant">no</code> for this <a class="link" href="smb.conf.5.html#UPDATEENCRYPTED" target="_top">update encrypted</a> to work.
    52785292        </p><p>
    52795293        Note that even when this parameter is set a user authenticating to <code class="literal">smbd</code>
    … …  
    52825296        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>update encrypted</code></em> = <code class="literal">no</code>
    52835297</em></span>
    5284 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id326244"></a>
     5298</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560883"></a>
    52855299
    52865300use client driver (S)
    5287 </h3></div></div></div><a class="indexterm" name="id326246"></a><a name="USECLIENTDRIVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter applies only to Windows NT/2000
     5301</h3></div></div></div><a class="indexterm" name="id2560884"></a><a name="USECLIENTDRIVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter applies only to Windows NT/2000
    52885302    clients.  It has no effect on Windows 95/98/ME clients.  When
    52895303    serving a printer to Windows NT/2000 clients without first installing
    … …  
    53105324        server.</em></span></p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use client driver</code></em> = <code class="literal">no</code>
    53115325</em></span>
    5312 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id326317"></a>
     5326</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560964"></a>
    53135327
    53145328use kerberos keytab (G)
    5315 </h3></div></div></div><a class="indexterm" name="id326318"></a><a name="USEKERBEROSKEYTAB"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5329</h3></div></div></div><a class="indexterm" name="id2560965"></a><a name="USEKERBEROSKEYTAB"></a><div class="variablelist"><dl><dt></dt><dd><p>
    53165330        Specifies whether Samba should attempt to maintain service principals in the systems
    53175331        keytab file for <code class="constant">host/FQDN</code> and <code class="constant">cifs/FQDN</code>.
    … …  
    53255339        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use kerberos keytab</code></em> = <code class="literal">False</code>
    53265340</em></span>
    5327 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id326382"></a>
     5341</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561032"></a>
    53285342
    53295343use mmap (G)
    5330 </h3></div></div></div><a class="indexterm" name="id326383"></a><a name="USEMMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>This global parameter determines if the tdb internals of Samba can
     5344</h3></div></div></div><a class="indexterm" name="id2561033"></a><a name="USEMMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>This global parameter determines if the tdb internals of Samba can
    53315345    depend on mmap working correctly on the running system. Samba requires a coherent
    53325346    mmap/read-write system memory cache. Currently only HPUX does not have such a
    … …  
    53375351    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use mmap</code></em> = <code class="literal">yes</code>
    53385352</em></span>
    5339 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id326430"></a>
     5353</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561084"></a>
    53405354
    53415355username level (G)
    5342 </h3></div></div></div><a class="indexterm" name="id326431"></a><a name="USERNAMELEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option helps Samba to try and 'guess' at
     5356</h3></div></div></div><a class="indexterm" name="id2561085"></a><a name="USERNAMELEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option helps Samba to try and 'guess' at
    53435357    the real UNIX username, as many DOS clients send an all-uppercase
    53445358    username. By default Samba tries all lowercase, followed by the
    … …  
    53555369</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>username level</code></em> = <code class="literal">5</code>
    53565370</em></span>
    5357 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id326503"></a>
     5371</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561166"></a>
    53585372
    53595373username map script (G)
    5360 </h3></div></div></div><a class="indexterm" name="id326504"></a><a name="USERNAMEMAPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This script is a mutually exclusive alternative to the
    5361         <a class="link" href="smb.conf.5.html#USERNAMEMAP">username map</a> parameter.  This parameter
     5374</h3></div></div></div><a class="indexterm" name="id2561167"></a><a name="USERNAMEMAPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This script is a mutually exclusive alternative to the
     5375        <a class="link" href="smb.conf.5.html#USERNAMEMAP" target="_top">username map</a> parameter.  This parameter
    53625376        specifies and external program or script that must accept a single
    53635377        command line option (the username transmitted in the authentication
    … …  
    53695383</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>
    53705384</em></span>
    5371 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id326574"></a>
     5385</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561243"></a>
    53725386
    53735387username map (G)
    5374 </h3></div></div></div><a class="indexterm" name="id326575"></a><a name="USERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5388</h3></div></div></div><a class="indexterm" name="id2561244"></a><a name="USERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    53755389        This option allows you to specify a file containing a mapping of usernames from the clients to the server.
    53765390        This can be used for several purposes. The most common is to map usernames that users use on DOS or Windows
    … …  
    54285442        <code class="constant">fred</code> is remapped to <code class="constant">mary</code> then you will actually be connecting to
    54295443        \\server\mary and will need to supply a password suitable for <code class="constant">mary</code> not
    5430         <code class="constant">fred</code>. The only exception to this is the username passed to the <a class="link" href="smb.conf.5.html#PASSWORDSERVER">password server</a> (if you have one). The password server will receive whatever username the client
     5444        <code class="constant">fred</code>. The only exception to this is the username passed to the <a class="link" href="smb.conf.5.html#PASSWORDSERVER" target="_top">password server</a> (if you have one). The password server will receive whatever username the client
    54315445        supplies without  modification.
    54325446    </p><p>
    … …  
    54565470# no username map</code>
    54575471</em></span>
    5458 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id326817"></a>
     5472</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561523"></a>
    54595473
    54605474<a name="USER"></a>user
    5461 </h3></div></div></div><a class="indexterm" name="id326818"></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="id326848"></a>
     5475</h3></div></div></div><a class="indexterm" name="id2561524"></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="id2561555"></a>
    54625476
    54635477<a name="USERS"></a>users
    5464 </h3></div></div></div><a class="indexterm" name="id326849"></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="id326879"></a>
     5478</h3></div></div></div><a class="indexterm" name="id2561556"></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="id2561586"></a>
    54655479
    54665480username (S)
    5467 </h3></div></div></div><a class="indexterm" name="id326880"></a><a name="USERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>Multiple users may be specified in a comma-delimited
     5481</h3></div></div></div><a class="indexterm" name="id2561587"></a><a name="USERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>Multiple users may be specified in a comma-delimited
    54685482    list, in which case the supplied password will be tested against
    54695483    each username in turn (left to right).</p><p>The <em class="parameter"><code>username</code></em> line is needed only when
    … …  
    54845498    telnet session. The daemon runs as the user that they log in as,
    54855499    so they cannot do anything that user cannot do.</p><p>To restrict a service to a particular set of users you
    5486     can use the <a class="link" href="smb.conf.5.html#VALIDUSERS">valid users</a> parameter.</p><p>If any of the usernames begin with a '@' then the name
     5500    can use the <a class="link" href="smb.conf.5.html#VALIDUSERS" target="_top">valid users</a> parameter.</p><p>If any of the usernames begin with a '@' then the name
    54875501    will be looked up first in the NIS netgroups list (if Samba
    54885502    is compiled with netgroup support), followed by a lookup in
    … …  
    55035517</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>username</code></em> = <code class="literal">fred, mary, jack, jane, @users, @pcgroup</code>
    55045518</em></span>
    5505 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id327025"></a>
     5519</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561757"></a>
    55065520
    55075521usershare allow guests (G)
    5508 </h3></div></div></div><a class="indexterm" name="id327026"></a><a name="USERSHAREALLOWGUESTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether user defined shares are allowed
     5522</h3></div></div></div><a class="indexterm" name="id2561758"></a><a name="USERSHAREALLOWGUESTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether user defined shares are allowed
    55095523        to be accessed by non-authenticated users or not. It is the equivalent
    55105524        of allowing people who can create a share the option of setting
    … …  
    55135527        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>
    55145528</em></span>
    5515 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id327074"></a>
     5529</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561809"></a>
    55165530
    55175531usershare max shares (G)
    5518 </h3></div></div></div><a class="indexterm" name="id327076"></a><a name="USERSHAREMAXSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of user defined shares
     5532</h3></div></div></div><a class="indexterm" name="id2561810"></a><a name="USERSHAREMAXSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of user defined shares
    55195533        that are allowed to be created by users belonging to the group owning the
    55205534        usershare directory. If set to zero (the default) user defined shares are ignored.
    55215535        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare max shares</code></em> = <code class="literal">0</code>
    55225536</em></span>
    5523 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id327116"></a>
     5537</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561854"></a>
    55245538
    55255539usershare owner only (G)
    5526 </h3></div></div></div><a class="indexterm" name="id327117"></a><a name="USERSHAREOWNERONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether the pathname exported by
     5540</h3></div></div></div><a class="indexterm" name="id2561856"></a><a name="USERSHAREOWNERONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether the pathname exported by
    55275541        a user defined shares must be owned by the user creating the
    55285542        user defined share or not. If set to True (the default) then
    … …  
    55345548        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare owner only</code></em> = <code class="literal">True</code>
    55355549</em></span>
    5536 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id327161"></a>
     5550</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561904"></a>
    55375551
    55385552usershare path (G)
    5539 </h3></div></div></div><a class="indexterm" name="id327162"></a><a name="USERSHAREPATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the absolute path of the directory on the
     5553</h3></div></div></div><a class="indexterm" name="id2561905"></a><a name="USERSHAREPATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the absolute path of the directory on the
    55405554        filesystem used to store the user defined share definition files.
    55415555        This directory must be owned by root, and have no access for
    … …  
    55585572        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare path</code></em> = <code class="literal">NULL</code>
    55595573</em></span>
    5560 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id327224"></a>
     5574</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561975"></a>
    55615575
    55625576usershare prefix allow list (G)
    5563 </h3></div></div></div><a class="indexterm" name="id327226"></a><a name="USERSHAREPREFIXALLOWLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
     5577</h3></div></div></div><a class="indexterm" name="id2561976"></a><a name="USERSHAREPREFIXALLOWLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
    55645578        the root of which are allowed to be exported by user defined share definitions.
    55655579        If the pathname exported doesn't start with one of the strings in this
    … …  
    55765590</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>usershare prefix allow list</code></em> = <code class="literal">/home /data /space</code>
    55775591</em></span>
    5578 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id327292"></a>
     5592</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562048"></a>
    55795593
    55805594usershare prefix deny list (G)
    5581 </h3></div></div></div><a class="indexterm" name="id327293"></a><a name="USERSHAREPREFIXDENYLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
     5595</h3></div></div></div><a class="indexterm" name="id2562049"></a><a name="USERSHAREPREFIXDENYLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
    55825596        the root of which are NOT allowed to be exported by user defined share definitions.
    55835597        If the pathname exported starts with one of the strings in this
    … …  
    55955609</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>usershare prefix deny list</code></em> = <code class="literal">/etc /dev /private</code>
    55965610</em></span>
    5597 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id327359"></a>
     5611</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562122"></a>
    55985612
    55995613usershare template share (G)
    5600 </h3></div></div></div><a class="indexterm" name="id327360"></a><a name="USERSHARETEMPLATESHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>User defined shares only have limited possible parameters
     5614</h3></div></div></div><a class="indexterm" name="id2562123"></a><a name="USERSHARETEMPLATESHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>User defined shares only have limited possible parameters
    56015615        such as path, guest ok etc. This parameter allows usershares to
    56025616        "cloned" from an existing share. If "usershare template share"
    … …  
    56135627</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>usershare template share</code></em> = <code class="literal">template_share</code>
    56145628</em></span>
    5615 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id327425"></a>
     5629</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562195"></a>
    56165630
    56175631use sendfile (S)
    5618 </h3></div></div></div><a class="indexterm" name="id327426"></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>
     5632</h3></div></div></div><a class="indexterm" name="id2562196"></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>
    56195633    system call is supported by the underlying operating system, then some SMB read calls
    56205634    (mainly ReadAndX and ReadRaw) will use the more efficient sendfile system call for files that
    … …  
    56255639    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use sendfile</code></em> = <code class="literal">false</code>
    56265640</em></span>
    5627 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id327477"></a>
     5641</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562253"></a>
    56285642
    56295643use spnego (G)
    5630 </h3></div></div></div><a class="indexterm" name="id327478"></a><a name="USESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p>This variable controls controls whether samba will try
     5644</h3></div></div></div><a class="indexterm" name="id2562254"></a><a name="USESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p>This variable controls controls whether samba will try
    56315645    to use Simple and Protected NEGOciation (as specified by rfc2478) with
    56325646    WindowsXP and Windows2000 clients to agree upon an authentication mechanism.
    … …  
    56365650        disabled.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use spnego</code></em> = <code class="literal">yes</code>
    56375651</em></span>
    5638 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id327524"></a>
     5652</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562302"></a>
    56395653
    56405654utmp directory (G)
    5641 </h3></div></div></div><a class="indexterm" name="id327525"></a><a name="UTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only available if Samba has
     5655</h3></div></div></div><a class="indexterm" name="id2562303"></a><a name="UTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only available if Samba has
    56425656        been configured and compiled with the option <code class="literal">
    56435657        --with-utmp</code>. It specifies a directory pathname that is
    … …  
    56515665</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>utmp directory</code></em> = <code class="literal">/var/run/utmp</code>
    56525666</em></span>
    5653 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id327597"></a>
     5667</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562380"></a>
    56545668
    56555669utmp (G)
    5656 </h3></div></div></div><a class="indexterm" name="id327598"></a><a name="UTMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5670</h3></div></div></div><a class="indexterm" name="id2562381"></a><a name="UTMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    56575671        This boolean parameter is only available if Samba has been configured and compiled 
    56585672        with the option <code class="literal">--with-utmp</code>. If set to
    … …  
    56665680        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>utmp</code></em> = <code class="literal">no</code>
    56675681</em></span>
    5668 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id327655"></a>
     5682</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562443"></a>
    56695683
    56705684valid users (S)
    5671 </h3></div></div></div><a class="indexterm" name="id327656"></a><a name="VALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5685</h3></div></div></div><a class="indexterm" name="id2562444"></a><a name="VALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    56725686    This is a list of users that should be allowed to login to this service. Names starting with
    56735687    '@', '+' and  '&amp;' are interpreted using the same rules as described in the
    … …  
    56855699</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>valid users</code></em> = <code class="literal">greg, @pcusers</code>
    56865700</em></span>
    5687 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id327741"></a>
     5701</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562534"></a>
    56885702
    56895703-valid (S)
    5690 </h3></div></div></div><a class="indexterm" name="id327742"></a><a name="-VALID"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter indicates whether a share is
     5704</h3></div></div></div><a class="indexterm" name="id2562535"></a><a name="-VALID"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter indicates whether a share is
    56915705        valid and thus can be used. When this parameter is set to false,
    56925706        the share will be in no way visible nor accessible.
    … …  
    56975711        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>-valid</code></em> = <code class="literal">yes</code>
    56985712</em></span>
    5699 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id327787"></a>
     5713</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562584"></a>
    57005714
    57015715veto files (S)
    5702 </h3></div></div></div><a class="indexterm" name="id327788"></a><a name="VETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5716</h3></div></div></div><a class="indexterm" name="id2562585"></a><a name="VETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    57035717        This is a list of files and directories that are neither visible nor accessible.  Each entry in
    57045718        the list must be separated by a '/', which allows spaces to be included in the entry. '*' and '?'
    … …  
    57085722        unix directory  separator '/'.
    57095723        </p><p>
    5710         Note that the <a class="link" href="smb.conf.5.html#CASESENSITIVE">case sensitive</a> option is applicable in vetoing files.
     5724        Note that the <a class="link" href="smb.conf.5.html#CASESENSITIVE" target="_top">case sensitive</a> option is applicable in vetoing files.
    57115725        </p><p>
    57125726        One feature of the veto files parameter that it is important to be aware of is Samba's behaviour when
    57135727        trying to delete a directory. If a directory that is to be deleted contains nothing but veto files this
    5714         deletion will <span class="emphasis"><em>fail</em></span> unless you also set the <a class="link" href="smb.conf.5.html#DELETEVETOFILES">delete veto files</a>
     5728        deletion will <span class="emphasis"><em>fail</em></span> unless you also set the <a class="link" href="smb.conf.5.html#DELETEVETOFILES" target="_top">delete veto files</a>
    57155729        parameter to <em class="parameter"><code>yes</code></em>.
    57165730        </p><p>
    … …  
    57315745        </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>
    57325746</em></span>
    5733 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id327895"></a>
     5747</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562703"></a>
    57345748
    57355749veto oplock files (S)
    5736 </h3></div></div></div><a class="indexterm" name="id327896"></a><a name="VETOOPLOCKFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    5737         This parameter is only valid when the <a class="link" href="smb.conf.5.html#OPLOCKS">oplocks</a>
     5750</h3></div></div></div><a class="indexterm" name="id2562704"></a><a name="VETOOPLOCKFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5751        This parameter is only valid when the <a class="link" href="smb.conf.5.html#OPLOCKS" target="_top">oplocks</a>
    57385752        parameter is turned on for a share. It allows the Samba administrator
    57395753        to selectively turn off the granting of oplocks on selected files that
    57405754        match a wildcarded list, similar to the wildcarded list used in the
    5741         <a class="link" href="smb.conf.5.html#VETOFILES">veto files</a> parameter.
     5755        <a class="link" href="smb.conf.5.html#VETOFILES" target="_top">veto files</a> parameter.
    57425756        </p><p>
    57435757        You might want to do this on files that you know will be heavily contended
    … …  
    57555769# No files are vetoed for oplock grants</code>
    57565770</em></span>
    5757 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id327981"></a>
     5771</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562796"></a>
    57585772
    57595773<a name="VFSOBJECT"></a>vfs object
    5760 </h3></div></div></div><a class="indexterm" name="id327982"></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="id328013"></a>
     5774</h3></div></div></div><a class="indexterm" name="id2562797"></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="id2562828"></a>
    57615775
    57625776vfs objects (S)
    5763 </h3></div></div></div><a class="indexterm" name="id328014"></a><a name="VFSOBJECTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the backend names which
     5777</h3></div></div></div><a class="indexterm" name="id2562829"></a><a name="VFSOBJECTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the backend names which
    57645778        are used for Samba VFS I/O operations.  By default, normal
    57655779        disk I/O operations are used but these can be overloaded
    … …  
    57685782</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>vfs objects</code></em> = <code class="literal">extd_audit recycle</code>
    57695783</em></span>
    5770 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id328071"></a>
     5784</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562888"></a>
    57715785
    57725786volume (S)
    5773 </h3></div></div></div><a class="indexterm" name="id328072"></a><a name="VOLUME"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the volume label
     5787</h3></div></div></div><a class="indexterm" name="id2562889"></a><a name="VOLUME"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the volume label
    57745788        returned for a share. Useful for CDROMs with installation programs
    57755789        that insist on a particular volume label.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>volume</code></em> = <code class="literal">
    57765790# the name of the share</code>
    57775791</em></span>
    5778 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id328112"></a>
     5792</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562932"></a>
    57795793
    57805794wide links (S)
    5781 </h3></div></div></div><a class="indexterm" name="id328114"></a><a name="WIDELINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not links
     5795</h3></div></div></div><a class="indexterm" name="id2562933"></a><a name="WIDELINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not links
    57825796        in the UNIX file system may be followed by the server. Links
    57835797        that point to areas within the directory tree exported by the
    … …  
    57875801        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>
    57885802</em></span>
    5789 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id328160"></a>
     5803</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562984"></a>
    57905804
    57915805winbind cache time (G)
    5792 </h3></div></div></div><a class="indexterm" name="id328161"></a><a name="WINBINDCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of
     5806</h3></div></div></div><a class="indexterm" name="id2562985"></a><a name="WINBINDCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of
    57935807        seconds the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon will cache
    57945808        user and group information before querying a Windows NT server
    57955809        again.</p><p>
    57965810        This does not apply to authentication requests, these are always
    5797         evaluated in real time unless the <a class="link" href="smb.conf.5.html#WINBINDOFFLINELOGON">winbind   offline logon</a> option has been enabled.
     5811        evaluated in real time unless the <a class="link" href="smb.conf.5.html#WINBINDOFFLINELOGON" target="_top">winbind   offline logon</a> option has been enabled.
    57985812        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind cache time</code></em> = <code class="literal">300</code>
    57995813</em></span>
    5800 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id328226"></a>
     5814</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563055"></a>
    58015815
    58025816winbind enum groups (G)
    5803 </h3></div></div></div><a class="indexterm" name="id328228"></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
     5817</h3></div></div></div><a class="indexterm" name="id2563056"></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
    58045818        the enumeration of groups through the <code class="literal">setgrent()</code>,
    58055819        <code class="literal">getgrent()</code> and
    … …  
    58095823        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>
    58105824</em></span>
    5811 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id328315"></a>
     5825</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563146"></a>
    58125826
    58135827winbind enum users (G)
    5814 </h3></div></div></div><a class="indexterm" name="id328316"></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
     5828</h3></div></div></div><a class="indexterm" name="id2563147"></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
    58155829        necessary to suppress the enumeration of users through the <code class="literal">setpwent()</code>,
    58165830         <code class="literal">getpwent()</code> and
    … …  
    58245838        usernames. </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind enum users</code></em> = <code class="literal">no</code>
    58255839</em></span>
    5826 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id328404"></a>
     5840</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563239"></a>
    58275841
    58285842winbind nested groups (G)
    5829 </h3></div></div></div><a class="indexterm" name="id328405"></a><a name="WINBINDNESTEDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to yes, this parameter activates the support for nested
     5843</h3></div></div></div><a class="indexterm" name="id2563240"></a><a name="WINBINDNESTEDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to yes, this parameter activates the support for nested
    58305844                 groups. Nested groups are also called local groups or
    58315845                 aliases. They work like their counterparts in Windows: Nested
    … …  
    58355849                 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>
    58365850</em></span>
    5837 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id328449"></a>
     5851</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563290"></a>
    58385852
    58395853winbind normalize names (G)
    5840 </h3></div></div></div><a class="indexterm" name="id328450"></a><a name="WINBINDNORMALIZENAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether winbindd will replace
     5854</h3></div></div></div><a class="indexterm" name="id2563291"></a><a name="WINBINDNORMALIZENAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether winbindd will replace
    58415855        whitespace in user and group names with an underscore (_) character.
    58425856        For example, whether the name "Space Kadet" should be
    … …  
    58505864</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind normalize names</code></em> = <code class="literal">yes</code>
    58515865</em></span>
    5852 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id328510"></a>
     5866</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563357"></a>
    58535867
    58545868winbind nss info (G)
    5855 </h3></div></div></div><a class="indexterm" name="id328511"></a><a name="WINBINDNSSINFO"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control how Winbind retrieves Name
     5869</h3></div></div></div><a class="indexterm" name="id2563358"></a><a name="WINBINDNSSINFO"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control how Winbind retrieves Name
    58565870        Service Information to construct a user's home directory and login shell.
    58575871        Currently the following settings are available:
    … …  
    58755889</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind nss info</code></em> = <code class="literal">template sfu</code>
    58765890</em></span>
    5877 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id328623"></a>
     5891</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563476"></a>
    58785892
    58795893winbind offline logon (G)
    5880 </h3></div></div></div><a class="indexterm" name="id328624"></a><a name="WINBINDOFFLINELOGON"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control whether Winbind should
     5894</h3></div></div></div><a class="indexterm" name="id2563477"></a><a name="WINBINDOFFLINELOGON"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control whether Winbind should
    58815895        allow to login with the <em class="parameter"><code>pam_winbind</code></em>
    58825896        module using Cached Credentials. If enabled, winbindd will store user credentials
    … …  
    58865900</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind offline logon</code></em> = <code class="literal">true</code>
    58875901</em></span>
    5888 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id328688"></a>
     5902</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563545"></a>
    58895903
    58905904winbind refresh tickets (G)
    5891 </h3></div></div></div><a class="indexterm" name="id328689"></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
     5905</h3></div></div></div><a class="indexterm" name="id2563546"></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
    58925906        retrieved using the <em class="parameter"><code>pam_winbind</code></em> module.
    58935907
    … …  
    58965910</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind refresh tickets</code></em> = <code class="literal">true</code>
    58975911</em></span>
    5898 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id328753"></a>
     5912</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563612"></a>
    58995913
    59005914winbind separator (G)
    5901 </h3></div></div></div><a class="indexterm" name="id328754"></a><a name="WINBINDSEPARATOR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows an admin to define the character
     5915</h3></div></div></div><a class="indexterm" name="id2563613"></a><a name="WINBINDSEPARATOR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows an admin to define the character
    59025916        used when listing a username of the form of <em class="replaceable"><code>DOMAIN
    59035917        </code></em>\<em class="replaceable"><code>user</code></em>.  This parameter
    … …  
    59105924</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind separator</code></em> = <code class="literal">+</code>
    59115925</em></span>
    5912 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id328836"></a>
     5926</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563699"></a>
    59135927
    59145928winbind trusted domains only (G)
    5915 </h3></div></div></div><a class="indexterm" name="id328837"></a><a name="WINBINDTRUSTEDDOMAINSONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5929</h3></div></div></div><a class="indexterm" name="id2563700"></a><a name="WINBINDTRUSTEDDOMAINSONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    59165930        This parameter is designed to allow Samba servers that are members
    59175931        of a Samba controlled domain to use UNIX accounts distributed via NIS,
    … …  
    59215935        </p><p>
    59225936        This parameter is now deprecated in favor of the newer idmap_nss backend.
    5923         Refer to the <a class="link" href="smb.conf.5.html#IDMAPDOMAINS">idmap domains</a> smb.conf option and
     5937        Refer to the <a class="link" href="smb.conf.5.html#IDMAPDOMAINS" target="_top">idmap domains</a> smb.conf option and
    59245938        the <a class="citerefentry" href="idmap_nss.8.html"><span class="citerefentry"><span class="refentrytitle">idmap_nss</span>(8)</span></a> man page for more information.
    59255939        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind trusted domains only</code></em> = <code class="literal">no</code>
    59265940</em></span>
    5927 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id328908"></a>
     5941</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563778"></a>
    59285942
    59295943winbind use default domain (G)
    5930 </h3></div></div></div><a class="indexterm" name="id328909"></a><a name="WINBINDUSEDEFAULTDOMAIN"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether the
     5944</h3></div></div></div><a class="indexterm" name="id2563780"></a><a name="WINBINDUSEDEFAULTDOMAIN"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether the
    59315945         <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon should operate on users 
    59325946        without domain component in their username. Users without a domain
    … …  
    59385952</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind use default domain</code></em> = <code class="literal">yes</code>
    59395953</em></span>
    5940 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id328977"></a>
     5954</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563850"></a>
    59415955
    59425956wins hook (G)
    5943 </h3></div></div></div><a class="indexterm" name="id328978"></a><a name="WINSHOOK"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba is running as a WINS server this
     5957</h3></div></div></div><a class="indexterm" name="id2563852"></a><a name="WINSHOOK"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba is running as a WINS server this
    59445958        allows you to call an external program for all changes to the
    59455959        WINS database. The primary use for this option is to allow the
    … …  
    59625976                        empty then the name should be deleted.</p></li></ul></div><p>An example script that calls the BIND dynamic DNS update
    59635977        program <code class="literal">nsupdate</code> is provided in the examples
    5964         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="id329071"></a>
     5978        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="id2563957"></a>
    59655979
    59665980wins proxy (G)
    5967 </h3></div></div></div><a class="indexterm" name="id329072"></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
     5981</h3></div></div></div><a class="indexterm" name="id2563958"></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
    59685982        queries on behalf of  other hosts. You may need to set this
    59695983        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>
    59705984</em></span>
    5971 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id329125"></a>
     5985</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564012"></a>
    59725986
    59735987wins server (G)
    5974 </h3></div></div></div><a class="indexterm" name="id329126"></a><a name="WINSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the IP address (or DNS name: IP
     5988</h3></div></div></div><a class="indexterm" name="id2564013"></a><a name="WINSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the IP address (or DNS name: IP
    59755989        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
    59765990        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
    … …  
    59916005</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>
    59926006</em></span>
    5993 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id329227"></a>
     6007</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564122"></a>
    59946008
    59956009wins support (G)
    5996 </h3></div></div></div><a class="indexterm" name="id329228"></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
     6010</h3></div></div></div><a class="indexterm" name="id2564123"></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
    59976011        not set this to <code class="constant">yes</code> unless you have a multi-subnetted network and
    59986012        you wish a particular <code class="literal">nmbd</code> to be your WINS server.
    … …  
    60006014        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>
    60016015</em></span>
    6002 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id329294"></a>
     6016</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564192"></a>
    60036017
    60046018workgroup (G)
    6005 </h3></div></div></div><a class="indexterm" name="id329295"></a><a name="WORKGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what workgroup your server will
     6019</h3></div></div></div><a class="indexterm" name="id2564193"></a><a name="WORKGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what workgroup your server will
    60066020        appear to be in when queried by clients. Note that this parameter
    60076021        also controls the Domain name used with
    6008         the <a class="link" href="smb.conf.5.html#SECURITY">security = domain</a>
     6022        the <a class="link" href="smb.conf.5.html#SECURITY" target="_top">security = domain</a>
    60096023                setting.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>workgroup</code></em> = <code class="literal">WORKGROUP</code>
    60106024</em></span>
    60116025</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>workgroup</code></em> = <code class="literal">MYGROUP</code>
    60126026</em></span>
    6013 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id329364"></a>
     6027</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564264"></a>
    60146028
    60156029<a name="WRITABLE"></a>writable
    6016 </h3></div></div></div><a class="indexterm" name="id329365"></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="id329394"></a>
     6030</h3></div></div></div><a class="indexterm" name="id2564265"></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="id2564295"></a>
    60176031
    60186032writeable (S)
    6019 </h3></div></div></div><a class="indexterm" name="id329396"></a><a name="WRITEABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>Inverted synonym for <a class="link" href="smb.conf.5.html#READONLY">read only</a>.</p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id329433"></a>
     6033</h3></div></div></div><a class="indexterm" name="id2564296"></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>
     6034</em></span>
     6035</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564346"></a>
    60206036
    60216037write cache size (S)
    6022 </h3></div></div></div><a class="indexterm" name="id329434"></a><a name="WRITECACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this integer parameter is set to non-zero value,
     6038</h3></div></div></div><a class="indexterm" name="id2564348"></a><a name="WRITECACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this integer parameter is set to non-zero value,
    60236039    Samba will create an in-memory cache for each oplocked file
    60246040    (it does <span class="emphasis"><em>not</em></span> do this for
    … …  
    60386054#  for a 256k cache size per file</code>
    60396055</em></span>
    6040 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id329508"></a>
     6056</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564430"></a>
    60416057
    60426058write list (S)
    6043 </h3></div></div></div><a class="indexterm" name="id329509"></a><a name="WRITELIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6059</h3></div></div></div><a class="indexterm" name="id2564431"></a><a name="WRITELIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
    60446060    This is a list of users that are given read-write access to a service. If the
    60456061    connecting user is in this list then they will be given write access, no matter
    6046     what the <a class="link" href="smb.conf.5.html#READONLY">read only</a> option is set to. The list can
     6062    what the <a class="link" href="smb.conf.5.html#READONLY" target="_top">read only</a> option is set to. The list can
    60476063    include group names using the @group syntax.
    60486064    </p><p>
    … …  
    60516067    </p><p>
    60526068    By design, this parameter will not work with the
    6053     <a class="link" href="smb.conf.5.html#SECURITY">security = share</a> in Samba 3.0.
     6069    <a class="link" href="smb.conf.5.html#SECURITY" target="_top">security = share</a> in Samba 3.0.
    60546070    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>write list</code></em> = <code class="literal"></code>
    60556071</em></span>
    60566072</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>write list</code></em> = <code class="literal">admin, root, @staff</code>
    60576073</em></span>
    6058 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id329596"></a>
     6074</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564523"></a>
    60596075
    60606076write raw (G)
    6061 </h3></div></div></div><a class="indexterm" name="id329597"></a><a name="WRITERAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
     6077</h3></div></div></div><a class="indexterm" name="id2564524"></a><a name="WRITERAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
    60626078    will support raw write SMB's when transferring data from clients.
    60636079    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>
    60646080</em></span>
    6065 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id329638"></a>
     6081</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564567"></a>
    60666082
    60676083wtmp directory (G)
    6068 </h3></div></div></div><a class="indexterm" name="id329639"></a><a name="WTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6084</h3></div></div></div><a class="indexterm" name="id2564568"></a><a name="WTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    60696085        This parameter is only available if Samba has been configured and compiled with the option <code class="literal">
    60706086        --with-utmp</code>. It specifies a directory pathname that is used to store the wtmp or wtmpx files (depending on
    … …  
    60786094</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>wtmp directory</code></em> = <code class="literal">/var/log/wtmp</code>
    60796095</em></span>
    6080 </p></dd></dl></div></div></div></div><div class="refsect1" lang="en"><a name="id329716"></a><h2>WARNINGS</h2><p>
     6096</p></dd></dl></div></div></div></div><div class="refsect1" lang="en"><a name="id2564651"></a><h2>WARNINGS</h2><p>
    60816097        Although the configuration file permits service names to contain spaces, your client software may not.
    60826098        Spaces will be ignored in comparisons anyway, so it shouldn't be a problem - but be aware of the possibility.
    … …  
    60916107        care when designing these sections. In particular, ensure that the permissions on spool directories are
    60926108        correct.
    6093         </p></div><div class="refsect1" lang="en"><a name="id329759"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id329769"></a><h2>SEE ALSO</h2><p>
    6094         <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="id329849"></a><h2>AUTHOR</h2><p>
     6109        </p></div><div class="refsect1" lang="en"><a name="id2564701"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2564712"></a><h2>SEE ALSO</h2><p>
     6110        <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="id2564791"></a><h2>AUTHOR</h2><p>
    60956111        The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed
    60966112        by the Samba Team as an Open Source project similar to the way the Linux kernel is developed.

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

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbcacls</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id290849"></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="id258946"></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="id2483401"></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="id2483545"></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
    … …  
    4141use only by developers and generate HUGE amounts of log
    4242data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
    43 override the <a class="link" href="smb.conf.5.html#LOGLEVEL">log level</a> parameter
     43override the <a class="link" href="smb.conf.5.html#LOGLEVEL" target="_top">log level</a> parameter
    4444in the <code class="filename">smb.conf</code> file.</p></dd><dt><span class="term">-V</span></dt><dd><p>Prints the program version number.
    4545</p></dd><dt><span class="term">-s &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the
    … …  
    5353<code class="constant">".progname"</code> will be appended (e.g. log.smbclient,
    5454log.smbd, etc...). The log file is never removed by the client.
    55 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id258374"></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="id2481613"></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;
    … …  
    7979                permissions</p></li><li><p><span class="emphasis"><em>CHANGE</em></span> - Equivalent to 'RXWD' permissions
    8080                </p></li><li><p><span class="emphasis"><em>FULL</em></span> - Equivalent to 'RWXDPO'
    81                 permissions</p></li></ul></div></div><div class="refsect1" lang="en"><a name="id299987"></a><h2>EXIT STATUS</h2><p>The <code class="literal">smbcacls</code> program sets the exit status
     81                permissions</p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2481778"></a><h2>EXIT STATUS</h2><p>The <code class="literal">smbcacls</code> program sets the exit status
    8282        depending on the success or otherwise of the operations performed. 
    8383        The exit status may be one of the following values. </p><p>If the operation succeeded, smbcacls returns and exit
    … …  
    8585        or there was an error getting or setting the ACLs, an exit status
    8686        of 1 is returned.  If there was an error parsing any command line
    87         arguments, an exit status of 2 is returned. </p></div><div class="refsect1" lang="en"><a name="id300014"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id300024"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     87        arguments, an exit status of 2 is returned. </p></div><div class="refsect1" lang="en"><a name="id2481810"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2481821"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    8888        were created by Andrew Tridgell. Samba is now developed
    8989        by the Samba Team as an Open Source project similar

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

    r158 r286  
    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.73.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="smbclient.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbclient &#8212; ftp-like client to access SMB/CIFS resources
    2         on servers</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbclient</code> [-b &lt;buffer size&gt;] [-d debuglevel] [-e] [-L &lt;netbios name&gt;] [-U username] [-I destinationIP] [-M &lt;netbios name&gt;] [-m maxprotocol] [-A authfile] [-N] [-i scope] [-O &lt;socket options&gt;] [-p port] [-R &lt;name resolve order&gt;] [-s &lt;smb config file&gt;] [-k] [-P] [-c &lt;command&gt;]</p></div><div class="cmdsynopsis"><p><code class="literal">smbclient</code> {servicename} [password] [-b &lt;buffer size&gt;] [-d debuglevel] [-e] [-D Directory] [-U username] [-W workgroup] [-M &lt;netbios name&gt;] [-m maxprotocol] [-A authfile] [-N] [-l log-basename] [-I destinationIP] [-E] [-c &lt;command string&gt;] [-i scope] [-O &lt;socket options&gt;] [-p port] [-R &lt;name resolve order&gt;] [-s &lt;smb config file&gt;] [-T&lt;c|x&gt;IXFqgbNan] [-k]</p></div></div><div class="refsect1" lang="en"><a name="id258316"></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="id2483769"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbclient</code> is a client that can
    33        'talk' to an SMB/CIFS server. It offers an interface
    44        similar to that of the ftp program (see <a class="citerefentry" href="ftp.1.html"><span class="citerefentry"><span class="refentrytitle">ftp</span>(1)</span></a>). 
    … …  
    66        to the local machine, putting files from the local machine to
    77        the server, retrieving directory information from the server
    8         and so on. </p></div><div class="refsect1" lang="en"><a name="id258352"></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="id2483808"></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
    … …  
    8686                when making connections to the server. The standard (well-known)
    8787                TCP port number for an SMB/CIFS server is 139, which is the
    88                 default. </p></dd><dt><span class="term">-P</span></dt><dd><p>
     88                default. </p></dd><dt><span class="term">-g</span></dt><dd><p>This parameter provides combined with
     89                <em class="parameter"><code>-L</code></em> easy parseable output        that allows processing
     90                with utilities such as grep and cut.
     91                </p></dd><dt><span class="term">-P</span></dt><dd><p>
    8992                Make queries to the external server using the machine account of the local server.
    9093                </p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    91 </p></dd><dt><span class="term">-I IP-address</span></dt><dd><p><em class="replaceable"><code>IP address</code></em> is the address of the server to connect to. 
     94</p></dd><dt><span class="term">-I IP-address</span></dt><dd><p><em class="replaceable"><code>IP address</code></em> is the address of the server to connect to.
    9295                It should be specified in standard "a.b.c.d" notation. </p><p>Normally the client would attempt to locate a named
    9396                SMB/CIFS server by looking it up via the NetBIOS name resolution
    … …  
    138141use only by developers and generate HUGE amounts of log
    139142data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
    140 override the <a class="link" href="smb.conf.5.html#LOGLEVEL">log level</a> parameter
     143override the <a class="link" href="smb.conf.5.html#LOGLEVEL" target="_top">log level</a> parameter
    141144in the <code class="filename">smb.conf</code> file.</p></dd><dt><span class="term">-V</span></dt><dd><p>Prints the program version number.
    142145</p></dd><dt><span class="term">-s &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the
    … …  
    183186it in directly. </p></dd><dt><span class="term">-n &lt;primary NetBIOS name&gt;</span></dt><dd><p>This option allows you to override
    184187the NetBIOS name that Samba uses for itself. This is identical
    185 to setting the <a class="link" href="smb.conf.5.html#NETBIOSNAME">netbios name</a> parameter in the <code class="filename">smb.conf</code> file.
     188to setting the <a class="link" href="smb.conf.5.html#NETBIOSNAME" target="_top">netbios name</a> parameter in the <code class="filename">smb.conf</code> file.
    186189However, a command
    187190line setting will take precedence over settings in
    … …  
    268271                commands to be executed instead of prompting from stdin. <em class="parameter"><code>
    269272                -N</code></em> is implied by <em class="parameter"><code>-c</code></em>.</p><p>This is particularly useful in scripts and for printing stdin
    270                 to the server, e.g. <code class="literal">-c 'print -'</code>. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id300920"></a><h2>OPERATIONS</h2><p>Once the client is running, the user is presented with
     273                to the server, e.g. <code class="literal">-c 'print -'</code>. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2533319"></a><h2>OPERATIONS</h2><p>Once the client is running, the user is presented with
    271274        a prompt : </p><p><code class="prompt">smb:\&gt; </code></p><p>The backslash ("\\") indicates the current working directory
    272275        on the server, and will change if the current working directory
    … …  
    464467                the given arbitrary number. Without an argument prints out the current
    465468                vuid being used. Used for internal Samba testing purposes.
    466                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id301857"></a><h2>NOTES</h2><p>Some servers are fussy about the case of supplied usernames,
     469                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2534390"></a><h2>NOTES</h2><p>Some servers are fussy about the case of supplied usernames,
    467470        passwords, share names (AKA service names) and machine names.
    468471        If you fail to connect try giving all parameters in uppercase.
    … …  
    471474        on a valid NetBIOS name being used, so you need to supply a valid
    472475        name that would be known to the server.</p><p>smbclient supports long file names where the server
    473         supports the LANMAN2 protocol or above. </p></div><div class="refsect1" lang="en"><a name="id301877"></a><h2>ENVIRONMENT VARIABLES</h2><p>The variable <code class="envar">USER</code> may contain the
     476        supports the LANMAN2 protocol or above. </p></div><div class="refsect1" lang="en"><a name="id2534415"></a><h2>ENVIRONMENT VARIABLES</h2><p>The variable <code class="envar">USER</code> may contain the
    474477        username of the person  using the client. This information is
    475478        used only if the protocol  level is high enough to support
    … …  
    481484        to instead of connecting to a server.  This functionality is primarily
    482485        intended as a development aid, and works best when using a LMHOSTS
    483         file</p></div><div class="refsect1" lang="en"><a name="id301908"></a><h2>INSTALLATION</h2><p>The location of the client program is a matter for
     486        file</p></div><div class="refsect1" lang="en"><a name="id2534451"></a><h2>INSTALLATION</h2><p>The location of the client program is a matter for
    484487        individual system administrators. The following are thus
    485488        suggestions only. </p><p>It is recommended that the smbclient software be installed
    … …  
    492495        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
    493496        on a user-accessible port (typically any port number over 1024)
    494         would provide a suitable test server. </p></div><div class="refsect1" lang="en"><a name="id301955"></a><h2>DIAGNOSTICS</h2><p>Most diagnostics issued by the client are logged in a
     497        would provide a suitable test server. </p></div><div class="refsect1" lang="en"><a name="id2534503"></a><h2>DIAGNOSTICS</h2><p>Most diagnostics issued by the client are logged in a
    495498        specified log file. The log file name is specified at compile time,
    496499        but may be overridden on the command line. </p><p>The number and nature of diagnostics available depends
    497500        on the debug level used by the client. If you have problems,
    498         set the debug level to 3 and peruse the log files. </p></div><div class="refsect1" lang="en"><a name="id301971"></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="id301982"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     501        set the debug level to 3 and peruse the log files. </p></div><div class="refsect1" lang="en"><a name="id2534522"></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="id2534533"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    499502        were created by Andrew Tridgell. Samba is now developed
    500503        by the Samba Team as an Open Source project similar

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

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbcontrol</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id290798"></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="id290848"></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="id2483352"></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="id2483403"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    33</p></dd><dt><span class="term">-s &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the
    44configuration details required by the server.  The
    … …  
    1717                to only that process.</p></dd><dt><span class="term">message-type</span></dt><dd><p>Type of message to send. See
    1818                the section <code class="constant">MESSAGE-TYPES</code> for details.
    19                 </p></dd><dt><span class="term">parameters</span></dt><dd><p>any parameters required for the message-type</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id259048"></a><h2>MESSAGE-TYPES</h2><p>Available message types are:</p><div class="variablelist"><dl><dt><span class="term">close-share</span></dt><dd><p>Order smbd to close the client
     19                </p></dd><dt><span class="term">parameters</span></dt><dd><p>any parameters required for the message-type</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483662"></a><h2>MESSAGE-TYPES</h2><p>Available message types are:</p><div class="variablelist"><dl><dt><span class="term">close-share</span></dt><dd><p>Order smbd to close the client
    2020        connections to the named share. Note that this doesn't affect client
    2121        connections to any other shares. This message-type takes an argument of the
    … …  
    6060        sent to smbd.</p></dd><dt><span class="term">reload-config</span></dt><dd><p>Force daemon to reload smb.conf configuration file. Can be sent
    6161        to <code class="constant">smbd</code>, <code class="constant">nmbd</code>, or <code class="constant">winbindd</code>.
    62         </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id299899"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
    63         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id299909"></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="id299933"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     62        </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481679"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
     63        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2481690"></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="id2481714"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    6464        were created by Andrew Tridgell. Samba is now developed
    6565        by the Samba Team as an Open Source project similar

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

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbcquotas</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258940"></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="id258967"></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="id2483539"></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="id2483568"></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
    … …  
    2020use only by developers and generate HUGE amounts of log
    2121data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
    22 override the <a class="link" href="smb.conf.5.html#LOGLEVEL">log level</a> parameter
     22override the <a class="link" href="smb.conf.5.html#LOGLEVEL" target="_top">log level</a> parameter
    2323in the <code class="filename">smb.conf</code> file.</p></dd><dt><span class="term">-V</span></dt><dd><p>Prints the program version number.
    2424</p></dd><dt><span class="term">-s &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the
    … …  
    6363via the <code class="literal">ps</code> command.  To be safe always allow
    6464<code class="literal">rpcclient</code> to prompt for a password and type
    65 it in directly. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id299914"></a><h2>QUOTA_SET_COMAND</h2><p>The format of an the QUOTA_SET_COMMAND is an operation
     65it in directly. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481690"></a><h2>QUOTA_SET_COMAND</h2><p>The format of an the QUOTA_SET_COMMAND is an operation
    6666        name followed by a set of parameters specific to that operation.
    6767        </p><p>To set user quotas for the user specified by -u or for the
    … …  
    7575        </p><p><strong class="userinput"><code>
    7676        FSQFLAGS:QUOTA_ENABLED/DENY_DISK/LOG_SOFTLIMIT/LOG_HARD_LIMIT
    77         </code></strong></p><p>All limits are specified as a number of bytes.</p></div><div class="refsect1" lang="en"><a name="id299958"></a><h2>EXIT STATUS</h2><p>The <code class="literal">smbcquotas</code> program sets the exit status
     77        </code></strong></p><p>All limits are specified as a number of bytes.</p></div><div class="refsect1" lang="en"><a name="id2481743"></a><h2>EXIT STATUS</h2><p>The <code class="literal">smbcquotas</code> program sets the exit status
    7878        depending on the success or otherwise of the operations performed.
    7979        The exit status may be one of the following values. </p><p>If the operation succeeded, smbcquotas returns an exit
    … …  
    8181        or when there was an error getting or setting the quota(s), an exit status
    8282        of 1 is returned.  If there was an error parsing any command line
    83         arguments, an exit status of 2 is returned. </p></div><div class="refsect1" lang="en"><a name="id299985"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id299996"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     83        arguments, an exit status of 2 is returned. </p></div><div class="refsect1" lang="en"><a name="id2481776"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 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
    8484        were created by Andrew Tridgell. Samba is now developed
    8585        by the Samba Team as an Open Source project similar

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

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbd</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id290850"></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="id2483405"></a><h2>DESCRIPTION</h2><p>This program is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbd</code> is the server daemon that
    22        provides filesharing and printing services to Windows clients.
    33        The server provides filespace and printer services to
    … …  
    2222        the configuration file will not affect connections to any service
    2323        that is already established.  Either the user will have to
    24         disconnect from the service, or <code class="literal">smbd</code> killed and restarted.</p></div><div class="refsect1" lang="en"><a name="id258994"></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="id2483607"></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
    … …  
    6161use only by developers and generate HUGE amounts of log
    6262data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
    63 override the <a class="link" href="smb.conf.5.html#LOGLEVEL">log level</a> parameter
     63override the <a class="link" href="smb.conf.5.html#LOGLEVEL" target="_top">log level</a> parameter
    6464in the <code class="filename">smb.conf</code> file.</p></dd><dt><span class="term">-V</span></dt><dd><p>Prints the program version number.
    6565</p></dd><dt><span class="term">-s &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the
    … …  
    7777                Samba was built.</p></dd><dt><span class="term">-p|--port&lt;port number(s)&gt;</span></dt><dd><p><em class="replaceable"><code>port number(s)</code></em> is a
    7878                space or comma-separated list of TCP ports smbd should listen on.
    79                 The default value is taken from the <a class="link" href="smb.conf.5.html#PORTS">ports</a> parameter in <code class="filename">smb.conf</code></p><p>The default ports are 139 (used for SMB over NetBIOS over TCP)
     79                The default value is taken from the <a class="link" href="smb.conf.5.html#PORTS" target="_top">ports</a> parameter in <code class="filename">smb.conf</code></p><p>The default ports are 139 (used for SMB over NetBIOS over TCP)
    8080                        and port 445 (used for plain SMB over TCP).
    8181                </p></dd><dt><span class="term">-P|--profiling-level&lt;profiling level&gt;</span></dt><dd><p><em class="replaceable"><code>profiling level</code></em> is a
    … …  
    8383                0 turns off profiling, 1 turns on counter profiling only,
    8484                2 turns on complete profiling, and 3 resets all profiling data.
    85                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id299911"></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="id2481697"></a><h2>FILES</h2><div class="variablelist"><dl><dt><span class="term"><code class="filename">/etc/inetd.conf</code></span></dt><dd><p>If the server is to be run by the
    8686                <code class="literal">inetd</code> meta-daemon, this file
    8787                must contain suitable startup information for the
    … …  
    9797                install this file are <code class="filename">/usr/samba/lib/smb.conf</code>
    9898                and <code class="filename">/etc/samba/smb.conf</code>.</p><p>This file describes all the services the server
    99                 is to make available to clients. See <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> for more information.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id300024"></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="id2481823"></a><h2>LIMITATIONS</h2><p>On some systems <code class="literal">smbd</code> cannot change uid back
    100100        to root after a setuid() call.  Such systems are called
    101101        trapdoor uid systems. If you have such a system,
    … …  
    103103        two different users at once. Attempts to connect the
    104104        second user will result in access denied or
    105         similar.</p></div><div class="refsect1" lang="en"><a name="id300041"></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="id2481844"></a><h2>ENVIRONMENT VARIABLES</h2><div class="variablelist"><dl><dt><span class="term"><code class="envar">PRINTER</code></span></dt><dd><p>If no printer name is specified to
    106106                printable services, most systems will use the value of
    107107                this variable (or <code class="constant">lp</code> if this variable is
    108108                not defined) as the name of the printer to use. This
    109                 is not specific to the server, however.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id300068"></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="id2481873"></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
    112         by the limitations of the SMB protocol and the <a class="link" href="smb.conf.5.html#OBEYPAMRESTRICTIONS">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:
     112        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:
    113113        </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
    … …  
    120120        Note also that some older pam configuration files may need a line
    121121        added for session support.
    122         </p></li></ul></div></div><div class="refsect1" lang="en"><a name="id300114"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
    123         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id300125"></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="id2481932"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
     123        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2481943"></a><h2>DIAGNOSTICS</h2><p>Most diagnostics issued by the server are logged
    124124        in a specified log file. The log file name is specified
    125125        at compile time, but may be overridden on the command line.</p><p>The number and nature of diagnostics available depends
    … …  
    130130        diagnostic. At this stage your best bet is still to grep the
    131131        source code and inspect the conditions that gave rise to the
    132         diagnostics you are seeing.</p></div><div class="refsect1" lang="en"><a name="id300147"></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="id2481971"></a><h2>TDB FILES</h2><p>Samba stores it's data in several TDB (Trivial Database) files, usually located in <code class="filename">/var/lib/samba</code>.</p><p>
    133133        (*) information persistent across restarts (but not
    134134        necessarily important to backup).
    135         </p><div class="variablelist"><dl><dt><span class="term">account_policy.tdb*</span></dt><dd><p>NT account policy settings such as pw expiration, etc...</p></dd><dt><span class="term">brlock.tdb</span></dt><dd><p>byte range locks</p></dd><dt><span class="term">browse.dat</span></dt><dd><p>browse lists</p></dd><dt><span class="term">connections.tdb</span></dt><dd><p>share connections (used to enforce max connections, etc...)</p></dd><dt><span class="term">gencache.tdb</span></dt><dd><p>generic caching db</p></dd><dt><span class="term">group_mapping.tdb*</span></dt><dd><p>group mapping information</p></dd><dt><span class="term">locking.tdb</span></dt><dd><p>share modes &amp; oplocks</p></dd><dt><span class="term">login_cache.tdb*</span></dt><dd><p>bad pw attempts</p></dd><dt><span class="term">messages.tdb</span></dt><dd><p>Samba messaging system</p></dd><dt><span class="term">netsamlogon_cache.tdb*</span></dt><dd><p>cache of user net_info_3 struct from net_samlogon() request (as a domain member)</p></dd><dt><span class="term">ntdrivers.tdb*</span></dt><dd><p>installed printer drivers</p></dd><dt><span class="term">ntforms.tdb*</span></dt><dd><p>installed printer forms</p></dd><dt><span class="term">ntprinters.tdb*</span></dt><dd><p>installed printer information</p></dd><dt><span class="term">printing/</span></dt><dd><p>directory containing tdb per print queue of cached lpq output</p></dd><dt><span class="term">registry.tdb</span></dt><dd><p>Windows registry skeleton (connect via regedit.exe)</p></dd><dt><span class="term">sessionid.tdb</span></dt><dd><p>session information (e.g. support for 'utmp = yes')</p></dd><dt><span class="term">share_info.tdb*</span></dt><dd><p>share acls</p></dd><dt><span class="term">winbindd_cache.tdb</span></dt><dd><p>winbindd's cache of user lists, etc...</p></dd><dt><span class="term">winbindd_idmap.tdb*</span></dt><dd><p>winbindd's local idmap db</p></dd><dt><span class="term">wins.dat*</span></dt><dd><p>wins database when 'wins support = yes'</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id300367"></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="id2532665"></a><h2>SIGNALS</h2><p>Sending the <code class="literal">smbd</code> a SIGHUP will cause it to
    136136        reload its <code class="filename">smb.conf</code> configuration
    137137        file within a short period of time.</p><p>To shut down a user's <code class="literal">smbd</code> process it is recommended
    … …  
    148148        issuing them. It is possible to make the signal handlers safe
    149149        by un-blocking the signals before the select call and re-blocking
    150         them after, however this would affect performance.</p></div><div class="refsect1" lang="en"><a name="id300445"></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="id2532751"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="hosts_access.5.html"><span class="citerefentry"><span class="refentrytitle">hosts_access</span>(5)</span></a>, <a class="citerefentry" href="inetd.8.html"><span class="citerefentry"><span class="refentrytitle">inetd</span>(8)</span></a>, <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>, <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>, <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>, <a class="citerefentry" href="testparm.1.html"><span class="citerefentry"><span class="refentrytitle">testparm</span>(1)</span></a>, <a class="citerefentry" href="testprns.1.html"><span class="citerefentry"><span class="refentrytitle">testprns</span>(1)</span></a>, and the
    151151        Internet RFC's  <code class="filename">rfc1001.txt</code>, <code class="filename">rfc1002.txt</code>.
    152152        In addition the CIFS (formerly SMB) specification is available
    153153        as a link from the Web page <a class="ulink" href="http://samba.org/cifs/" target="_top">
    154         http://samba.org/cifs/</a>.</p></div><div class="refsect1" lang="en"><a name="id300524"></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="id2532831"></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.0/docs/htmldocs/manpages/smbget.1.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbget</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258974"></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="id2483571"></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" lang="en"><a name="id259004"></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="id258370"></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="id2483603"></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="id2483805"></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" lang="en"><a name="id299774"></a><h2>EXAMPLES</h2><pre class="programlisting">
     11</pre></div><div class="refsect1" lang="en"><a name="id2481521"></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" lang="en"><a name="id299788"></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="id2481538"></a><h2>BUGS</h2><p>Permission denied is returned in some cases where the cause of the error is unknown
    2121(such as an illegally formatted smb:// url or trying to get a directory without -R
    22 turned on).</p></div><div class="refsect1" lang="en"><a name="id299799"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
    23         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id299809"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     22turned on).</p></div><div class="refsect1" lang="en"><a name="id2481551"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
     23        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2481562"></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.0/docs/htmldocs/manpages/smbgetrc.5.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbgetrc</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258166"></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="id2522923"></a><h2>DESCRIPTION</h2><p>
    22                This manual page documents the format and options of the <span class="emphasis"><em>smbgetrc</em></span>
    33                file. This is the configuration file used by the <a class="citerefentry" href="smbget.1.html"><span class="citerefentry"><span class="refentrytitle">smbget</span>(1)</span></a>
    … …  
    55                        and value should be separated by a space.
    66        </p><p>By default, smbget reads its configuration from <span class="emphasis"><em>$HOME/.smbgetrc</em></span>, though
    7                 other locations can be specified using the command-line options.</p></div><div class="refsect1" lang="en"><a name="id258194"></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="id2522957"></a><h2>OPTIONS</h2><p>
    88        The following keys can be set:
    99</p><div class="variablelist"><dl><dt><span class="term">resume on|off</span></dt><dd><p>
    1010                        Whether aborted downloads should be automatically resumed.
    1111                        </p></dd><dt><span class="term">recursive on|off</span></dt><dd><p>Whether directories should be downloaded recursively</p></dd><dt><span class="term">username <em class="replaceable"><code>name</code></em></span></dt><dd><p>Username to use when logging in to the remote server. Use an empty string for anonymous access.
    12                         </p></dd><dt><span class="term">password <em class="replaceable"><code>pass</code></em></span></dt><dd><p>Password to use when logging in.</p></dd><dt><span class="term">workgroup <em class="replaceable"><code>wg</code></em></span></dt><dd><p>Workgroup to use when logging in</p></dd><dt><span class="term">nonprompt on|off</span></dt><dd><p>Turns off asking for username and password. Useful for scripts.</p></dd><dt><span class="term">debuglevel <em class="replaceable"><code>int</code></em></span></dt><dd><p>(Samba) debuglevel to run at. Useful for tracking down protocol level problems.</p></dd><dt><span class="term">dots on|off</span></dt><dd><p>Whether a single dot should be printed for each block that has been downloaded, instead of the default progress indicator.</p></dd><dt><span class="term">blocksize <em class="replaceable"><code>int</code></em></span></dt><dd><p>Number of bytes to put in a block. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id258961"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
    13         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id258972"></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="id258996"></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="id2483570"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
     13        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2483581"></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="id2483605"></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.0/docs/htmldocs/manpages/smbmnt.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbmnt</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="smbmnt.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbmnt &#8212; helper utility for mounting SMB filesystems</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbmnt</code> {mount-point} [-s &lt;share&gt;] [-r] [-u &lt;uid&gt;] [-g &lt;gid&gt;] [-f &lt;mask&gt;] [-d &lt;mask&gt;] [-o &lt;options&gt;] [-h]</p></div></div><div class="refsect1" lang="en"><a name="id290801"></a><h2>DESCRIPTION</h2><p><code class="literal">smbmnt</code> is a helper application used
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbmnt</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="smbmnt.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbmnt &#8212; helper utility for mounting SMB filesystems</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbmnt</code> {mount-point} [-s &lt;share&gt;] [-r] [-u &lt;uid&gt;] [-g &lt;gid&gt;] [-f &lt;mask&gt;] [-d &lt;mask&gt;] [-o &lt;options&gt;] [-h]</p></div></div><div class="refsect1" lang="en"><a name="id2483354"></a><h2>DESCRIPTION</h2><p><code class="literal">smbmnt</code> is a helper application used
    22        by the smbmount program to do the actual mounting of SMB shares.
    33        <code class="literal">smbmnt</code> can be installed setuid root if you want
    … …  
    55        by the user, and that the user has write permission on.</p><p>The <code class="literal">smbmnt</code> program is normally invoked
    66        by <a class="citerefentry" href="smbmount.8.html"><span class="citerefentry"><span class="refentrytitle">smbmount</span>(8)</span></a>. It should not be invoked directly by users. </p><p>smbmount searches the normal PATH for smbmnt. You must ensure
    7         that the smbmnt version in your path matches the smbmount used.</p></div><div class="refsect1" lang="en"><a name="id290849"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-r</span></dt><dd><p>mount the filesystem read-only
     7        that the smbmnt version in your path matches the smbmount used.</p></div><div class="refsect1" lang="en"><a name="id2483407"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-r</span></dt><dd><p>mount the filesystem read-only
    88                </p></dd><dt><span class="term">-u uid</span></dt><dd><p>specify the uid that the files will
    99                be owned by </p></dd><dt><span class="term">-g gid</span></dt><dd><p>specify the gid that the files will be
    … …  
    1414                command is run on a 2.4 or higher Linux kernel.
    1515                </p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    16 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id259007"></a><h2>AUTHOR</h2><p>Volker Lendecke, Andrew Tridgell, Michael H. Warfield
     16</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483614"></a><h2>AUTHOR</h2><p>Volker Lendecke, Andrew Tridgell, Michael H. Warfield
    1717        and others.</p><p>The current maintainer of smbfs and the userspace
    1818        tools <code class="literal">smbmount</code>, <code class="literal">smbumount</code>,

  • branches/samba-3.0/docs/htmldocs/manpages/smbmount.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbmount</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="smbmount.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbmount &#8212; mount an smbfs filesystem</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbmount</code> {service} {mount-point} [-o options]</p></div></div><div class="refsect1" lang="en"><a name="id258176"></a><h2>DESCRIPTION</h2><p><code class="literal">smbmount</code> mounts a Linux SMB filesystem. It
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbmount</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="smbmount.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbmount &#8212; mount an smbfs filesystem</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbmount</code> {service} {mount-point} [-o options]</p></div></div><div class="refsect1" lang="en"><a name="id2522934"></a><h2>DESCRIPTION</h2><p><code class="literal">smbmount</code> mounts a Linux SMB filesystem. It
    22        is usually invoked as <code class="literal">mount.smbfs</code> by
    33        the <a class="citerefentry" href="mount.8.html"><span class="citerefentry"><span class="refentrytitle">mount</span>(8)</span></a> command when using the
    … …  
    1616        calls <a class="citerefentry" href="smbmnt.8.html"><span class="citerefentry"><span class="refentrytitle">smbmnt</span>(8)</span></a> to do the actual mount. You
    1717        must make sure that <code class="literal">smbmnt</code> is in the path so
    18         that it can be found. </p></div></div><div class="refsect1" lang="en"><a name="id258933"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">username=&lt;arg&gt;</span></dt><dd><p>
     18        that it can be found. </p></div></div><div class="refsect1" lang="en"><a name="id2483538"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">username=&lt;arg&gt;</span></dt><dd><p>
    1919                specifies the username to connect as. If this is not given, then the environment variable <code class="envar"> USER</code>
    2020                is used. This option can also take the form "user%password" or "user/workgroup" or "user/workgroup%password"
    … …  
    7474                in many cases.
    7575                (Note: only kernel 2.4.2 or later)
    76                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id299783"></a><h2>ENVIRONMENT VARIABLES</h2><p>The variable <code class="envar">USER</code> may contain the username of the
     76                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481557"></a><h2>ENVIRONMENT VARIABLES</h2><p>The variable <code class="envar">USER</code> may contain the username of the
    7777        person using the client.  This information is used only if the
    7878        protocol level is high enough to support session-level
    … …  
    8383        passwords.</p><p>The variable <code class="envar">PASSWD_FILE</code> may contain the pathname
    8484        of a file to read the password from. A single line of input is
    85         read and used as the password.</p></div><div class="refsect1" lang="en"><a name="id299813"></a><h2>OTHER COMMANDS</h2><p>
     85        read and used as the password.</p></div><div class="refsect1" lang="en"><a name="id2481595"></a><h2>OTHER COMMANDS</h2><p>
    8686        File systems that have been mounted using the <code class="literal">smbmount</code>
    8787        can be unmounted using the <code class="literal">smbumount</code> or the UNIX system
    8888        <code class="literal">umount</code> command.
    89         </p></div><div class="refsect1" lang="en"><a name="id299838"></a><h2>BUGS</h2><p>Passwords and other options containing , can not be handled.
     89        </p></div><div class="refsect1" lang="en"><a name="id2481623"></a><h2>BUGS</h2><p>Passwords and other options containing , can not be handled.
    9090        For passwords an alternative way of passing them is in a credentials
    9191        file or in the PASSWD environment.</p><p>The credentials file does not handle usernames or passwords with
    … …  
    9898        to try the latest version first. So please try doing that first,
    9999        and always include which versions you use of relevant software
    100         when reporting bugs (minimum: samba, kernel, distribution)</p></div><div class="refsect1" lang="en"><a name="id299873"></a><h2>SEE ALSO</h2><p>Documentation/filesystems/smbfs.txt in the linux kernel
     100        when reporting bugs (minimum: samba, kernel, distribution)</p></div><div class="refsect1" lang="en"><a name="id2481665"></a><h2>SEE ALSO</h2><p>Documentation/filesystems/smbfs.txt in the linux kernel
    101101        source tree may contain additional options and information.</p><p>FreeBSD also has a smbfs, but it is not related to smbmount</p><p>For Solaris, HP-UX and others you may want to look at <a class="citerefentry" href="smbsh.1.html"><span class="citerefentry"><span class="refentrytitle">smbsh</span>(1)</span></a> or at other solutions, such as
    102         Sharity or perhaps replacing the SMB server with a NFS server.</p></div><div class="refsect1" lang="en"><a name="id299899"></a><h2>AUTHOR</h2><p>Volker Lendecke, Andrew Tridgell, Michael H. Warfield
     102        Sharity or perhaps replacing the SMB server with a NFS server.</p></div><div class="refsect1" lang="en"><a name="id2481695"></a><h2>AUTHOR</h2><p>Volker Lendecke, Andrew Tridgell, Michael H. Warfield
    103103        and others.</p><p>The current maintainer of smbfs and the userspace
    104104        tools <code class="literal">smbmount</code>, <code class="literal">smbumount</code>,

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

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbpasswd</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258166"></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="id2522923"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>smbpasswd is the Samba encrypted password file. It contains
    22        the username, Unix user id and the SMB hashed passwords of the
    33        user, as well as account flag information and the time the
    44        password was last changed. This file format has been evolving with
    5         Samba and has had several different formats in the past. </p></div><div class="refsect1" lang="en"><a name="id258190"></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="id2522950"></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
    … …  
    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" lang="en"><a name="id259059"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
    80         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id258236"></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="id2483701"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
     80        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2483712"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a>, <a class="citerefentry" href="Samba.7.html"><span class="citerefentry"><span class="refentrytitle">Samba</span>(7)</span></a>, and
    8181        the Internet RFC1321 for details on the MD4 algorithm.
    82         </p></div><div class="refsect1" lang="en"><a name="id258261"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     82        </p></div><div class="refsect1" lang="en"><a name="id2483738"></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.0/docs/htmldocs/manpages/smbpasswd.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbpasswd</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258956"></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="id2483557"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The smbpasswd program has several different
    22        functions, depending on whether it is run by the <span class="emphasis"><em>root</em></span> user
    33        or not. When run as a normal user it allows the user to change
    … …  
    2626        smbpasswd</code> accesses the local smbpasswd file
    2727        directly, thus enabling changes to be made even if smbd is not
    28         running. </p></div><div class="refsect1" lang="en"><a name="id259059"></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="id2483679"></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
    … …  
    129129                has been compiled with LDAP support. The <em class="parameter"><code>-w</code></em>
    130130                switch is used to specify the password to be used with the
    131                 <a class="link" href="smb.conf.5.html#LDAPADMINDN">ldap admin dn</a>.  Note that the password is stored in
     131                <a class="link" href="smb.conf.5.html#LDAPADMINDN" target="_top">ldap admin dn</a>.  Note that the password is stored in
    132132                the <code class="filename">secrets.tdb</code> and is keyed off
    133133                of the admin's DN.  This means that if the value of <em class="parameter"><code>ldap
    … …  
    139139                has been compiled with LDAP support. The <em class="parameter"><code>-W</code></em>
    140140                switch is used to specify the password to be used with the
    141                 <a class="link" href="smb.conf.5.html#LDAPADMINDN">ldap admin dn</a>.  Note that the password is stored in
     141                <a class="link" href="smb.conf.5.html#LDAPADMINDN" target="_top">ldap admin dn</a>.  Note that the password is stored in
    142142                the <code class="filename">secrets.tdb</code> and is keyed off
    143143                of the admin's DN.  This means that if the value of <em class="parameter"><code>ldap
    … …  
    152152                can specify this parameter as only root has the permission needed
    153153                to modify attributes directly in the local smbpasswd file.
    154                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id300254"></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="id2532569"></a><h2>NOTES</h2><p>Since <code class="literal">smbpasswd</code> works in client-server
    155155        mode communicating  with a local smbd for a non-root user then
    156156        the smbd daemon must be running for this to work. A common problem
    … …  
    160160        the <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file and neglecting to
    161161        allow "localhost" access to the smbd. </p><p>In addition, the smbpasswd command is only useful if Samba
    162         has been set up to use encrypted passwords. </p></div><div class="refsect1" lang="en"><a name="id300298"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id300309"></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="id300332"></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="id2532618"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2532629"></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="id2532652"></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.0/docs/htmldocs/manpages/smbspool.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbspool</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id290795"></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="id2483345"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>smbspool is a very small print spooling program that
    22        sends a print file to an SMB printer. The command-line arguments
    33        are position-dependent for compatibility with the Common UNIX
    … …  
    1111        pass the URI in argv[0], while shell scripts must set the
    1212        <code class="envar">DEVICE_URI</code> environment variable prior to
    13         running smbspool.</p></div><div class="refsect1" lang="en"><a name="id258947"></a><h2>OPTIONS</h2><div class="itemizedlist"><ul type="disc"><li><p>The job argument (argv[1]) contains the
     13        running smbspool.</p></div><div class="refsect1" lang="en"><a name="id2483552"></a><h2>OPTIONS</h2><div class="itemizedlist"><ul type="disc"><li><p>The job argument (argv[1]) contains the
    1414                job ID number and is presently not used by smbspool.
    1515                </p></li><li><p>The user argument (argv[2]) contains the
    … …  
    2424                not used by smbspool.</p></li><li><p>The filename argument (argv[6]) contains the
    2525                name of the file to print. If this argument is not specified
    26                 then the print file is read from the standard input.</p></li></ul></div></div><div class="refsect1" lang="en"><a name="id258991"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id259001"></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="id259026"></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="id2483603"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2483614"></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="id2483638"></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.0/docs/htmldocs/manpages/smbstatus.1.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbstatus</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id290825"></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="id290850"></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="id2483379"></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="id2483406"></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
    … …  
    1414use only by developers and generate HUGE amounts of log
    1515data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
    16 override the <a class="link" href="smb.conf.5.html#LOGLEVEL">log level</a> parameter
     16override the <a class="link" href="smb.conf.5.html#LOGLEVEL" target="_top">log level</a> parameter
    1717in the <code class="filename">smb.conf</code> file.</p></dd><dt><span class="term">-V</span></dt><dd><p>Prints the program version number.
    1818</p></dd><dt><span class="term">-s &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the
    … …  
    2929                </p></dd><dt><span class="term">-p|--processes</span></dt><dd><p>print a list of <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> processes and exit.
    3030                Useful for scripting.</p></dd><dt><span class="term">-S|--shares</span></dt><dd><p>causes smbstatus to only list shares.</p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    31 </p></dd><dt><span class="term">-u|--user=&lt;username&gt;</span></dt><dd><p>selects information relevant to <em class="parameter"><code>username</code></em> only.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id299781"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
    32         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id299790"></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="id299814"></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="id2481537"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
     32        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2481548"></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="id2481573"></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.0/docs/htmldocs/manpages/smbtar.1.html

    r158 r286  
    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.73.2"></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="id258935"></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="id258968"></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="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><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="id2483567"></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" lang="en"><a name="id258340"></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="id2483787"></a><h2>ENVIRONMENT VARIABLES</h2><p>The <em class="parameter"><code>$TAPE</code></em> variable specifies the
    2121        default tape device to write to. May be overridden
    22         with the -t option. </p></div><div class="refsect1" lang="en"><a name="id258357"></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="id258373"></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="id2483804"></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="id2481496"></a><h2>CAVEATS</h2><p>Sites that are more careful about security may not like
    2424        the way the script handles PC passwords. Backup and restore work
    2525        on entire shares; should work on file lists. smbtar works best
    26         with GNU tar and may not work well with other versions. </p></div><div class="refsect1" lang="en"><a name="id299754"></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="id299776"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
    27         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id299785"></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="id299817"></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="id2481510"></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="id2481533"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
     27        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2481544"></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="id2481579"></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.0/docs/htmldocs/manpages/smbtree.1.html

    r158 r286  
    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.73.2"></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="id258192"></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="id2522950"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbtree</code> is a smb browser program
    33        in text mode. It is similar to the "Network Neighborhood" found
    44        on Windows computers. It prints a tree with all
    55        the known domains, the servers in those domains and
    66        the shares on the servers.
    7         </p></div><div class="refsect1" lang="en"><a name="id290799"></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="id2483353"></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
    … …  
    2424use only by developers and generate HUGE amounts of log
    2525data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
    26 override the <a class="link" href="smb.conf.5.html#LOGLEVEL">log level</a> parameter
     26override the <a class="link" href="smb.conf.5.html#LOGLEVEL" target="_top">log level</a> parameter
    2727in the <code class="filename">smb.conf</code> file.</p></dd><dt><span class="term">-V</span></dt><dd><p>Prints the program version number.
    2828</p></dd><dt><span class="term">-s &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the
    … …  
    6868<code class="literal">rpcclient</code> to prompt for a password and type
    6969it in directly. </p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    70 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id299769"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba
    71         suite.</p></div><div class="refsect1" lang="en"><a name="id299779"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     70</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481534"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba
     71        suite.</p></div><div class="refsect1" lang="en"><a name="id2481545"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    7272        were created by Andrew Tridgell. Samba is now developed
    7373        by the Samba Team as an Open Source project similar

  • branches/samba-3.0/docs/htmldocs/manpages/smbumount.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbumount</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="smbumount.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbumount &#8212; smbfs umount for normal users</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbumount</code> {mount-point}</p></div></div><div class="refsect1" lang="en"><a name="id258746"></a><h2>DESCRIPTION</h2><p>With this program, normal users can unmount smb-filesystems,
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbumount</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="smbumount.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbumount &#8212; smbfs umount for normal users</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbumount</code> {mount-point}</p></div></div><div class="refsect1" lang="en"><a name="id2522918"></a><h2>DESCRIPTION</h2><p>With this program, normal users can unmount smb-filesystems,
    22        provided that it is suid root.  <code class="literal">smbumount</code> has
    33        been written to give normal Linux users more control over their
    … …  
    77        program works perfectly well.</p><p>WARNING: <code class="literal">smbumount</code> is deprecated and not
    88        maintained any longer. <code class="literal">umount.cifs</code>
    9         should be used instead of <code class="literal">smbumount</code>.</p></div><div class="refsect1" lang="en"><a name="id290780"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">mount-point</span></dt><dd><p>The directory to unmount.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id290802"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbmount.8.html"><span class="citerefentry"><span class="refentrytitle">smbmount</span>(8)</span></a></p></div><div class="refsect1" lang="en"><a name="id290817"></a><h2>AUTHOR</h2><p>Volker Lendecke, Andrew Tridgell, Michael H. Warfield
     9        should be used instead of <code class="literal">smbumount</code>.</p></div><div class="refsect1" lang="en"><a name="id2522963"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">mount-point</span></dt><dd><p>The directory to unmount.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483356"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbmount.8.html"><span class="citerefentry"><span class="refentrytitle">smbmount</span>(8)</span></a></p></div><div class="refsect1" lang="en"><a name="id2483372"></a><h2>AUTHOR</h2><p>Volker Lendecke, Andrew Tridgell, Michael H. Warfield
    1010        and others.</p><p>The current maintainer of smbfs and the userspace
    1111        tools <code class="literal">smbmount</code>, <code class="literal">smbumount</code>,

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

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>swat</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258192"></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="id2522953"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">swat</code> allows a Samba administrator to
    22        configure the complex <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file via a Web browser. In addition,
    33        a <code class="literal">swat</code> configuration page has help links
    44        to all the configurable options in the <code class="filename">smb.conf</code> file allowing an
    5         administrator to easily look up the effects of any change. </p><p><code class="literal">swat</code> is run from <code class="literal">inetd</code> </p></div><div class="refsect1" lang="en"><a name="id290831"></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="id2483388"></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
    … …  
    2929use only by developers and generate HUGE amounts of log
    3030data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
    31 override the <a class="link" href="smb.conf.5.html#LOGLEVEL">log level</a> parameter
     31override the <a class="link" href="smb.conf.5.html#LOGLEVEL" target="_top">log level</a> parameter
    3232in the <code class="filename">smb.conf</code> file.</p></dd><dt><span class="term">-V</span></dt><dd><p>Prints the program version number.
    3333</p></dd><dt><span class="term">-s &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the
    … …  
    4242log.smbd, etc...). The log file is never removed by the client.
    4343</p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    44 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id259052"></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="id2481492"></a><h2>INSTALLATION</h2><p>Swat is included as binary package with most distributions. The
    4545        package manager in this case takes care of the installation and
    4646        configuration. This section is only for those who have compiled
    … …  
    4949        </code> to install the <code class="literal">swat</code> binary
    5050        and the various help files and images. A default install would put
    51         these in: </p><div class="itemizedlist"><ul type="disc"><li><p>/usr/local/samba/sbin/swat</p></li><li><p>/usr/local/samba/swat/images/*</p></li><li><p>/usr/local/samba/swat/help/*</p></li></ul></div><div class="refsect2" lang="en"><a name="id299777"></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="id2481539"></a><h3>Inetd Installation</h3><p>You need to edit your <code class="filename">/etc/inetd.conf
    5252                </code> and <code class="filename">/etc/services</code>
    5353                to enable SWAT to be launched via <code class="literal">inetd</code>.</p><p>In <code class="filename">/etc/services</code> you need to
    … …  
    6363                and <code class="filename">/etc/inetd.conf</code> you need to send a
    6464                HUP signal to inetd. To do this use <code class="literal">kill -1 PID
    65                 </code> where PID is the process ID of the inetd daemon. </p></div></div><div class="refsect1" lang="en"><a name="id299873"></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="id2481651"></a><h2>LAUNCHING</h2><p>To launch SWAT just run your favorite web browser and
    6666        point it at "http://localhost:901/".</p><p>Note that you can attach to SWAT from any IP connected
    6767        machine but connecting from a remote machine leaves your
    6868        connection open to password sniffing as passwords will be sent
    69         in the clear over the wire. </p></div><div class="refsect1" lang="en"><a name="id299889"></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="id2481670"></a><h2>FILES</h2><div class="variablelist"><dl><dt><span class="term"><code class="filename">/etc/inetd.conf</code></span></dt><dd><p>This file must contain suitable startup
    7070                information for the meta-daemon.</p></dd><dt><span class="term"><code class="filename">/etc/services</code></span></dt><dd><p>This file must contain a mapping of service name
    7171                (e.g., swat) to service port (e.g., 901) and protocol type
    … …  
    7474                /usr/samba/lib/smb.conf</code> and <code class="filename">/etc/smb.conf
    7575                </code>.  This file describes all the services the server
    76                 is to make available to clients. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id299962"></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="id2481751"></a><h2>WARNINGS</h2><p><code class="literal">swat</code> will rewrite your <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file. It will rearrange the entries and delete all
    7777        comments, <em class="parameter"><code>include=</code></em> and <em class="parameter"><code>copy=
    7878        </code></em> options. If you have a carefully crafted <code class="filename">
    79         smb.conf</code> then back it up or don't use swat! </p></div><div class="refsect1" lang="en"><a name="id300001"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id300011"></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="id300040"></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="id2481795"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2481806"></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="id2481836"></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.0/docs/htmldocs/manpages/tdbbackup.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>tdbbackup</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258192"></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="id2522953"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.1.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(1)</span></a> suite.</p><p><code class="literal">tdbbackup</code> is a tool that may be used to backup samba .tdb
    22        files. This tool may also be used to verify the integrity of the .tdb files prior
    33        to samba startup or during normal operation. If it finds file damage and it finds
    44        a prior backup the backup file will be restored.
    5         </p></div><div class="refsect1" lang="en"><a name="id290799"></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="id2483356"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h</span></dt><dd><p>
    66                Get help information.
    77                </p></dd><dt><span class="term">-s suffix</span></dt><dd><p>
    … …  
    1212                The <code class="literal">-v</code> will check the database for damages (currupt data)
    1313                which if detected causes the backup to be restored.
    14                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id258928"></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="id2483532"></a><h2>COMMANDS</h2><p><span class="emphasis"><em>GENERAL INFORMATION</em></span></p><p>
    1515        The <code class="literal">tdbbackup</code> utility can safely be run at any time. It was designed so
    1616        that it can be used at any time to validate the integrity of tdb files, even during Samba
    … …  
    3030                <code class="literal">*.tdb</code> located in the /usr/local/samba/var directory or on some
    3131                systems in the /var/cache or /var/lib/samba directories.
    32                 </p></li></ul></div></div><div class="refsect1" lang="en"><a name="id259001"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id259011"></a><h2>AUTHOR</h2><p>
     32                </p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2483612"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2483623"></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.0/docs/htmldocs/manpages/tdbdump.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>tdbdump</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258177"></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="id2522936"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.1.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(1)</span></a> suite.</p><p><code class="literal">tdbdump</code> is a very simple utility that 'dumps' the
    22                contents of a TDB (Trivial DataBase) file to standard output in a
    33                human-readable format.
    44        </p><p>This tool can be used when debugging problems with TDB files. It is
    55                intended for those who are somewhat familiar with Samba internals.
    6         </p></div><div class="refsect1" lang="en"><a name="id290789"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id290798"></a><h2>AUTHOR</h2><p>
     6        </p></div><div class="refsect1" lang="en"><a name="id2483343"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2483354"></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.0/docs/htmldocs/manpages/tdbtool.8.html

    r158 r286  
    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.73.2"></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> 
     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" lang="en"><a name="id290782"></a><h2>DESCRIPTION</h2><p>This tool is part of the
     5                ...]</p></div></div><div class="refsect1" lang="en"><a name="id2522960"></a><h2>DESCRIPTION</h2><p>This tool is part of the
    66        <a class="citerefentry" href="samba.1.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(1)</span></a> suite.</p><p><code class="literal">tdbtool</code> a tool for displaying and
    77        altering the contents of Samba TDB (Trivial DataBase) files. Each
    88        of the commands listed below can be entered interactively or
    9         provided on the command line.</p></div><div class="refsect1" lang="en"><a name="id290810"></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="id2483362"></a><h2>COMMANDS</h2><div class="variablelist"><dl><dt><span class="term"><code class="option">create</code>
    1010                <em class="replaceable"><code>TDBFILE</code></em></span></dt><dd><p>Create a new database named
    1111                <em class="replaceable"><code>TDBFILE</code></em>.
    … …  
    5757                <code class="option">quit</code>
    5858                </span></dt><dd><p>Exit <code class="literal">tdbtool</code>.
    59                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id258358"></a><h2>CAVEATS</h2><p>The contents of the Samba TDB files are private
     59                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483796"></a><h2>CAVEATS</h2><p>The contents of the Samba TDB files are private
    6060        to the implementation and should not be altered with
    6161        <code class="literal">tdbtool</code>.
    62         </p></div><div class="refsect1" lang="en"><a name="id258374"></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="id299753"></a><h2>AUTHOR</h2><p> The original Samba software and related utilities were
     62        </p></div><div class="refsect1" lang="en"><a name="id2481486"></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="id2481497"></a><h2>AUTHOR</h2><p> The original Samba software and related utilities were
    6363        created by Andrew Tridgell.  Samba is now developed by the
    6464        Samba Team as an Open Source project similar to the way the

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

    r158 r286  
    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.73.2"></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="id290803"></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="id2483356"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">testparm</code> is a very simple test program
    33        to check an <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> configuration file for
    44        internal correctness. If this program reports no problems, you
    … …  
    1212        smb.conf</code> file it returns an exit code of 1 to the calling
    1313        program, else it returns an exit code of 0. This allows shell scripts
    14         to test the output from <code class="literal">testparm</code>.</p></div><div class="refsect1" lang="en"><a name="id258949"></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="id2483556"></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" lang="en"><a name="id258314"></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="id2483766"></a><h2>FILES</h2><div class="variablelist"><dl><dt><span class="term"><a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a></span></dt><dd><p>This is usually the name of the configuration
    4545                file used by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>.
    46                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id258348"></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="id2483801"></a><h2>DIAGNOSTICS</h2><p>The program will issue a message saying whether the
    4747        configuration file loaded OK or not. This message may be preceded by
    4848        errors and warnings if the file did not load. If the file was
    4949        loaded OK, the program then dumps all known service details
    50         to stdout. </p></div><div class="refsect1" lang="en"><a name="id258360"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
    51         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id258370"></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="id299765"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     50        to stdout. </p></div><div class="refsect1" lang="en"><a name="id2481491"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
     51        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2481502"></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="id2481528"></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.0/docs/htmldocs/manpages/umount.cifs.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>umount.cifs</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258186"></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="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>umount.cifs unmounts a Linux CIFS filesystem. It can be invoked
    22indirectly by the
    33<a class="citerefentry" href="umount.8.html"><span class="citerefentry"><span class="refentrytitle">umount</span>(8)</span></a> command
    … …  
    1212setuid root (or equivalently update the /etc/permissions file) to allow non-root users to umount shares to directories for which they have write permission.  The umount.cifs utility is typically
    1313not needed if unmounts need only be performed by root users, or if user mounts and unmounts
    14 can rely on specifying explicit entries in /etc/fstab See</p><p><a class="citerefentry" href="fstab.5.html"><span class="citerefentry"><span class="refentrytitle">fstab</span>(5)</span></a></p></div><div class="refsect1" lang="en"><a name="id290818"></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="id290850"></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="id258934"></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="id2483381"></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="id2483415"></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="id2483546"></a><h2>CONFIGURATION</h2><p>
    1515The primary mechanism for making configuration changes and for reading
    1616debug information for the cifs vfs is via the Linux /proc filesystem.
    … …  
    1818configuration files and pseudo files which can display debug information. 
    1919For more information see the kernel file <code class="filename">fs/cifs/README</code>.
    20 </p></div><div class="refsect1" lang="en"><a name="id258958"></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="id2483573"></a><h2>BUGS</h2><p>At this time umount.cifs does not lock the mount table using the same lock as the umount utility does, so do not attempt to do multiple unmounts from different processes (and in particular unmounts of a cifs mount and another type of filesystem mount at the same time).
    2121        </p><p>If the same mount point is mounted multiple times by cifs, umount.cifs will remove all of the matching entries from the mount table (although umount.cifs will actually only unmount the last one), rather than only removing the last matching entry in /etc/mtab.  The pseudofile /proc/mounts will display correct information though, and the lack of an entry in /etc/mtab does not prevent subsequent unmounts.</p><p>
    2222Note that the typical response to a bug report is a suggestion
    … …  
    2525when reporting bugs (minimum: umount.cifs (try umount.cifs -V), kernel (see /proc/version) and
    2626server type you are trying to contact.
    27 </p></div><div class="refsect1" lang="en"><a name="id258983"></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="id258993"></a><h2>SEE ALSO</h2><p>
     27</p></div><div class="refsect1" lang="en"><a name="id2483607"></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="id2483619"></a><h2>SEE ALSO</h2><p>
    2929        Documentation/filesystems/cifs.txt and fs/cifs/README in the linux kernel
    3030        source tree may contain additional options and information.
    31 </p><p><a class="citerefentry" href="mount.cifs.8.html"><span class="citerefentry"><span class="refentrytitle">mount.cifs</span>(8)</span></a></p></div><div class="refsect1" lang="en"><a name="id259013"></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="id2483640"></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.0/docs/htmldocs/manpages/vfs_audit.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_audit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258169"></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="id2522928"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_audit</code> VFS module records selected
    33        client operations to the system log using
    4         <a class="citerefentry" href="syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>.</p><p>The following Samba VFS operations are recorded:</p><table class="simplelist" border="0" summary="Simple list"><tr><td>connect</td></tr><tr><td>disconnect</td></tr><tr><td>opendir</td></tr><tr><td>mkdir</td></tr><tr><td>rmdir</td></tr><tr><td>open</td></tr><tr><td>close</td></tr><tr><td>rename</td></tr><tr><td>unlink</td></tr><tr><td>chmod</td></tr><tr><td>fchmod</td></tr><tr><td>chmod_acl</td></tr><tr><td>fchmod_acl</td></tr></table><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id290841"></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="id2483394"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">audit:facility = FACILITY</span></dt><dd><p>Log messages to the named
    55                <a class="citerefentry" href="syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a> facility.
    66
    77                </p></dd><dt><span class="term">audit:priority = PRIORITY</span></dt><dd><p>Log messages with the named
    88                <a class="citerefentry" href="syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a> priority.
    9                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id258964"></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="id2483562"></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>
    12         <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = audit</a>
    13         <a class="link" href="smb.conf.5.html#AUDIT:FACILITY">audit:facility = LOCAL1</a>
    14         <a class="link" href="smb.conf.5.html#AUDIT:PRIORITY">audit:priority = NOTICE</a>
    15 </pre></div><div class="refsect1" lang="en"><a name="id258367"></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="id258377"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     12        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = audit</a>
     13        <a class="link" href="smb.conf.5.html#AUDIT:FACILITY" target="_top">audit:facility = LOCAL1</a>
     14        <a class="link" href="smb.conf.5.html#AUDIT:PRIORITY" target="_top">audit:priority = NOTICE</a>
     15</pre></div><div class="refsect1" lang="en"><a name="id2483718"></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="id2483729"></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.0/docs/htmldocs/manpages/vfs_cacheprime.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_cacheprime</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258170"></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="id2522928"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_cacheprime</code> VFS module reads chunks
    33        of file data near the range requested by clients in order to
    … …  
    88        on boundaries that are a multiple of this size. Each range of
    99        the file data is primed at most once during the time the client
    10         has the file open. </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id290793"></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="id290850"></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="id2483351"></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="id2483410"></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:
    1414        </p><pre class="programlisting">
    1515        <em class="parameter"><code>[hypothetical]</code></em>
    16         <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = cacheprime</a>
    17         <a class="link" href="smb.conf.5.html#CACHEPRIME:RSIZE">cacheprime:rsize = 1M</a>
    18 </pre></div><div class="refsect1" lang="en"><a name="id259066"></a><h2>CAVEATS</h2><p><code class="literal">cacheprime</code> is not a a substitute for
     16        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = cacheprime</a>
     17        <a class="link" href="smb.conf.5.html#CACHEPRIME:RSIZE" target="_top">cacheprime:rsize = 1M</a>
     18</pre></div><div class="refsect1" lang="en"><a name="id2483669"></a><h2>CAVEATS</h2><p><code class="literal">cacheprime</code> is not a a substitute for
    1919        a general-purpose readahead mechanism. It is intended for use
    2020        only in very specific environments where disk operations must
    2121        be aligned and sized to known values (as much as that is possible).
    22         </p></div><div class="refsect1" lang="en"><a name="id258249"></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="id258259"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     22        </p></div><div class="refsect1" lang="en"><a name="id2483687"></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="id2483698"></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.0/docs/htmldocs/manpages/vfs_cap.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_cap</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258169"></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="id2522927"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>CAP (Columbia Appletalk Protocol) encoding is a
    33        technique for representing non-ASCII filenames in ASCII. The
    … …  
    55        from CAP format, allowing users to name files in their native
    66        encoding.  </p><p>CAP encoding is most commonly
    7         used in Japanese language environments. </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id290785"></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="id2522966"></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>
    10         <a class="link" href="smb.conf.5.html#DOSCHARSET">dos charset = CP932</a>
    11         <a class="link" href="smb.conf.5.html#DOSCHARSET">dos charset = CP932</a>
    12         <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = cap</a>
    13 </pre></div><div class="refsect1" lang="en"><a name="id259058"></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="id259067"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     10        <a class="link" href="smb.conf.5.html#DOSCHARSET" target="_top">dos charset = CP932</a>
     11        <a class="link" href="smb.conf.5.html#DOSCHARSET" target="_top">dos charset = CP932</a>
     12        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = cap</a>
     13</pre></div><div class="refsect1" lang="en"><a name="id2483390"></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="id2483401"></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.0/docs/htmldocs/manpages/vfs_catia.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_catia</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258169"></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="id2522928"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The Catia CAD package commonly creates filenames that
    33        use characters that are illegal in CIFS filenames. The
    44        <code class="literal">vfs_catia</code> VFS module implements a fixed character
    55        mapping so that these files can be shared with CIFS clients.
    6         </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id290782"></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="id2522962"></a><h2>EXAMPLES</h2><p>Map Catia filenames on the [CAD] share:</p><pre class="programlisting">
    77        <em class="parameter"><code>[CAD]</code></em>
    8         <a class="link" href="smb.conf.5.html#PATH">path = /data/cad</a>
    9         <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = catia</a>
    10 </pre></div><div class="refsect1" lang="en"><a name="id259048"></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="id259058"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     8        <a class="link" href="smb.conf.5.html#PATH" target="_top">path = /data/cad</a>
     9        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = catia</a>
     10</pre></div><div class="refsect1" lang="en"><a name="id2483376"></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="id2483387"></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.0/docs/htmldocs/manpages/vfs_commit.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_commit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258169"></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="id2522928"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_commit</code> VFS module keeps track of
    33        the amount of data written to a file and synchronizes it to
    … …  
    88        commit:dthresh value. Secondly, write performance can be
    99        improved on some systems by flushing file data early and at
    10         regular intervals.</p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id290791"></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="id2483346"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">commit:dthresh = BYTES</span></dt><dd><p>Synchronize file data each time the specified
    1111                number of bytes has been written.
    12                 </p><p>The following suffixes may be applied to BYTES:</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">K</code> - BYTES is a number of kilobytes</p></li><li><p><code class="literal">M</code> - BYTES is a number of megabytes</p></li><li><p><code class="literal">G</code> - BYTES is a number of gigabytes</p></li></ul></div></dd></dl></div></div><div class="refsect1" lang="en"><a name="id290848"></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="id2483405"></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>
    15         <a class="link" href="smb.conf.5.html#PATH">path = /data/precious</a>
    16         <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = commit</a>
    17         <a class="link" href="smb.conf.5.html#COMMIT:DTHRESH">commit:dthresh = 512K</a>
    18 </pre></div><div class="refsect1" lang="en"><a name="id258242"></a><h2>CAVEATS</h2><p>On some systems, the data synchronization performed by
     15        <a class="link" href="smb.conf.5.html#PATH" target="_top">path = /data/precious</a>
     16        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = commit</a>
     17        <a class="link" href="smb.conf.5.html#COMMIT:DTHRESH" target="_top">commit:dthresh = 512K</a>
     18</pre></div><div class="refsect1" lang="en"><a name="id2483675"></a><h2>CAVEATS</h2><p>On some systems, the data synchronization performed by
    1919        <code class="literal">commit</code> may reduce performance.
    20         </p></div><div class="refsect1" lang="en"><a name="id258258"></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="id258268"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     20        </p></div><div class="refsect1" lang="en"><a name="id2483692"></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="id2483703"></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.0/docs/htmldocs/manpages/vfs_default_quota.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_default_quota</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258169"></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="id2522930"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>
    33        suite.</p><p>Many common quota implementations only store
    … …  
    1010        the default quota to the quota record of a user. By default the
    1111        root user is taken because quota limits for root are typically
    12         not enforced.</p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id290792"></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="id2483353"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">default_quota:uid = UID</span></dt><dd><p>UID specifies the user ID of the quota record where the
    1313                default user quota values are stored.
    1414                </p></dd><dt><span class="term">default_quota:gid = GID</span></dt><dd><p>GID specifies the group ID of the quota record where the
    … …  
    2222                be reported as having a quota of NO_LIMIT. Otherwise,
    2323                the stored values will be reported.
    24                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id258930"></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="id2483532"></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">
    2727        <em class="parameter"><code>[global]</code></em>
    28         <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = default_quota</a>
    29         <a class="link" href="smb.conf.5.html#DEFAULT_QUOTA:UID">default_quota:uid = 65535</a>
    30         <a class="link" href="smb.conf.5.html#DEFAULT_QUOTA:UIDNOLIMIT">default_quota:uid nolimit = yes</a>
    31 </pre></div><div class="refsect1" lang="en"><a name="id258254"></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="id258263"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     28        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = default_quota</a>
     29        <a class="link" href="smb.conf.5.html#DEFAULT_QUOTA:UID" target="_top">default_quota:uid = 65535</a>
     30        <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" lang="en"><a name="id2483687"></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="id2483698"></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.0/docs/htmldocs/manpages/vfs_extd_audit.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_extd_audit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258170"></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="id2522928"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">extd_audit</code> VFS module records selected
    33        client operations to both the
    … …  
    88        <code class="literal">vfs_extd_audit</code> is identical to
    99        <a class="citerefentry" href="vfs_audit.8.html"><span class="citerefentry"><span class="refentrytitle">vfs_audit</span>(8)</span></a>.
    10         </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id290822"></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="id290832"></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="id2483373"></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="id2483384"></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.0/docs/htmldocs/manpages/vfs_fake_perms.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_fake_perms</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258170"></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="id2522928"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_fake_perms</code> VFS module was created
    33        to allow Roaming Profile files and directories to be set (on
    … …  
    77        the client even though the files will never be overwritten as
    88        the client logs out or shuts down.
    9         </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id290784"></a><h2>EXAMPLES</h2><pre class="programlisting">
     9        </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2522965"></a><h2>EXAMPLES</h2><pre class="programlisting">
    1010        <em class="parameter"><code>[Profiles]</code></em>
    11         <a class="link" href="smb.conf.5.html#PATH">path = /profiles</a>
    12         <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = fake_perms</a>
    13 </pre></div><div class="refsect1" lang="en"><a name="id259048"></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="id259058"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     11        <a class="link" href="smb.conf.5.html#PATH" target="_top">path = /profiles</a>
     12        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = fake_perms</a>
     13</pre></div><div class="refsect1" lang="en"><a name="id2483375"></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="id2483385"></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.0/docs/htmldocs/manpages/vfs_full_audit.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_full_audit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258169"></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="id2522929"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_full_audit</code> VFS module records selected
    33        client operations to the system log using
    … …  
    1111        format is: </p><pre class="programlisting">
    1212                smbd_audit: PREFIX|OPERATION|RESULT|FILE
    13         </pre><p>The record fields are:</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">PREFIX</code> - the result of the full_audit:prefix string after variable substitutions</p></li><li><p><code class="literal">OPERATION</code> - the name of the VFS operation</p></li><li><p><code class="literal">RESULT</code> - whether the operation succeeded or failed</p></li><li><p><code class="literal">FILE</code> - the name of the file or directory the operation was performed on</p></li></ul></div><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id299797"></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="id2481544"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">vfs_full_audit:prefix = STRING</span></dt><dd><p>Prepend audit messages with STRING. STRING is
    1414                processed for standard substitution variables listed in
    1515                <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>. The default
    … …  
    2525                </p></dd><dt><span class="term">full_audit:priority = PRIORITY</span></dt><dd><p>Log messages with the named
    2626                <a class="citerefentry" href="syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a> priority.
    27                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id299897"></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="id2481650"></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">
    3030        <em class="parameter"><code>[records]</code></em>
    31         <a class="link" href="smb.conf.5.html#PATH">path = /data/records</a>
    32         <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = full_audit</a>
    33         <a class="link" href="smb.conf.5.html#FULL_AUDIT:PREFIX">full_audit:prefix = %u|%I</a>
    34         <a class="link" href="smb.conf.5.html#FULL_AUDIT:SUCCESS">full_audit:success = open opendir</a>
    35         <a class="link" href="smb.conf.5.html#FULL_AUDIT:FAILURE">full_audit:failure = all</a>
    36         <a class="link" href="smb.conf.5.html#FULL_AUDIT:FACILITY">full_audit:facility = LOCAL7</a>
    37         <a class="link" href="smb.conf.5.html#FULL_AUDIT:PRIORITY">full_audit:priority = ALERT</a>
    38 </pre></div><div class="refsect1" lang="en"><a name="id300071"></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="id300081"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     31        <a class="link" href="smb.conf.5.html#PATH" target="_top">path = /data/records</a>
     32        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = full_audit</a>
     33        <a class="link" href="smb.conf.5.html#FULL_AUDIT:PREFIX" target="_top">full_audit:prefix = %u|%I</a>
     34        <a class="link" href="smb.conf.5.html#FULL_AUDIT:SUCCESS" target="_top">full_audit:success = open opendir</a>
     35        <a class="link" href="smb.conf.5.html#FULL_AUDIT:FAILURE" target="_top">full_audit:failure = all</a>
     36        <a class="link" href="smb.conf.5.html#FULL_AUDIT:FACILITY" target="_top">full_audit:facility = LOCAL7</a>
     37        <a class="link" href="smb.conf.5.html#FULL_AUDIT:PRIORITY" target="_top">full_audit:priority = ALERT</a>
     38</pre></div><div class="refsect1" lang="en"><a name="id2481853"></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="id2481863"></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.0/docs/htmldocs/manpages/vfs_netatalk.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_netatalk</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258169"></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="id2522928"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_netatalk</code> VFS module dynamically
    33        hides .AppleDouble files, preventing spurious errors on some
    44        CIFS clients. .AppleDouble files may be created by historic
    5         implementations of AFP (Apple Filing Protocol) on servers. </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id290782"></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="id2522962"></a><h2>EXAMPLES</h2><p>Hide .AppleDouble files on the [data] share:</p><pre class="programlisting">
    66        <em class="parameter"><code>[data]</code></em>
    7         <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = netatalk</a>
    8 </pre></div><div class="refsect1" lang="en"><a name="id259037"></a><h2>CAVEATS</h2><p>This module is largely historic and unlikely to be of use
     7        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = netatalk</a>
     8</pre></div><div class="refsect1" lang="en"><a name="id2483366"></a><h2>CAVEATS</h2><p>This module is largely historic and unlikely to be of use
    99        in modern networks since current Apple systems are able to mount CIFS
    1010        shares natively.
    11         </p></div><div class="refsect1" lang="en"><a name="id259048"></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="id259058"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     11        </p></div><div class="refsect1" lang="en"><a name="id2483378"></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="id2483389"></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.0/docs/htmldocs/manpages/vfs_prealloc.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_prealloc</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258169"></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="id2522929"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_prealloc</code> VFS module preallocates
    33        files to a specified size each time a new file is created. This
    44        is useful in environments where files are of a predetermined
    55        size will be written to a disk subsystem where extending file
    6         allocations is expensive.  </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id290781"></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="id2522964"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">prealloc:EXT = BYTES</span></dt><dd><p>Preallocate all files with the extension EXT to
    77                the size specified by BYTES.
    8                 </p><p>The following suffixes may be applied to BYTES:</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">K</code> - BYTES is a number of kilobytes</p></li><li><p><code class="literal">M</code> - BYTES is a number of megabytes</p></li><li><p><code class="literal">G</code> - BYTES is a number of gigabytes</p></li></ul></div></dd></dl></div></div><div class="refsect1" lang="en"><a name="id290838"></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="id2483394"></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">
    1111        <em class="parameter"><code>[frames]</code></em>
    12         <a class="link" href="smb.conf.5.html#PATH">path = /data/frames</a>
    13         <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = prealloc</a>
    14         <a class="link" href="smb.conf.5.html#PREALLOC:TIFF">prealloc:tiff = 4M</a>
    15 </pre></div><div class="refsect1" lang="en"><a name="id259065"></a><h2>CAVEATS</h2><p><code class="literal">vfs_prealloc</code> is not supported on all
     12        <a class="link" href="smb.conf.5.html#PATH" target="_top">path = /data/frames</a>
     13        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = prealloc</a>
     14        <a class="link" href="smb.conf.5.html#PREALLOC:TIFF" target="_top">prealloc:tiff = 4M</a>
     15</pre></div><div class="refsect1" lang="en"><a name="id2483666"></a><h2>CAVEATS</h2><p><code class="literal">vfs_prealloc</code> is not supported on all
    1616        platforms and filesystems. Currently only XFS filesystems on
    1717        Linux and IRIX are supported.
    18         </p></div><div class="refsect1" lang="en"><a name="id258247"></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="id258257"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     18        </p></div><div class="refsect1" lang="en"><a name="id2483682"></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="id2483694"></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.0/docs/htmldocs/manpages/vfs_readonly.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_readonly</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258169"></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="id2522929"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_readonly</code> VFS module marks a share
    33        as read only for all clients connecting within the configured
    44        time period. Clients connecting during this time will be denied
    55        write access to all files in the share, irrespective of ther
    6         actual access privileges.</p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id290782"></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="id2522964"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">readonly:period = BEGIN, END</span></dt><dd><p>Only mark the share as read only if the client
    77                connection was made between the times marked by the
    88                BEGIN and END date specifiers.
    … …  
    1010                same as that accepted by the -d option of GNU
    1111                <a class="citerefentry" href="date.1.html"><span class="citerefentry"><span class="refentrytitle">date</span>(1)</span></a>.
    12                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id290815"></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="id2483372"></a><h2>EXAMPLES</h2><p>Mark all shares read only:</p><pre class="programlisting">
    1313        <em class="parameter"><code>[global]</code></em>
    14         <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = readonly</a>
     14        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = readonly</a>
    1515</pre><p>Mark the [backup] share as read only during business hours:</p><pre class="programlisting">
    1616        <em class="parameter"><code>[backup]</code></em>
    17         <a class="link" href="smb.conf.5.html#PATH">path = /readonly</a>
    18         <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = readonly</a>
    19         <a class="link" href="smb.conf.5.html#READONLY:PERIOD">readonly:period = readonly:period = "today 9:00","today 17:00"</a>
    20 </pre></div><div class="refsect1" lang="en"><a name="id259064"></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="id258241"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     17        <a class="link" href="smb.conf.5.html#PATH" target="_top">path = /readonly</a>
     18        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = readonly</a>
     19        <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" lang="en"><a name="id2483667"></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="id2483678"></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.0/docs/htmldocs/manpages/vfs_recycle.8.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_recycle</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258169"></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="id2522928"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_recycle</code> intercepts file deletion
    33        requests and moves the affected files to a temporary repository
    … …  
    1111        can recover files from the recycle bin. If the recycle:keeptree
    1212        option has been specified, deleted files will be found in a path
    13         identical with that from which the file was deleted.  </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id290790"></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="id2483347"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">recycle:repository = PATH</span></dt><dd><p>Path of the directory where deleted files should be moved.
    1414                </p><p>If this option is not set, the default path .recycle
    1515                is used. </p></dd><dt><span class="term">recycle:directory_mode = MODE</span></dt><dd><p>Set MODE to the octal mode the recycle repository
    … …  
    4848                and ? are supported) for which no versioning should
    4949                be used. Only useful when recycle:versions is enabled.
    50                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id259053"></a><h2>EXAMPLES</h2><p>Log operations on all shares using the LOCAL1 facility
    51         and NOTICE priority:</p><pre class="programlisting">
    52         <em class="parameter"><code>[global]</code></em>
    53         <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = recycle</a>
    54         <a class="link" href="smb.conf.5.html#RECYCLE:FACILITY">recycle:facility = LOCAL1</a>
    55         <a class="link" href="smb.conf.5.html#RECYCLE:PRIORITY">recycle:priority = NOTICE</a>
    56 </pre></div><div class="refsect1" lang="en"><a name="id258375"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
    57         </p></div><div class="refsect1" lang="en"><a name="id299753"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     50                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483670"></a><h2>EXAMPLES</h2><p>Move files "deleted" on <em class="parameter"><code>share</code></em> to
     51        <em class="parameter"><code>/data/share/.recycle</code></em> instead of deleting them:
     52        </p><pre class="programlisting">
     53        <em class="parameter"><code>[share]</code></em>
     54        <a class="link" href="smb.conf.5.html#PATH" target="_top">path = /data/share</a>
     55        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = recycle</a>
     56        <a class="link" href="smb.conf.5.html#RECYCLE:REPOSITORY" target="_top">recycle:repository = .recycle</a>
     57        <a class="link" href="smb.conf.5.html#RECYCLE:KEEPTREE" target="_top">recycle:keeptree = yes</a>
     58        <a class="link" href="smb.conf.5.html#RECYCLE:VERSIONS" target="_top">recycle:versions = yes</a>
     59</pre></div><div class="refsect1" lang="en"><a name="id2481527"></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="id2481538"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    5861        were created by Andrew Tridgell. Samba is now developed
    5962        by the Samba Team as an Open Source project similar

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

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_shadow_copy</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id258170"></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="id2522930"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
    22        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_shadow_copy</code> VFS module functionality
    33        that is similar to Microsoft Shadow Copy services. When setup properly,
    44        this module allows Microsoft Shadow Copy clients to browse
    55        "shadow copies" on Samba shares.
    6         </p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id290782"></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="id2522964"></a><h2>CONFIGURATION</h2><p><code class="literal">vfs_shadow_copy</code> relies on a filesystem
    77        snapshot implementation. Many common filesystems have native
    88        support for this.
    … …  
    1717        </p><pre class="programlisting">
    1818        TZ=GMT date +@GMT-%Y.%m.%d-%H.%M.%S
    19         </pre></div><div class="refsect1" lang="en"><a name="id258962"></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="id2483562"></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>
    21         <a class="link" href="smb.conf.5.html#VFSOBJECTS">vfs objects = shadow_copy</a>
    22 </pre></div><div class="refsect1" lang="en"><a name="id258346"></a><h2>CAVEATS</h2><p>This is not a backup, archival, or version control solution.
     21        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = shadow_copy</a>
     22</pre></div><div class="refsect1" lang="en"><a name="id2483697"></a><h2>CAVEATS</h2><p>This is not a backup, archival, or version control solution.
    2323        </p><p>With Samba or Windows servers,
    2424        <code class="literal">vfs_shadow_copy</code> is designed to be an end-user
    … …  
    2626        archival solutions and should in no way be considered as
    2727        such. Additionally, if you need version control, implement a
    28         version control system.</p></div><div class="refsect1" lang="en"><a name="id258367"></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="id258377"></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="id2483721"></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="id2483732"></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.0/docs/htmldocs/manpages/vfstest.1.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfstest</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></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="id290779"></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="id2522958"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">vfstest</code> is a small command line
    22        utility that has the ability to test dso samba VFS modules. It gives the
    33        user the ability to call the various VFS functions manually and
    44        supports cascaded VFS modules.
    5         </p></div><div class="refsect1" lang="en"><a name="id290807"></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="id2483360"></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.
    … …  
    2121use only by developers and generate HUGE amounts of log
    2222data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
    23 override the <a class="link" href="smb.conf.5.html#LOGLEVEL">log level</a> parameter
     23override the <a class="link" href="smb.conf.5.html#LOGLEVEL" target="_top">log level</a> parameter
    2424in the <code class="filename">smb.conf</code> file.</p></dd><dt><span class="term">-V</span></dt><dd><p>Prints the program version number.
    2525</p></dd><dt><span class="term">-s &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the
    … …  
    3333<code class="constant">".progname"</code> will be appended (e.g. log.smbclient,
    3434log.smbd, etc...). The log file is never removed by the client.
    35 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id258289"></a><h2>COMMANDS</h2><p><span class="emphasis"><em>VFS COMMANDS</em></span></p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">load &lt;module.so&gt;</code> - Load specified VFS module </p></li><li><p><code class="literal">populate &lt;char&gt; &lt;size&gt;</code> - Populate a data buffer with the specified data
     35</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483734"></a><h2>COMMANDS</h2><p><span class="emphasis"><em>VFS COMMANDS</em></span></p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">load &lt;module.so&gt;</code> - Load specified VFS module </p></li><li><p><code class="literal">populate &lt;char&gt; &lt;size&gt;</code> - Populate a data buffer with the specified data
    3636                </p></li><li><p><code class="literal">showdata [&lt;offset&gt; &lt;len&gt;]</code> - Show data currently in data buffer
    37                 </p></li><li><p><code class="literal">connect</code> - VFS connect()</p></li><li><p><code class="literal">disconnect</code> - VFS disconnect()</p></li><li><p><code class="literal">disk_free</code> - VFS disk_free()</p></li><li><p><code class="literal">opendir</code> - VFS opendir()</p></li><li><p><code class="literal">readdir</code> - VFS readdir()</p></li><li><p><code class="literal">mkdir</code> - VFS mkdir()</p></li><li><p><code class="literal">rmdir</code> - VFS rmdir()</p></li><li><p><code class="literal">closedir</code> - VFS closedir()</p></li><li><p><code class="literal">open</code> - VFS open()</p></li><li><p><code class="literal">close</code> - VFS close()</p></li><li><p><code class="literal">read</code> - VFS read()</p></li><li><p><code class="literal">write</code> - VFS write()</p></li><li><p><code class="literal">lseek</code> - VFS lseek()</p></li><li><p><code class="literal">rename</code> - VFS rename()</p></li><li><p><code class="literal">fsync</code> - VFS fsync()</p></li><li><p><code class="literal">stat</code> - VFS stat()</p></li><li><p><code class="literal">fstat</code> - VFS fstat()</p></li><li><p><code class="literal">lstat</code> - VFS lstat()</p></li><li><p><code class="literal">unlink</code> - VFS unlink()</p></li><li><p><code class="literal">chmod</code> - VFS chmod()</p></li><li><p><code class="literal">fchmod</code> - VFS fchmod()</p></li><li><p><code class="literal">chown</code> - VFS chown()</p></li><li><p><code class="literal">fchown</code> - VFS fchown()</p></li><li><p><code class="literal">chdir</code> - VFS chdir()</p></li><li><p><code class="literal">getwd</code> - VFS getwd()</p></li><li><p><code class="literal">utime</code> - VFS utime()</p></li><li><p><code class="literal">ftruncate</code> - VFS ftruncate()</p></li><li><p><code class="literal">lock</code> - VFS lock()</p></li><li><p><code class="literal">symlink</code> - VFS symlink()</p></li><li><p><code class="literal">readlink</code> - VFS readlink()</p></li><li><p><code class="literal">link</code> - VFS link()</p></li><li><p><code class="literal">mknod</code> - VFS mknod()</p></li><li><p><code class="literal">realpath</code> - VFS realpath()</p></li></ul></div><p><span class="emphasis"><em>GENERAL COMMANDS</em></span></p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">conf &lt;smb.conf&gt;</code> - Load a different configuration file</p></li><li><p><code class="literal">help [&lt;command&gt;]</code> - Get list of commands or info about specified command</p></li><li><p><code class="literal">debuglevel &lt;level&gt;</code> - Set debug level</p></li><li><p><code class="literal">freemem</code> - Free memory currently in use</p></li><li><p><code class="literal">exit</code> - Exit vfstest</p></li></ul></div></div><div class="refsect1" lang="en"><a name="id300032"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba
    38         suite.</p></div><div class="refsect1" lang="en"><a name="id300041"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     37                </p></li><li><p><code class="literal">connect</code> - VFS connect()</p></li><li><p><code class="literal">disconnect</code> - VFS disconnect()</p></li><li><p><code class="literal">disk_free</code> - VFS disk_free()</p></li><li><p><code class="literal">opendir</code> - VFS opendir()</p></li><li><p><code class="literal">readdir</code> - VFS readdir()</p></li><li><p><code class="literal">mkdir</code> - VFS mkdir()</p></li><li><p><code class="literal">rmdir</code> - VFS rmdir()</p></li><li><p><code class="literal">closedir</code> - VFS closedir()</p></li><li><p><code class="literal">open</code> - VFS open()</p></li><li><p><code class="literal">close</code> - VFS close()</p></li><li><p><code class="literal">read</code> - VFS read()</p></li><li><p><code class="literal">write</code> - VFS write()</p></li><li><p><code class="literal">lseek</code> - VFS lseek()</p></li><li><p><code class="literal">rename</code> - VFS rename()</p></li><li><p><code class="literal">fsync</code> - VFS fsync()</p></li><li><p><code class="literal">stat</code> - VFS stat()</p></li><li><p><code class="literal">fstat</code> - VFS fstat()</p></li><li><p><code class="literal">lstat</code> - VFS lstat()</p></li><li><p><code class="literal">unlink</code> - VFS unlink()</p></li><li><p><code class="literal">chmod</code> - VFS chmod()</p></li><li><p><code class="literal">fchmod</code> - VFS fchmod()</p></li><li><p><code class="literal">chown</code> - VFS chown()</p></li><li><p><code class="literal">fchown</code> - VFS fchown()</p></li><li><p><code class="literal">chdir</code> - VFS chdir()</p></li><li><p><code class="literal">getwd</code> - VFS getwd()</p></li><li><p><code class="literal">utime</code> - VFS utime()</p></li><li><p><code class="literal">ftruncate</code> - VFS ftruncate()</p></li><li><p><code class="literal">lock</code> - VFS lock()</p></li><li><p><code class="literal">symlink</code> - VFS symlink()</p></li><li><p><code class="literal">readlink</code> - VFS readlink()</p></li><li><p><code class="literal">link</code> - VFS link()</p></li><li><p><code class="literal">mknod</code> - VFS mknod()</p></li><li><p><code class="literal">realpath</code> - VFS realpath()</p></li></ul></div><p><span class="emphasis"><em>GENERAL COMMANDS</em></span></p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">conf &lt;smb.conf&gt;</code> - Load a different configuration file</p></li><li><p><code class="literal">help [&lt;command&gt;]</code> - Get list of commands or info about specified command</p></li><li><p><code class="literal">debuglevel &lt;level&gt;</code> - Set debug level</p></li><li><p><code class="literal">freemem</code> - Free memory currently in use</p></li><li><p><code class="literal">exit</code> - Exit vfstest</p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2481816"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba
     38        suite.</p></div><div class="refsect1" lang="en"><a name="id2481827"></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.0/docs/htmldocs/manpages/wbinfo.1.html

    r158 r286  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>wbinfo</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="wbinfo.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>wbinfo &#8212; Query information from winbind daemon</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">wbinfo</code> [-a user%password] [--all-domains] [--allocate-gid] [--allocate-uid] [-D domain] [--domain domain] [-g] [--getdcname domain] [--get-auth-user] [-G gid] [-h] [-i user] [-I ip] [-K user%password] [-m] [-n name] [-N netbios-name] [--own-domain] [-p] [-r user] [-s sid] [--separator] [--sequence] [--set-auth-user user%password] [-S sid] [-t] [-u] [--uid-info uid] [--user-domgroups sid] [--user-sids sid] [-U uid] [-V] [-Y sid] [--verbose]</p></div></div><div class="refsect1" lang="en"><a name="id258247"></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] [-s sid] [--separator] [--sequence] [--set-auth-user user%password] [-S sid] [-t] [-u] [--uid-info uid] [--user-domgroups sid] [--user-sids sid] [-U uid] [-V] [-Y sid] [--verbose]</p></div></div><div class="refsect1" lang="en"><a name="id2483679"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">wbinfo</code> program queries and returns information
    22        created and used by the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon. </p><p>The <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon must be configured
    33        and running for the <code class="literal">wbinfo</code> program to be able
    4         to return information.</p></div><div class="refsect1" lang="en"><a name="id258299"></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="id2483735"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-a|--authenticate username%password</span></dt><dd><p>Attempt to authenticate a user via winbindd.
    55                This checks both authenticaion methods and reports its results.
    66                </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Do not be tempted to use this
    … …  
    8383                the operation will fail. </p></dd><dt><span class="term">-V</span></dt><dd><p>Prints the program version number.
    8484</p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    85 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id300219"></a><h2>EXIT STATUS</h2><p>The wbinfo program returns 0 if the operation
     85</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2482018"></a><h2>EXIT STATUS</h2><p>The wbinfo program returns 0 if the operation
    8686        succeeded, or 1 if the operation failed.  If the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon is not working <code class="literal">wbinfo</code> will always return
    87         failure. </p></div><div class="refsect1" lang="en"><a name="id300243"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
    88         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id300254"></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="id300276"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     87        failure. </p></div><div class="refsect1" lang="en"><a name="id2482044"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
     88        the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2532519"></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="id2532541"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    8989        were created by Andrew Tridgell. Samba is now developed
    9090        by the Samba Team as an Open Source project similar

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

    r158 r286  
    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.73.2"></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="id290810"></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="id2483363"></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
    … …  
    77        and the <code class="literal">pam_winbind.so</code> PAM module, by managing connections to
    88        domain controllers.  In this configuration the
    9         <a class="link" href="smb.conf.5.html#IDMAPUID">idmap uid</a> and <a class="link" href="smb.conf.5.html#IDMAPGID">idmap gid</a>
     9        <a class="link" href="smb.conf.5.html#IDMAPUID" target="_top">idmap uid</a> and <a class="link" href="smb.conf.5.html#IDMAPGID" target="_top">idmap gid</a>
    1010        parameters are not required. (This is known as `netlogon proxy only mode'.)</p><p>The Name Service Switch allows user
    1111        and system information to be obtained from different databases
    … …  
    5959        WINS server.</p><pre class="programlisting">
    6060hosts:          files wins
    61 </pre></div><div class="refsect1" lang="en"><a name="id299800"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-F</span></dt><dd><p>If specified, this parameter causes
     61</pre></div><div class="refsect1" lang="en"><a name="id2481563"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-F</span></dt><dd><p>If specified, this parameter causes
    6262                the main <code class="literal">winbindd</code> process to not daemonize,
    6363                i.e. double-fork and disassociate with the terminal.
    … …  
    8383use only by developers and generate HUGE amounts of log
    8484data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
    85 override the <a class="link" href="smb.conf.5.html#LOGLEVEL">log level</a> parameter
     85override the <a class="link" href="smb.conf.5.html#LOGLEVEL" target="_top">log level</a> parameter
    8686in the <code class="filename">smb.conf</code> file.</p></dd><dt><span class="term">-V</span></dt><dd><p>Prints the program version number.
    8787</p></dd><dt><span class="term">-s &lt;configuration file&gt;</span></dt><dd><p>The file specified contains the
    … …  
    112112                default behavior is to launch a child process that is responsible for
    113113                updating expired cache entries.
    114                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id300022"></a><h2>NAME AND ID RESOLUTION</h2><p>Users and groups on a Windows NT server are assigned
     114                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481823"></a><h2>NAME AND ID RESOLUTION</h2><p>Users and groups on a Windows NT server are assigned
    115115        a security id (SID) which is globally unique when the
    116116        user or group is created.  To convert the Windows NT user or group
    … …  
    126126        store is deleted or corrupted, there is no way for winbindd to
    127127        determine which user and group ids correspond to Windows NT user
    128         and group rids. </p><p>See the <a class="link" href="smb.conf.5.html#IDMAPDOMAINS">idmap domains</a> or the old <a class="link" href="smb.conf.5.html#IDMAPBACKEND">idmap backend</a> parameters in
     128        and group rids. </p><p>See the <a class="link" href="smb.conf.5.html#IDMAPDOMAINS" target="_top">idmap domains</a> or the old <a class="link" href="smb.conf.5.html#IDMAPBACKEND" target="_top">idmap backend</a> parameters in
    129129        <code class="filename">smb.conf</code> for options for sharing this
    130         database, such as via LDAP.</p></div><div class="refsect1" lang="en"><a name="id300075"></a><h2>CONFIGURATION</h2><p>Configuration of the <code class="literal">winbindd</code> daemon
     130        database, such as via LDAP.</p></div><div class="refsect1" lang="en"><a name="id2481893"></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
    132132        [global] section of smb.conf. </p><div class="itemizedlist"><ul type="disc"><li><p>
    133                 <a class="link" href="smb.conf.5.html#WINBINDSEPARATOR">winbind separator</a></p></li><li><p>
    134                 <a class="link" href="smb.conf.5.html#IDMAPUID">idmap uid</a></p></li><li><p>
    135                 <a class="link" href="smb.conf.5.html#IDMAPGID">idmap gid</a></p></li><li><p>
    136                 <a class="link" href="smb.conf.5.html#IDMAPBACKEND">idmap backend</a></p></li><li><p>
    137                 <a class="link" href="smb.conf.5.html#WINBINDCACHETIME">winbind cache time</a></p></li><li><p>
    138                 <a class="link" href="smb.conf.5.html#WINBINDENUMUSERS">winbind enum users</a></p></li><li><p>
    139                 <a class="link" href="smb.conf.5.html#WINBINDENUMGROUPS">winbind enum groups</a></p></li><li><p>
    140                 <a class="link" href="smb.conf.5.html#TEMPLATEHOMEDIR">template homedir</a></p></li><li><p>
    141                 <a class="link" href="smb.conf.5.html#TEMPLATESHELL">template shell</a></p></li><li><p>
    142                 <a class="link" href="smb.conf.5.html#WINBINDUSEDEFAULTDOMAIN">winbind use default domain</a></p></li><li><p>
    143                 <a class="link" href="smb.conf.5.html#WINBIND:RPCONLY">winbind: rpc only</a>
     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>
     143                <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" lang="en"><a name="id300220"></a><h2>EXAMPLE SETUP</h2><p>
     147                </p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2532543"></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
    … …  
    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" lang="en"><a name="id300393"></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="id2532734"></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
    … …  
    203203        then in general the user and groups ids allocated by winbindd will not
    204204        be the same.  The user and group ids will only be valid for the local
    205         machine, unless a shared <a class="link" href="smb.conf.5.html#IDMAPBACKEND">idmap backend</a> is configured.</p><p>If the the Windows NT SID to UNIX user and group id mapping
    206         file is damaged or destroyed then the mappings will be lost. </p></div><div class="refsect1" lang="en"><a name="id300450"></a><h2>SIGNALS</h2><p>The following signals can be used to manipulate the
     205        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" lang="en"><a name="id2532799"></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" lang="en"><a name="id300508"></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="id2532862"></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" lang="en"><a name="id300641"></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="id300651"></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="id300706"></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="id2533008"></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="id2533019"></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="id2533074"></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.