Ignore:
Timestamp:
Jun 16, 2009, 5:52:30 PM (16 years ago)
Author:
Herwig Bauernfeind
Message:

Update 3.2 to 3.2.12

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

Legend:

Unmodified
Added
Removed
  • branches/samba-3.2.x/docs/htmldocs/manpages/index.html

    r231 r272  
    2626        names
    2727</p></dd><dt><span class="term"><a class="ulink" href="ntlm_auth.1.html" target="_top">ntlm_auth(1)</a></span></dt><dd><p>tool to allow external access to Winbind's NTLM authentication function
    28 </p></dd><dt><span class="term"><a class="ulink" href="pam_winbind.7.html" target="_top">pam_winbind(7)</a></span></dt><dd><p>PAM module for Winbind
     28</p></dd><dt><span class="term"><a class="ulink" href="pam_winbind.8.html" target="_top">pam_winbind(8)</a></span></dt><dd><p>PAM module for Winbind
    2929</p></dd><dt><span class="term"><a class="ulink" href="pdbedit.8.html" target="_top">pdbedit(8)</a></span></dt><dd><p>manage the SAM database (Database of Samba Users)
    3030</p></dd><dt><span class="term"><a class="ulink" href="profiles.1.html" target="_top">profiles(1)</a></span></dt><dd><p>A utility to report and change SIDs in registry files
  • branches/samba-3.2.x/docs/htmldocs/manpages/net.8.html

    r231 r272  
    11<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>net</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.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="id2483409"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The Samba net utility is meant to work just like the net utility
     3        </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">net</code> {&lt;ads|rap|rpc&gt;} [-h] [-w workgroup] [-W myworkgroup] [-U user] [-I ip-address] [-p port] [-n myname] [-s conffile] [-S server] [-l] [-P] [-d debuglevel] [-V] [--request-timeout seconds]</p></div></div><div class="refsect1" lang="en"><a name="id2483532"></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="id2483552"></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="id2483561"></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
     
    4242                </p></dd><dt><span class="term">-P</span></dt><dd><p>
    4343                Make queries to the external server using the machine account of the local server.
     44                </p></dd><dt><span class="term">--request-timeout 30</span></dt><dd><p>
     45                Let client requests timeout after 30 seconds the default is 10
     46                seconds.
    4447                </p></dd><dt><span class="term">-d|--debuglevel=level</span></dt><dd><p><em class="replaceable"><code>level</code></em> is an integer
    4548from 0 to 10. The default value if this parameter is
     
    5558data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
    5659override the <a class="link" href="smb.conf.5.html#LOGLEVEL" target="_top">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="id2481565"></a><h2>COMMANDS</h2><div class="refsect2" lang="en"><a name="id2481571"></a><h3>CHANGESECRETPW</h3><p>This command allows the Samba machine account password to be set from an external application
     60in the <code class="filename">smb.conf</code> file.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481584"></a><h2>COMMANDS</h2><div class="refsect2" lang="en"><a name="id2481590"></a><h3>CHANGESECRETPW</h3><p>This command allows the Samba machine account password to be set from an external application
    5861to a machine account password that has already been stored in Active Directory. DO NOT USE this command
    5962unless you know exactly what you are doing. The use of this command requires that the force flag (-f)
     
    6265this without care and attention as it will overwrite a legitimate machine password without warning.
    6366YOU HAVE BEEN WARNED.
    64 </p></div><div class="refsect2" lang="en"><a name="id2481592"></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="id2481609"></a><h4>TIME</h4><p>Without any options, the <code class="literal">NET TIME</code> command
     67</p></div><div class="refsect2" lang="en"><a name="id2481611"></a><h3>TIME</h3><p>The <code class="literal">NET TIME</code> command allows you to view the time on a remote server
     68        or synchronise the time on the local server with the time on the remote server.</p><div class="refsect3" lang="en"><a name="id2481628"></a><h4>TIME</h4><p>Without any options, the <code class="literal">NET TIME</code> command
    6669displays the time on the remote server.
    67 </p></div><div class="refsect3" lang="en"><a name="id2481625"></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="id2481642"></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="id2481660"></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="id2481672"></a><h3>[RPC|ADS] JOIN [TYPE] [-U username[%password]] [createupn=UPN] [createcomputer=OU] [options]</h3><p>
     70</p></div><div class="refsect3" lang="en"><a name="id2481644"></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="id2481661"></a><h4>TIME SET</h4><p>Tries to set the date and time of the local server to that on
     71the remote server using <code class="literal">/bin/date</code>. </p></div><div class="refsect3" lang="en"><a name="id2481679"></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="id2481691"></a><h3>[RPC|ADS] JOIN [TYPE] [-U username[%password]] [createupn=UPN] [createcomputer=OU] [options]</h3><p>
    6972Join a domain.  If the account already exists on the server, and
    7073[TYPE] is MEMBER, the machine will attempt to join automatically.
     
    8386and ldap, so it may need to be doubled or quadrupled to pass through,
    8487and it is not used as a delimiter.
    85 </p></div><div class="refsect2" lang="en"><a name="id2481706"></a><h3>[RPC] OLDJOIN [options]</h3><p>Join a domain. Use the OLDJOIN option to join the domain
     88</p></div><div class="refsect2" lang="en"><a name="id2481725"></a><h3>[RPC] OLDJOIN [options]</h3><p>Join a domain. Use the OLDJOIN option to join the domain
    8689using 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="id2481719"></a><h3>[RPC|ADS] USER</h3><div class="refsect3" lang="en"><a name="id2481724"></a><h4>[RPC|ADS] USER</h4><p>List all users</p></div><div class="refsect3" lang="en"><a name="id2481735"></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="id2481747"></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="id2481760"></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="id2481775"></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="id2481790"></a><h3>[RPC|ADS] GROUP</h3><div class="refsect3" lang="en"><a name="id2481796"></a><h4>[RPC|ADS] GROUP [misc options] [targets]</h4><p>List user groups.</p></div><div class="refsect3" lang="en"><a name="id2481807"></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="id2481820"></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="id2481835"></a><h3>[RAP|RPC] SHARE</h3><div class="refsect3" lang="en"><a name="id2481840"></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="id2481852"></a><h4>[RAP|RPC] SHARE ADD <em class="replaceable"><code>name=serverpath</code></em> [-C comment] [-M maxusers] [targets]</h4><p>Adds a share from a server (makes the export active). Maxusers
     90account in server manager first.</p></div><div class="refsect2" lang="en"><a name="id2481738"></a><h3>[RPC|ADS] USER</h3><div class="refsect3" lang="en"><a name="id2481744"></a><h4>[RPC|ADS] USER</h4><p>List all users</p></div><div class="refsect3" lang="en"><a name="id2481754"></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="id2481766"></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="id2481779"></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="id2481794"></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="id2481809"></a><h3>[RPC|ADS] GROUP</h3><div class="refsect3" lang="en"><a name="id2481815"></a><h4>[RPC|ADS] GROUP [misc options] [targets]</h4><p>List user groups.</p></div><div class="refsect3" lang="en"><a name="id2481826"></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="id2481839"></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="id2481854"></a><h3>[RAP|RPC] SHARE</h3><div class="refsect3" lang="en"><a name="id2481860"></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="id2481871"></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
    8891specifies the number of users that can be connected to the
    89 share simultaneously.</p></div><div class="refsect3" lang="en"><a name="id2481869"></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="id2481882"></a><h3>[RPC|RAP] FILE</h3><div class="refsect3" lang="en"><a name="id2481888"></a><h4>[RPC|RAP] FILE</h4><p>List all open files on remote server.</p></div><div class="refsect3" lang="en"><a name="id2481899"></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="id2481915"></a><h4>[RPC|RAP] FILE INFO <em class="replaceable"><code>fileid</code></em></h4><p>
     92share simultaneously.</p></div><div class="refsect3" lang="en"><a name="id2481888"></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="id2481901"></a><h3>[RPC|RAP] FILE</h3><div class="refsect3" lang="en"><a name="id2481907"></a><h4>[RPC|RAP] FILE</h4><p>List all open files on remote server.</p></div><div class="refsect3" lang="en"><a name="id2481918"></a><h4>[RPC|RAP] FILE CLOSE <em class="replaceable"><code>fileid</code></em></h4><p>Close file with specified <em class="replaceable"><code>fileid</code></em> on
     93remote server.</p></div><div class="refsect3" lang="en"><a name="id2481934"></a><h4>[RPC|RAP] FILE INFO <em class="replaceable"><code>fileid</code></em></h4><p>
    9194Print information on specified <em class="replaceable"><code>fileid</code></em>.
    9295Currently listed are: file-id, username, locks, path, permissions.
    93 </p></div><div class="refsect3" lang="en"><a name="id2481931"></a><h4>[RAP|RPC] FILE USER <em class="replaceable"><code>user</code></em></h4><p>
     96</p></div><div class="refsect3" lang="en"><a name="id2481950"></a><h4>[RAP|RPC] FILE USER <em class="replaceable"><code>user</code></em></h4><p>
    9497List files opened by specified <em class="replaceable"><code>user</code></em>.
    9598Please note that <code class="literal">net rap file user</code> does not work
    9699against Samba servers.
    97 </p></div></div><div class="refsect2" lang="en"><a name="id2481955"></a><h3>SESSION</h3><div class="refsect3" lang="en"><a name="id2481961"></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="id2481972"></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="id2481984"></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="id2481999"></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="id2482012"></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="id2482024"></a><h3>RAP PRINTQ</h3><div class="refsect3" lang="en"><a name="id2482029"></a><h4>RAP PRINTQ INFO <em class="replaceable"><code>QUEUE_NAME</code></em></h4><p>Lists the specified print queue and print jobs on the server.
     100</p></div></div><div class="refsect2" lang="en"><a name="id2481974"></a><h3>SESSION</h3><div class="refsect3" lang="en"><a name="id2481980"></a><h4>RAP SESSION</h4><p>Without any other options, SESSION enumerates all active SMB/CIFS
     101sessions on the target server.</p></div><div class="refsect3" lang="en"><a name="id2481991"></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="id2482003"></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="id2482018"></a><h3>RAP SERVER <em class="replaceable"><code>DOMAIN</code></em></h3><p>List all servers in specified domain or workgroup. Defaults
     102to local domain.</p></div><div class="refsect2" lang="en"><a name="id2482032"></a><h3>RAP DOMAIN</h3><p>Lists all domains and workgroups visible on the
     103current network.</p></div><div class="refsect2" lang="en"><a name="id2482043"></a><h3>RAP PRINTQ</h3><div class="refsect3" lang="en"><a name="id2482048"></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.
    101104If 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="id2482047"></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="id2532524"></a><h3>RAP VALIDATE <em class="replaceable"><code>user</code></em> [<em class="replaceable"><code>password</code></em>]</h3><p>
     105queues are listed.</p></div><div class="refsect3" lang="en"><a name="id2532529"></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="id2532542"></a><h3>RAP VALIDATE <em class="replaceable"><code>user</code></em> [<em class="replaceable"><code>password</code></em>]</h3><p>
    103106Validate whether the specified user can log in to the
    104107remote server. If the password is not specified on the commandline, it
    105108will 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="id2532547"></a><h3>RAP GROUPMEMBER</h3><div class="refsect3" lang="en"><a name="id2532552"></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="id2532565"></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="id2532580"></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="id2532596"></a><h3>RAP ADMIN <em class="replaceable"><code>command</code></em></h3><p>Execute the specified <em class="replaceable"><code>command</code></em> on
     109</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div><div class="refsect2" lang="en"><a name="id2532565"></a><h3>RAP GROUPMEMBER</h3><div class="refsect3" lang="en"><a name="id2532570"></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="id2532583"></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="id2532598"></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="id2532614"></a><h3>RAP ADMIN <em class="replaceable"><code>command</code></em></h3><p>Execute the specified <em class="replaceable"><code>command</code></em> on
    107110the 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="id2532616"></a><h3>RAP SERVICE</h3><div class="refsect3" lang="en"><a name="id2532621"></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="id2532640"></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="id2532656"></a><h3>RAP PASSWORD <em class="replaceable"><code>USER</code></em> <em class="replaceable"><code>OLDPASS</code></em> <em class="replaceable"><code>NEWPASS</code></em></h3><p>
     111</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div><div class="refsect2" lang="en"><a name="id2532634"></a><h3>RAP SERVICE</h3><div class="refsect3" lang="en"><a name="id2532639"></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="id2532658"></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="id2532674"></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>
    109112Change 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="id2532683"></a><h3>LOOKUP</h3><div class="refsect3" lang="en"><a name="id2532689"></a><h4>LOOKUP HOST <em class="replaceable"><code>HOSTNAME</code></em> [<em class="replaceable"><code>TYPE</code></em>]</h4><p>
     113</p></div><div class="refsect2" lang="en"><a name="id2532701"></a><h3>LOOKUP</h3><div class="refsect3" lang="en"><a name="id2532707"></a><h4>LOOKUP HOST <em class="replaceable"><code>HOSTNAME</code></em> [<em class="replaceable"><code>TYPE</code></em>]</h4><p>
    111114Lookup the IP address of the given host with the specified type (netbios suffix).
    112115The type defaults to 0x20 (workstation).
    113 </p></div><div class="refsect3" lang="en"><a name="id2532707"></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="id2532724"></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="id2532741"></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="id2532758"></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="id2532775"></a><h3>CACHE</h3><p>Samba uses a general caching interface called 'gencache'. It
     116</p></div><div class="refsect3" lang="en"><a name="id2532725"></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="id2532742"></a><h4>LOOKUP KDC [<em class="replaceable"><code>REALM</code></em>]</h4><p>Give IP address of KDC for the specified <em class="replaceable"><code>REALM</code></em>.
     117Defaults to local realm.</p></div><div class="refsect3" lang="en"><a name="id2532759"></a><h4>LOOKUP DC [<em class="replaceable"><code>DOMAIN</code></em>]</h4><p>Give IP's of Domain Controllers for specified <em class="replaceable"><code>
     118DOMAIN</code></em>. Defaults to local domain.</p></div><div class="refsect3" lang="en"><a name="id2532776"></a><h4>LOOKUP MASTER <em class="replaceable"><code>DOMAIN</code></em></h4><p>Give IP of master browser for specified <em class="replaceable"><code>DOMAIN</code></em>
     119or workgroup. Defaults to local domain.</p></div></div><div class="refsect2" lang="en"><a name="id2532793"></a><h3>CACHE</h3><p>Samba uses a general caching interface called 'gencache'. It
    117120can be controlled using 'NET CACHE'.</p><p>All the timeout parameters support the suffixes:
    118121
    119122</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>
    120123
    121 </p><div class="refsect3" lang="en"><a name="id2532811"></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="id2532830"></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="id2532842"></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="id2532861"></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="id2532873"></a><h4>CACHE LIST</h4><p>
     124</p><div class="refsect3" lang="en"><a name="id2532829"></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="id2532848"></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="id2532860"></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="id2532879"></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="id2532891"></a><h4>CACHE LIST</h4><p>
    122125List all current items in the cache.
    123 </p></div><div class="refsect3" lang="en"><a name="id2532884"></a><h4>CACHE FLUSH</h4><p>Remove all the current items from the cache.</p></div></div><div class="refsect2" lang="en"><a name="id2532895"></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="id2532907"></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="id2532917"></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="id2532928"></a><h3>SETDOMAINSID</h3><p>Sets the SID of the current domain.</p></div><div class="refsect2" lang="en"><a name="id2532938"></a><h3>GROUPMAP</h3><p>Manage the mappings between Windows group SIDs and UNIX groups.
     126</p></div><div class="refsect3" lang="en"><a name="id2532902"></a><h4>CACHE FLUSH</h4><p>Remove all the current items from the cache.</p></div></div><div class="refsect2" lang="en"><a name="id2532913"></a><h3>GETLOCALSID [DOMAIN]</h3><p>Prints the SID of the specified domain, or if the parameter is
     127omitted, the SID of the local server.</p></div><div class="refsect2" lang="en"><a name="id2532925"></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="id2532935"></a><h3>GETDOMAINSID</h3><p>Prints the local machine SID and the SID of the current
     128domain.</p></div><div class="refsect2" lang="en"><a name="id2532946"></a><h3>SETDOMAINSID</h3><p>Sets the SID of the current domain.</p></div><div class="refsect2" lang="en"><a name="id2532956"></a><h3>GROUPMAP</h3><p>Manage the mappings between Windows group SIDs and UNIX groups.
    126129Common 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
    127130  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="id2532981"></a><h4>GROUPMAP ADD</h4><p>
     131  or 'builtin'</p></li><li><p>comment - Freeform text description of the group</p></li></ul></div><div class="refsect3" lang="en"><a name="id2532999"></a><h4>GROUPMAP ADD</h4><p>
    129132Add a new group mapping entry:
    130133</p><pre class="programlisting">
     
    132135        [type={domain|local}] [ntgroup=string] [comment=string]
    133136</pre><p>
    134 </p></div><div class="refsect3" lang="en"><a name="id2532998"></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="id2533013"></a><h4>GROUPMAP MODIFY</h4><p>Update en existing group entry.</p><p>
     137</p></div><div class="refsect3" lang="en"><a name="id2533016"></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="id2533031"></a><h4>GROUPMAP MODIFY</h4><p>Update en existing group entry.</p><p>
    135138</p><pre class="programlisting">
    136139net groupmap modify {ntgroup=string|sid=SID} [unixgroup=string] \
    137140       [comment=string] [type={domain|local}]
    138141</pre><p>
    139 </p></div><div class="refsect3" lang="en"><a name="id2533033"></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="id2533049"></a><h3>MAXRID</h3><p>Prints out the highest RID currently in use on the local
     142</p></div><div class="refsect3" lang="en"><a name="id2533051"></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="id2533067"></a><h3>MAXRID</h3><p>Prints out the highest RID currently in use on the local
    140143server (by the active 'passdb backend').
    141 </p></div><div class="refsect2" lang="en"><a name="id2533060"></a><h3>RPC INFO</h3><p>Print information about the domain of the remote server,
     144</p></div><div class="refsect2" lang="en"><a name="id2533078"></a><h3>RPC INFO</h3><p>Print information about the domain of the remote server,
    142145such as domain name, domain sid and number of users and groups.
    143 </p></div><div class="refsect2" lang="en"><a name="id2533072"></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="id2533083"></a><h3>[RPC|ADS] CHANGETRUSTPW</h3><p>Force change of domain trust password.</p></div><div class="refsect2" lang="en"><a name="id2533093"></a><h3>RPC TRUSTDOM</h3><div class="refsect3" lang="en"><a name="id2533098"></a><h4>RPC TRUSTDOM ADD <em class="replaceable"><code>DOMAIN</code></em></h4><p>Add a interdomain trust account for <em class="replaceable"><code>DOMAIN</code></em>.
     146</p></div><div class="refsect2" lang="en"><a name="id2533090"></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="id2533101"></a><h3>[RPC|ADS] CHANGETRUSTPW</h3><p>Force change of domain trust password.</p></div><div class="refsect2" lang="en"><a name="id2533111"></a><h3>RPC TRUSTDOM</h3><div class="refsect3" lang="en"><a name="id2533117"></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>.
    144147This is in fact a Samba account named <em class="replaceable"><code>DOMAIN$</code></em>
    145148with the account flag <code class="constant">'I'</code> (interdomain trust account).
     
    147150<code class="literal">smbpasswd -a -i DOMAIN</code>. Please note that both commands
    148151expect a appropriate UNIX account.
    149 </p></div><div class="refsect3" lang="en"><a name="id2533130"></a><h4>RPC TRUSTDOM DEL <em class="replaceable"><code>DOMAIN</code></em></h4><p>Remove interdomain trust account for
     152</p></div><div class="refsect3" lang="en"><a name="id2533148"></a><h4>RPC TRUSTDOM DEL <em class="replaceable"><code>DOMAIN</code></em></h4><p>Remove interdomain trust account for
    150153<em class="replaceable"><code>DOMAIN</code></em>. If it is used against localhost
    151154it has the same effect as <code class="literal">smbpasswd -x DOMAIN$</code>.
    152 </p></div><div class="refsect3" lang="en"><a name="id2533152"></a><h4>RPC TRUSTDOM ESTABLISH <em class="replaceable"><code>DOMAIN</code></em></h4><p>
     155</p></div><div class="refsect3" lang="en"><a name="id2533170"></a><h4>RPC TRUSTDOM ESTABLISH <em class="replaceable"><code>DOMAIN</code></em></h4><p>
    153156Establish a trust relationship to a trusting domain.
    154157Interdomain account must already be created on the remote PDC.
    155 </p></div><div class="refsect3" lang="en"><a name="id2533166"></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="id2533178"></a><h4>RPC TRUSTDOM LIST</h4><p>List all current interdomain trust relationships.</p></div><div class="refsect3" lang="en"><a name="id2533189"></a><h4>RPC RIGHTS</h4><p>This subcommand is used to view and manage Samba's rights assignments (also
     158</p></div><div class="refsect3" lang="en"><a name="id2533184"></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="id2533196"></a><h4>RPC TRUSTDOM LIST</h4><p>List all current interdomain trust relationships.</p></div><div class="refsect3" lang="en"><a name="id2533207"></a><h4>RPC RIGHTS</h4><p>This subcommand is used to view and manage Samba's rights assignments (also
    156159referred to as privileges).  There are three options currently available:
    157160<em class="parameter"><code>list</code></em>, <em class="parameter"><code>grant</code></em>, and
    158161<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="id2533219"></a><h3>RPC ABORTSHUTDOWN</h3><p>Abort the shutdown of a remote server.</p></div><div class="refsect2" lang="en"><a name="id2533230"></a><h3>RPC SHUTDOWN [-t timeout] [-r] [-f] [-C message]</h3><p>Shut down the remote server.</p><div class="variablelist"><dl><dt><span class="term">-r</span></dt><dd><p>
     162can be found in the Samba-HOWTO-Collection.</p></div></div><div class="refsect2" lang="en"><a name="id2533238"></a><h3>RPC ABORTSHUTDOWN</h3><p>Abort the shutdown of a remote server.</p></div><div class="refsect2" lang="en"><a name="id2533248"></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>
    160163Reboot after shutdown.
    161164</p></dd><dt><span class="term">-f</span></dt><dd><p>
     
    165168user of the system can use this time to cancel the shutdown.
    166169</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="id2533290"></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="id2533302"></a><h3>RPC VAMPIRE</h3><p>Export users, aliases and groups from remote server to
     170announce the shutdown.</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2533309"></a><h3>RPC SAMDUMP</h3><p>Print out sam database of remote server. You need
     171to run this against the PDC, from a Samba machine joined as a BDC. </p></div><div class="refsect2" lang="en"><a name="id2533320"></a><h3>RPC VAMPIRE</h3><p>Export users, aliases and groups from remote server to
    169172local 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="id2533314"></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="id2533330"></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="id2533341"></a><h3>ADS STATUS</h3><p>Print out status of machine account of the local machine in ADS.
     173</p></div><div class="refsect2" lang="en"><a name="id2533333"></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="id2533348"></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="id2533359"></a><h3>ADS STATUS</h3><p>Print out status of machine account of the local machine in ADS.
    171174Prints 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="id2533358"></a><h3>ADS PRINTER</h3><div class="refsect3" lang="en"><a name="id2533363"></a><h4>ADS PRINTER INFO [<em class="replaceable"><code>PRINTER</code></em>] [<em class="replaceable"><code>SERVER</code></em>]</h4><p>
     175users should use <code class="literal">NET ADS TESTJOIN</code>.</p></div><div class="refsect2" lang="en"><a name="id2533376"></a><h3>ADS PRINTER</h3><div class="refsect3" lang="en"><a name="id2533382"></a><h4>ADS PRINTER INFO [<em class="replaceable"><code>PRINTER</code></em>] [<em class="replaceable"><code>SERVER</code></em>]</h4><p>
    173176Lookup 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="id2533387"></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="id2533400"></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="id2533414"></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
     177server name defaults to the local host.</p></div><div class="refsect3" lang="en"><a name="id2533405"></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="id2533418"></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="id2533432"></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
    175178expression is a standard LDAP search expression, and the
    176179attributes 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="id2533441"></a><h3>ADS DN <em class="replaceable"><code>DN</code></em> <em class="replaceable"><code>(attributes)</code></em></h3><p>
     180</p></div><div class="refsect2" lang="en"><a name="id2533459"></a><h3>ADS DN <em class="replaceable"><code>DN</code></em> <em class="replaceable"><code>(attributes)</code></em></h3><p>
    178181Perform a raw LDAP search on a ADS server and dump the results. The
    179182DN standard LDAP DN, and the attributes are a list of LDAP fields
    180183to 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="id2533468"></a><h3>ADS WORKGROUP</h3><p>Print out workgroup name for specified kerberos realm.</p></div><div class="refsect2" lang="en"><a name="id2533478"></a><h3>SAM CREATEBUILTINGROUP &lt;NAME&gt;</h3><p>
     184</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="id2533486"></a><h3>ADS WORKGROUP</h3><p>Print out workgroup name for specified kerberos realm.</p></div><div class="refsect2" lang="en"><a name="id2533496"></a><h3>SAM CREATEBUILTINGROUP &lt;NAME&gt;</h3><p>
    182185(Re)Create a BUILTIN group.
    183186Only a wellknown set of BUILTIN groups can be created with this command.
     
    189192This command requires a running Winbindd with idmap allocation properly
    190193configured. The group gid will be allocated out of the winbindd range.
    191 </p></div><div class="refsect2" lang="en"><a name="id2533497"></a><h3>SAM CREATELOCALGROUP &lt;NAME&gt;</h3><p>
     194</p></div><div class="refsect2" lang="en"><a name="id2533515"></a><h3>SAM CREATELOCALGROUP &lt;NAME&gt;</h3><p>
    192195Create a LOCAL group (also known as Alias).
    193196
    194197This command requires a running Winbindd with idmap allocation properly
    195198configured. The group gid will be allocated out of the winbindd range.
    196 </p></div><div class="refsect2" lang="en"><a name="id2533511"></a><h3>SAM DELETELOCALGROUP &lt;NAME&gt;</h3><p>
     199</p></div><div class="refsect2" lang="en"><a name="id2533529"></a><h3>SAM DELETELOCALGROUP &lt;NAME&gt;</h3><p>
    197200Delete an existing LOCAL group (also known as Alias).
    198201
    199 </p></div><div class="refsect2" lang="en"><a name="id2533522"></a><h3>SAM MAPUNIXGROUP &lt;NAME&gt;</h3><p>
     202</p></div><div class="refsect2" lang="en"><a name="id2533540"></a><h3>SAM MAPUNIXGROUP &lt;NAME&gt;</h3><p>
    200203Map an existing Unix group and make it a Domain Group, the domain group
    201204will have the same name.
    202 </p></div><div class="refsect2" lang="en"><a name="id2533534"></a><h3>SAM UNMAPUNIXGROUP &lt;NAME&gt;</h3><p>
     205</p></div><div class="refsect2" lang="en"><a name="id2533553"></a><h3>SAM UNMAPUNIXGROUP &lt;NAME&gt;</h3><p>
    203206Remove an existing group mapping entry.
    204 </p></div><div class="refsect2" lang="en"><a name="id2533546"></a><h3>SAM ADDMEM &lt;GROUP&gt; &lt;MEMBER&gt;</h3><p>
     207</p></div><div class="refsect2" lang="en"><a name="id2533564"></a><h3>SAM ADDMEM &lt;GROUP&gt; &lt;MEMBER&gt;</h3><p>
    205208Add a member to a Local group. The group can be specified only by name,
    206209the member can be specified by name or SID.
    207 </p></div><div class="refsect2" lang="en"><a name="id2533559"></a><h3>SAM DELMEM  &lt;GROUP&gt; &lt;MEMBER&gt;</h3><p>
     210</p></div><div class="refsect2" lang="en"><a name="id2533577"></a><h3>SAM DELMEM  &lt;GROUP&gt; &lt;MEMBER&gt;</h3><p>
    208211Remove a member from a Local group. The group and the member must be
    209212specified by name.
    210 </p></div><div class="refsect2" lang="en"><a name="id2533571"></a><h3>SAM LISTMEM &lt;GROUP&gt;</h3><p>
     213</p></div><div class="refsect2" lang="en"><a name="id2533589"></a><h3>SAM LISTMEM &lt;GROUP&gt;</h3><p>
    211214List Local group members. The group must be specified by name.
    212 </p></div><div class="refsect2" lang="en"><a name="id2533582"></a><h3>SAM LIST &lt;users|groups|localgroups|builtin|workstations&gt; [verbose]</h3><p>
     215</p></div><div class="refsect2" lang="en"><a name="id2533600"></a><h3>SAM LIST &lt;users|groups|localgroups|builtin|workstations&gt; [verbose]</h3><p>
    213216List the specified set of accounts by name. If verbose is specified,
    214217the rid and description is also provided for each account.
    215 </p></div><div class="refsect2" lang="en"><a name="id2533596"></a><h3>SAM SHOW &lt;NAME&gt;</h3><p>
     218</p></div><div class="refsect2" lang="en"><a name="id2533614"></a><h3>SAM SHOW &lt;NAME&gt;</h3><p>
    216219Show the full DOMAIN\\NAME the SID and the type for the corresponding
    217220account.
    218 </p></div><div class="refsect2" lang="en"><a name="id2533607"></a><h3>SAM SET HOMEDIR &lt;NAME&gt; &lt;DIRECTORY&gt;</h3><p>
     221</p></div><div class="refsect2" lang="en"><a name="id2533625"></a><h3>SAM SET HOMEDIR &lt;NAME&gt; &lt;DIRECTORY&gt;</h3><p>
    219222Set the home directory for a user account.
    220 </p></div><div class="refsect2" lang="en"><a name="id2533618"></a><h3>SAM SET PROFILEPATH &lt;NAME&gt; &lt;PATH&gt;</h3><p>
     223</p></div><div class="refsect2" lang="en"><a name="id2533636"></a><h3>SAM SET PROFILEPATH &lt;NAME&gt; &lt;PATH&gt;</h3><p>
    221224Set the profile path for a user account.
    222 </p></div><div class="refsect2" lang="en"><a name="id2533629"></a><h3>SAM SET COMMENT &lt;NAME&gt; &lt;COMMENT&gt;</h3><p>
     225</p></div><div class="refsect2" lang="en"><a name="id2533647"></a><h3>SAM SET COMMENT &lt;NAME&gt; &lt;COMMENT&gt;</h3><p>
    223226Set the comment for a user or group account.
    224 </p></div><div class="refsect2" lang="en"><a name="id2533639"></a><h3>SAM SET FULLNAME &lt;NAME&gt; &lt;FULL NAME&gt;</h3><p>
     227</p></div><div class="refsect2" lang="en"><a name="id2533657"></a><h3>SAM SET FULLNAME &lt;NAME&gt; &lt;FULL NAME&gt;</h3><p>
    225228Set the full name for a user account.
    226 </p></div><div class="refsect2" lang="en"><a name="id2533650"></a><h3>SAM SET LOGONSCRIPT &lt;NAME&gt; &lt;SCRIPT&gt;</h3><p>
     229</p></div><div class="refsect2" lang="en"><a name="id2533669"></a><h3>SAM SET LOGONSCRIPT &lt;NAME&gt; &lt;SCRIPT&gt;</h3><p>
    227230Set the logon script for a user account.
    228 </p></div><div class="refsect2" lang="en"><a name="id2533662"></a><h3>SAM SET HOMEDRIVE &lt;NAME&gt; &lt;DRIVE&gt;</h3><p>
     231</p></div><div class="refsect2" lang="en"><a name="id2533680"></a><h3>SAM SET HOMEDRIVE &lt;NAME&gt; &lt;DRIVE&gt;</h3><p>
    229232Set the home drive for a user account.
    230 </p></div><div class="refsect2" lang="en"><a name="id2533673"></a><h3>SAM SET WORKSTATIONS &lt;NAME&gt; &lt;WORKSTATIONS&gt;</h3><p>
     233</p></div><div class="refsect2" lang="en"><a name="id2533691"></a><h3>SAM SET WORKSTATIONS &lt;NAME&gt; &lt;WORKSTATIONS&gt;</h3><p>
    231234Set the workstations a user account is allowed to log in from.
    232 </p></div><div class="refsect2" lang="en"><a name="id2533685"></a><h3>SAM SET DISABLE &lt;NAME&gt;</h3><p>
     235</p></div><div class="refsect2" lang="en"><a name="id2533703"></a><h3>SAM SET DISABLE &lt;NAME&gt;</h3><p>
    233236Set the "disabled" flag for a user account.
    234 </p></div><div class="refsect2" lang="en"><a name="id2533696"></a><h3>SAM SET PWNOTREQ &lt;NAME&gt;</h3><p>
     237</p></div><div class="refsect2" lang="en"><a name="id2533714"></a><h3>SAM SET PWNOTREQ &lt;NAME&gt;</h3><p>
    235238Set the "password not required" flag for a user account.
    236 </p></div><div class="refsect2" lang="en"><a name="id2533707"></a><h3>SAM SET AUTOLOCK &lt;NAME&gt;</h3><p>
     239</p></div><div class="refsect2" lang="en"><a name="id2533725"></a><h3>SAM SET AUTOLOCK &lt;NAME&gt;</h3><p>
    237240Set the "autolock" flag for a user account.
    238 </p></div><div class="refsect2" lang="en"><a name="id2533719"></a><h3>SAM SET PWNOEXP &lt;NAME&gt;</h3><p>
     241</p></div><div class="refsect2" lang="en"><a name="id2533737"></a><h3>SAM SET PWNOEXP &lt;NAME&gt;</h3><p>
    239242Set the "password do not expire" flag for a user account.
    240 </p></div><div class="refsect2" lang="en"><a name="id2533730"></a><h3>SAM SET PWDMUSTCHANGENOW &lt;NAME&gt; [yes|no]</h3><p>
     243</p></div><div class="refsect2" lang="en"><a name="id2533748"></a><h3>SAM SET PWDMUSTCHANGENOW &lt;NAME&gt; [yes|no]</h3><p>
    241244Set or unset the "password must change" flag for a user account.
    242 </p></div><div class="refsect2" lang="en"><a name="id2533742"></a><h3>SAM POLICY LIST</h3><p>
     245</p></div><div class="refsect2" lang="en"><a name="id2533760"></a><h3>SAM POLICY LIST</h3><p>
    243246List the available account policies.
    244 </p></div><div class="refsect2" lang="en"><a name="id2533752"></a><h3>SAM POLICY SHOW &lt;account policy&gt;</h3><p>
     247</p></div><div class="refsect2" lang="en"><a name="id2533770"></a><h3>SAM POLICY SHOW &lt;account policy&gt;</h3><p>
    245248Show the account policy value.
    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>
     249</p></div><div class="refsect2" lang="en"><a name="id2533781"></a><h3>SAM POLICY SET &lt;account policy&gt; &lt;value&gt;</h3><p>
    247250Set a value for the account policy.
    248251Valid values can be: "forever", "never", "off", or a number.
    249 </p></div><div class="refsect2" lang="en"><a name="id2533776"></a><h3>SAM PROVISION</h3><p>
     252</p></div><div class="refsect2" lang="en"><a name="id2533794"></a><h3>SAM PROVISION</h3><p>
    250253Only available if ldapsam:editposix is set and winbindd is running.
    251254Properly populates the ldap tree with the basic accounts (Administrator)
    252255and groups (Domain Users, Domain Admins, Domain Guests) on the ldap tree.
    253 </p></div><div class="refsect2" lang="en"><a name="id2533789"></a><h3>IDMAP DUMP &lt;local tdb file name&gt;</h3><p>
     256</p></div><div class="refsect2" lang="en"><a name="id2533807"></a><h3>IDMAP DUMP &lt;local tdb file name&gt;</h3><p>
    254257Dumps the mappings contained in the local tdb file specified.
    255258This command is useful to dump only the mappings produced by the idmap_tdb backend.
    256 </p></div><div class="refsect2" lang="en"><a name="id2533803"></a><h3>IDMAP RESTORE [input file]</h3><p>
     259</p></div><div class="refsect2" lang="en"><a name="id2533821"></a><h3>IDMAP RESTORE [input file]</h3><p>
    257260Restore the mappings from the specified file or stdin.
    258 </p></div><div class="refsect2" lang="en"><a name="id2533814"></a><h3>IDMAP SECRET &lt;DOMAIN&gt;|ALLOC &lt;secret&gt;</h3><p>
     261</p></div><div class="refsect2" lang="en"><a name="id2533832"></a><h3>IDMAP SECRET &lt;DOMAIN&gt;|ALLOC &lt;secret&gt;</h3><p>
    259262Store a secret for the specified domain, used primarily for domains
    260263that use idmap_ldap as a backend. In this case the secret is used
    261264as the password for the user DN used to bind to the ldap server.
    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
     265</p></div><div class="refsect2" lang="en"><a name="id2533846"></a><h3>USERSHARE</h3><p>Starting with version 3.0.23, a Samba server now supports the ability for
    263266non-root users to add user defined shares to be exported using the "net usershare"
    264267commands.
     
    289292</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>
    290293
    291 </p><div class="refsect3" lang="en"><a name="id2533886"></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>
     294</p><div class="refsect3" lang="en"><a name="id2481377"></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>
    292295Add or replace a new user defined share, with name "sharename".
    293296</p><p>
     
    326329at connect time so will see the change immediately, there is no need
    327330to restart smbd on adding, deleting or changing a user defined share.
    328 </div><div class="refsect3" lang="en"><a name="id2533958"></a><h4>USERSHARE DELETE <em class="replaceable"><code>sharename</code></em></h4><p>
     331</div><div class="refsect3" lang="en"><a name="id2481451"></a><h4>USERSHARE DELETE <em class="replaceable"><code>sharename</code></em></h4><p>
    329332Deletes the user defined share by name. The Samba smbd daemon
    330333immediately notices this change, although it will not disconnect
    331334any users currently connected to the deleted share.
    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>
     335</p></div><div class="refsect3" lang="en"><a name="id2481467"></a><h4>USERSHARE INFO <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>[wildcard sharename]</code></em></h4><p>
    333336Get info on user defined shares owned by the current user matching the given pattern, or all users.
    334337</p><p>
     
    349352And is a list of the current settings of the user defined share that can be
    350353modified by the "net usershare add" command.
    351 </p></div><div class="refsect3" lang="en"><a name="id2534007"></a><h4>USERSHARE LIST <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>wildcard sharename</code></em></h4><p>
     354</p></div><div class="refsect3" lang="en"><a name="id2534165"></a><h4>USERSHARE LIST <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>wildcard sharename</code></em></h4><p>
    352355List all the user defined shares owned by the current user matching the given pattern, or all users.
    353356</p><p>
     
    357360If the '-l' or '--long' option is also given, it includes the names of user defined
    358361shares created by other users.
    359 </p></div></div><div class="refsect2" lang="en"><a name="id2534040"></a><h3>CONF</h3><p>Starting with version 3.2.0, a Samba server can be configured by data
     362</p></div></div><div class="refsect2" lang="en"><a name="id2534192"></a><h3>CONF</h3><p>Starting with version 3.2.0, a Samba server can be configured by data
    360363stored in registry. This configuration data can be edited with the new "net
    361364conf" commands.
     
    375378format.</td></tr><tr><td>net conf listshares - List the registry shares.</td></tr><tr><td>net conf drop - Delete the complete configuration from
    376379registry.</td></tr><tr><td>net conf showshare - Show the definition of a registry share.</td></tr><tr><td>net conf addshare - Create a new registry share.</td></tr><tr><td>net conf delshare - Delete a registry share.</td></tr><tr><td>net conf setparm - Store a parameter.</td></tr><tr><td>net conf getparm - Retrieve the value of a parameter.</td></tr><tr><td>net conf delparm - Delete a parameter.</td></tr><tr><td>net conf getincludes - Show the includes of a share definition.</td></tr><tr><td>net conf setincludes - Set includes for a share.</td></tr><tr><td>net conf delincludes - Delete includes from a share definition.</td></tr></table><p>
    377 </p><div class="refsect3" lang="en"><a name="id2534161"></a><h4>CONF LIST</h4><p>
     380</p><div class="refsect3" lang="en"><a name="id2534313"></a><h4>CONF LIST</h4><p>
    378381Print the configuration data stored in the registry in a smb.conf-like format to
    379382standard output.
    380 </p></div><div class="refsect3" lang="en"><a name="id2534172"></a><h4>CONF IMPORT <em class="replaceable"><code>[--test|-T]</code></em> <em class="replaceable"><code>filename</code></em> <em class="replaceable"><code>[section]</code></em></h4><p>
     383</p></div><div class="refsect3" lang="en"><a name="id2534324"></a><h4>CONF IMPORT <em class="replaceable"><code>[--test|-T]</code></em> <em class="replaceable"><code>filename</code></em> <em class="replaceable"><code>[section]</code></em></h4><p>
    381384This command imports configuration from a file in smb.conf format.
    382385If a section encountered in the input file is present in registry,
     
    388391the parameter "-T" on the commandline. In test mode, no changes are made to the
    389392registry, and the resulting configuration is printed to standard output instead.
    390 </p></div><div class="refsect3" lang="en"><a name="id2534202"></a><h4>CONF LISTSHARES</h4><p>
     393</p></div><div class="refsect3" lang="en"><a name="id2534354"></a><h4>CONF LISTSHARES</h4><p>
    391394List the names of the shares defined in registry.
    392 </p></div><div class="refsect3" lang="en"><a name="id2534212"></a><h4>CONF DROP</h4><p>
     395</p></div><div class="refsect3" lang="en"><a name="id2534364"></a><h4>CONF DROP</h4><p>
    393396Delete the complete configuration data from registry.
    394 </p></div><div class="refsect3" lang="en"><a name="id2534223"></a><h4>CONF SHOWSHARE <em class="replaceable"><code>sharename</code></em></h4><p>
     397</p></div><div class="refsect3" lang="en"><a name="id2534375"></a><h4>CONF SHOWSHARE <em class="replaceable"><code>sharename</code></em></h4><p>
    395398Show the definition of the share or section specified. It is valid to specify
    396399"global" as sharename to retrieve the global configuration options from
    397400registry.
    398 </p></div><div class="refsect3" lang="en"><a name="id2534238"></a><h4>CONF ADDSHARE <em class="replaceable"><code>sharename</code></em> <em class="replaceable"><code>path</code></em> [<em class="replaceable"><code>writeable={y|N}</code></em> [<em class="replaceable"><code>guest_ok={y|N}</code></em> [<em class="replaceable"><code>comment</code></em>]]] </h4><p>Create a new share definition in registry.
     401</p></div><div class="refsect3" lang="en"><a name="id2534389"></a><h4>CONF ADDSHARE <em class="replaceable"><code>sharename</code></em> <em class="replaceable"><code>path</code></em> [<em class="replaceable"><code>writeable={y|N}</code></em> [<em class="replaceable"><code>guest_ok={y|N}</code></em> [<em class="replaceable"><code>comment</code></em>]]] </h4><p>Create a new share definition in registry.
    399402The sharename and path have to be given. The share name may
    400403<span class="emphasis"><em>not</em></span> be "global". Optionally, values for the very
     
    402405The same result may be obtained by a sequence of "net conf setparm"
    403406commands.
    404 </p></div><div class="refsect3" lang="en"><a name="id2534272"></a><h4>CONF DELSHARE <em class="replaceable"><code>sharename</code></em></h4><p>
     407</p></div><div class="refsect3" lang="en"><a name="id2534423"></a><h4>CONF DELSHARE <em class="replaceable"><code>sharename</code></em></h4><p>
    405408Delete a share definition from registry.
    406 </p></div><div class="refsect3" lang="en"><a name="id2534284"></a><h4>CONF SETPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em> <em class="replaceable"><code>value</code></em></h4><p>
     409</p></div><div class="refsect3" lang="en"><a name="id2534436"></a><h4>CONF SETPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em> <em class="replaceable"><code>value</code></em></h4><p>
    407410Store a parameter in registry. The section may be global or a sharename.
    408411The section is created if it does not exist yet.
    409 </p></div><div class="refsect3" lang="en"><a name="id2534304"></a><h4>CONF GETPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em></h4><p>
     412</p></div><div class="refsect3" lang="en"><a name="id2534456"></a><h4>CONF GETPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em></h4><p>
    410413Show a parameter stored in registry.
    411 </p></div><div class="refsect3" lang="en"><a name="id2534320"></a><h4>CONF DELPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em></h4><p>
     414</p></div><div class="refsect3" lang="en"><a name="id2534472"></a><h4>CONF DELPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em></h4><p>
    412415Delete a parameter stored in registry.
    413 </p></div><div class="refsect3" lang="en"><a name="id2534336"></a><h4>CONF GETINCLUDES <em class="replaceable"><code>section</code></em></h4><p>
     416</p></div><div class="refsect3" lang="en"><a name="id2534488"></a><h4>CONF GETINCLUDES <em class="replaceable"><code>section</code></em></h4><p>
    414417Get the list of includes for the provided section (global or share).
    415418</p><p>
     
    427430configuration. In the future, there will be the ability to include configuration
    428431data from other registry keys.
    429 </p></div><div class="refsect3" lang="en"><a name="id2534371"></a><h4>CONF SETINCLUDES <em class="replaceable"><code>section</code></em> [<em class="replaceable"><code>filename</code></em>]+</h4><p>
     432</p></div><div class="refsect3" lang="en"><a name="id2534523"></a><h4>CONF SETINCLUDES <em class="replaceable"><code>section</code></em> [<em class="replaceable"><code>filename</code></em>]+</h4><p>
    430433Set the list of includes for the provided section (global or share) to the given
    431434list of one or more filenames. The filenames may contain the usual smb.conf
    432435macros like %I.
    433 </p></div><div class="refsect3" lang="en"><a name="id2534390"></a><h4>CONF DELINCLUDES <em class="replaceable"><code>section</code></em></h4><p>
     436</p></div><div class="refsect3" lang="en"><a name="id2534542"></a><h4>CONF DELINCLUDES <em class="replaceable"><code>section</code></em></h4><p>
    434437Delete the list of includes from the provided section (global or share).
    435 </p></div></div><div class="refsect2" lang="en"><a name="id2534404"></a><h3>HELP [COMMAND]</h3><p>Gives usage information for the specified command.</p></div></div><div class="refsect1" lang="en"><a name="id2534416"></a><h2>VERSION</h2><p>This man page is complete for version 3 of the Samba
    436         suite.</p></div><div class="refsect1" lang="en"><a name="id2534426"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     438</p></div></div><div class="refsect2" lang="en"><a name="id2534556"></a><h3>DOM</h3><p>Starting with version 3.2.0 Samba has support for remote join and unjoin APIs, both client and server-side. Windows supports remote join capabilities since Windows 2000.
     439</p><p>In order for Samba to be joined or unjoined remotely an account must be used that is either member of the Domain Admins group, a member of the local Administrators group or a user that is granted the SeMachineAccountPrivilege privilege.
     440</p><p>The client side support for remote join is implemented in the net dom commands which are:
     441</p><table class="simplelist" border="0" summary="Simple list"><tr><td>net dom join - Join a remote computer into a domain.</td></tr><tr><td>net dom unjoin - Unjoin a remote computer from a domain.</td></tr></table><p>
     442</p><div class="refsect3" lang="en"><a name="id2534593"></a><h4>DOM JOIN        <em class="replaceable"><code>domain=DOMAIN</code></em> <em class="replaceable"><code>ou=OU</code></em> <em class="replaceable"><code>account=ACCOUNT</code></em> <em class="replaceable"><code>password=PASSWORD</code></em> <em class="replaceable"><code>reboot</code></em></h4><p>
     443Joins a computer into a domain. This command supports the following additional parameters:
     444</p><div class="itemizedlist"><ul type="disc"><li><p><em class="replaceable"><code>DOMAIN</code></em> can be a NetBIOS domain name (also known as short domain name) or a DNS domain name for Active Directory Domains. As in Windows, it is also possible to control which Domain Controller to use. This can be achieved by appending the DC name using the \ separator character. Example: MYDOM\MYDC. The <em class="replaceable"><code>DOMAIN</code></em> parameter cannot be NULL.</p></li><li><p><em class="replaceable"><code>OU</code></em> can be set to a RFC 1779 LDAP DN, like <span class="emphasis"><em>ou=mymachines,cn=Users,dc=example,dc=com</em></span> in order to create the machine account in a non-default LDAP containter. This optional parameter is only supported when joining Active Directory Domains.</p></li><li><p><em class="replaceable"><code>ACCOUNT</code></em> defines a domain account that will be used to join the machine to the domain. This domain account needs to have sufficient privileges to join machines.</p></li><li><p><em class="replaceable"><code>PASSWORD</code></em> defines the password for the domain account defined with <em class="replaceable"><code>ACCOUNT</code></em>.</p></li><li><p><em class="replaceable"><code>REBOOT</code></em> is an optional parameter that can be set to reboot the remote machine after successful join to the domain.</p></li></ul></div><p>
     445Note that you also need to use standard net paramters to connect and authenticate to the remote machine that you want to join. These additional parameters include: -S computer and -U user.
     446</p><p>
     447        Example:
     448        net dom join -S xp -U XP\\administrator%secret domain=MYDOM account=MYDOM\\administrator password=topsecret reboot.
     449</p><p>
     450This example would connect to a computer named XP as the local administrator using password secret, and join the computer into a domain called MYDOM using the MYDOM domain administrator account and password topsecret. After successful join, the computer would reboot.
     451</p></div><div class="refsect3" lang="en"><a name="id2534699"></a><h4>DOM UNJOIN <em class="replaceable"><code>account=ACCOUNT</code></em> <em class="replaceable"><code>password=PASSWORD</code></em> <em class="replaceable"><code>reboot</code></em></h4><p>
     452Unjoins a computer from a domain. This command supports the following additional parameters:
     453</p><div class="itemizedlist"><ul type="disc"><li><p><em class="replaceable"><code>ACCOUNT</code></em> defines a domain account that will be used to unjoin the machine from the domain. This domain account needs to have sufficient privileges to unjoin machines.</p></li><li><p><em class="replaceable"><code>PASSWORD</code></em> defines the password for the domain account defined with <em class="replaceable"><code>ACCOUNT</code></em>.</p></li><li><p><em class="replaceable"><code>REBOOT</code></em> is an optional parameter that can be set to reboot the remote machine after successful unjoin from the domain.</p></li></ul></div><p>
     454Note that you also need to use standard net paramters to connect and authenticate to the remote machine that you want to unjoin. These additional parameters include: -S computer and -U user.
     455</p><p>
     456        Example:
     457        net dom unjoin -S xp -U XP\\administrator%secret account=MYDOM\\administrator password=topsecret reboot.
     458</p><p>
     459This example would connect to a computer named XP as the local administrator using password secret, and unjoin the computer from the domain using the MYDOM domain administrator account and password topsecret. After successful unjoin, the computer would reboot.
     460</p></div></div><div class="refsect2" lang="en"><a name="id2534771"></a><h3>HELP [COMMAND]</h3><p>Gives usage information for the specified command.</p></div></div><div class="refsect1" lang="en"><a name="id2534783"></a><h2>VERSION</h2><p>This man page is complete for version 3 of the Samba
     461        suite.</p></div><div class="refsect1" lang="en"><a name="id2534793"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    437462        were created by Andrew Tridgell. Samba is now developed
    438463        by the Samba Team as an Open Source project similar
  • branches/samba-3.2.x/docs/htmldocs/manpages/smb.conf.5.html

    r233 r272  
    366366</h3></div></div></div><a class="indexterm" name="id2533431"></a><a name="ABORTSHUTDOWNSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This a full path name to a script called by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> that
    367367        should stop a shutdown procedure issued by the <a class="link" href="smb.conf.5.html#SHUTDOWNSCRIPT" target="_top">shutdown script</a>.</p><p>If the connected user posseses the <code class="constant">SeRemoteShutdownPrivilege</code>,
    368         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>
     368        right, this command will be run as root.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>abort shutdown script</code></em> = <code class="literal">""</code>
    369369</em></span>
    370370</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>abort shutdown script</code></em> = <code class="literal">/sbin/shutdown -c</code>
     
    52115211         <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> that should
    52125212        start a shutdown procedure.</p><p>If the connected user posseses the <code class="constant">SeRemoteShutdownPrivilege</code>,
    5213         right, this command will be run as user.</p><p>The %z %t %r %f variables are expanded as follows:</p><div class="itemizedlist"><ul type="disc"><li><p><em class="parameter"><code>%z</code></em> will be substituted with the
     5213        right, this command will be run as root.</p><p>The %z %t %r %f variables are expanded as follows:</p><div class="itemizedlist"><ul type="disc"><li><p><em class="parameter"><code>%z</code></em> will be substituted with the
    52145214                        shutdown message sent to the server.</p></li><li><p><em class="parameter"><code>%t</code></em> will be substituted with the
    52155215                        number of seconds to wait before effectively starting the
     
    52215221</p><pre class="programlisting">
    52225222#!/bin/bash
    5223                
    5224 $time=0
    5225 let "time/60"
    5226 let "time++"
     5223
     5224time=$2
     5225let time="${time} / 60"
     5226let time="${time} + 1"
    52275227
    52285228/sbin/shutdown $3 $4 +$time $1 &amp;
     5229
    52295230</pre><p>
    52305231        Shutdown does not return so we need to launch it in background.
     
    52335234</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>
    52345235</em></span>
    5235 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560267"></a>
     5236</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560268"></a>
    52365237
    52375238smb encrypt (S)
    5238 </h3></div></div></div><a class="indexterm" name="id2560268"></a><a name="SMBENCRYPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a new feature introduced with Samba 3.2 and above. It is an
     5239</h3></div></div></div><a class="indexterm" name="id2560269"></a><a name="SMBENCRYPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a new feature introduced with Samba 3.2 and above. It is an
    52395240    extension to the SMB/CIFS protocol negotiated as part of the UNIX extensions.
    52405241    SMB encryption uses the GSSAPI (SSPI on Windows) ability to encrypt
     
    52645265    to disabled, SMB encryption can not be negotiated.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>smb encrypt</code></em> = <code class="literal">auto</code>
    52655266</em></span>
    5266 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560373"></a>
     5267</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560374"></a>
    52675268
    52685269smb passwd file (G)
    5269 </h3></div></div></div><a class="indexterm" name="id2560374"></a><a name="SMBPASSWDFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option sets the path to the encrypted smbpasswd file. By
     5270</h3></div></div></div><a class="indexterm" name="id2560375"></a><a name="SMBPASSWDFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option sets the path to the encrypted smbpasswd file. By
    52705271    default the path to the smbpasswd file  is compiled into Samba.</p><p>
    52715272    An example of use is:
     
    52755276    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>smb passwd file</code></em> = <code class="literal">${prefix}/private/smbpasswd</code>
    52765277</em></span>
    5277 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560427"></a>
     5278</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560428"></a>
    52785279
    52795280smb ports (G)
    5280 </h3></div></div></div><a class="indexterm" name="id2560428"></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>
     5281</h3></div></div></div><a class="indexterm" name="id2560429"></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>
    52815282</em></span>
    52825283</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560469"></a>
     
    52925293</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>socket address</code></em> = <code class="literal">192.168.2.20</code>
    52935294</em></span>
    5294 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560539"></a>
     5295</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560540"></a>
    52955296
    52965297socket options (G)
    5297 </h3></div></div></div><a class="indexterm" name="id2560540"></a><a name="SOCKETOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to set socket options
     5298</h3></div></div></div><a class="indexterm" name="id2560541"></a><a name="SOCKETOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to set socket options
    52985299    to be used when talking with the client.</p><p>Socket options are controls on the networking layer
    52995300    of the operating systems which allow the connection to be
     
    53235324</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>socket options</code></em> = <code class="literal">IPTOS_LOWDELAY</code>
    53245325</em></span>
    5325 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560749"></a>
     5326</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560750"></a>
    53265327
    53275328stat cache (G)
    5328 </h3></div></div></div><a class="indexterm" name="id2560750"></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
     5329</h3></div></div></div><a class="indexterm" name="id2560751"></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
    53295330        speed up case insensitive name mappings. You should never need
    53305331        to change this parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>stat cache</code></em> = <code class="literal">yes</code>
     
    53455346        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>store dos attributes</code></em> = <code class="literal">no</code>
    53465347</em></span>
    5347 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560922"></a>
     5348</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560923"></a>
    53485349
    53495350strict allocate (S)
    5350 </h3></div></div></div><a class="indexterm" name="id2560923"></a><a name="STRICTALLOCATE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean that controls the handling of
     5351</h3></div></div></div><a class="indexterm" name="id2560924"></a><a name="STRICTALLOCATE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean that controls the handling of
    53515352    disk space allocation in the server. When this is set to <code class="constant">yes</code>
    53525353    the server will change from UNIX behaviour of not committing real
     
    53795380        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>strict locking</code></em> = <code class="literal">Auto</code>
    53805381</em></span>
    5381 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561072"></a>
     5382</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561073"></a>
    53825383
    53835384strict sync (S)
    5384 </h3></div></div></div><a class="indexterm" name="id2561073"></a><a name="STRICTSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>Many Windows applications (including the Windows 98 explorer
     5385</h3></div></div></div><a class="indexterm" name="id2561074"></a><a name="STRICTSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>Many Windows applications (including the Windows 98 explorer
    53855386    shell) seem to confuse flushing buffer contents to disk with doing
    53865387    a sync to disk. Under UNIX, a sync call forces the process to be
     
    53965397    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>
    53975398</em></span>
    5398 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561137"></a>
     5399</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561138"></a>
    53995400
    54005401svcctl list (G)
    5401 </h3></div></div></div><a class="indexterm" name="id2561138"></a><a name="SVCCTLLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of init scripts that smbd
     5402</h3></div></div></div><a class="indexterm" name="id2561139"></a><a name="SVCCTLLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of init scripts that smbd
    54025403    will use for starting and stopping Unix services via the Win32
    54035404    ServiceControl API.  This allows Windows administrators to
     
    54125413</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>svcctl list</code></em> = <code class="literal">cups postfix portmap httpd</code>
    54135414</em></span>
    5414 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561222"></a>
     5415</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561223"></a>
    54155416
    54165417sync always (S)
    5417 </h3></div></div></div><a class="indexterm" name="id2561223"></a><a name="SYNCALWAYS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls
     5418</h3></div></div></div><a class="indexterm" name="id2561224"></a><a name="SYNCALWAYS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls
    54185419    whether writes will always be written to stable storage before
    54195420    the write call returns. If this is <code class="constant">no</code> then the server will be
     
    54265427    any affect.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>sync always</code></em> = <code class="literal">no</code>
    54275428</em></span>
    5428 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561293"></a>
     5429</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561294"></a>
    54295430
    54305431syslog only (G)
    5431 </h3></div></div></div><a class="indexterm" name="id2561294"></a><a name="SYSLOGONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5432</h3></div></div></div><a class="indexterm" name="id2561295"></a><a name="SYSLOGONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    54325433    If this parameter is set then Samba debug messages are logged into the system
    54335434    syslog only, and not to the debug log files. There still will be some
     
    54495450    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>syslog</code></em> = <code class="literal">1</code>
    54505451</em></span>
    5451 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561411"></a>
     5452</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561412"></a>
    54525453
    54535454template homedir (G)
    5454 </h3></div></div></div><a class="indexterm" name="id2561412"></a><a name="TEMPLATEHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
     5455</h3></div></div></div><a class="indexterm" name="id2561413"></a><a name="TEMPLATEHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
    54555456        user, the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon  uses this
    54565457        parameter to fill in the home directory for that user. If the
     
    54655466</h3></div></div></div><a class="indexterm" name="id2561478"></a><a name="TEMPLATESHELL"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
    54665467        user, the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon uses this
    5467         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="id2561516"></a>
     5468        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="id2561517"></a>
    54685469
    54695470time offset (G)
    5470 </h3></div></div></div><a class="indexterm" name="id2561517"></a><a name="TIMEOFFSET"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a setting in minutes to add
     5471</h3></div></div></div><a class="indexterm" name="id2561518"></a><a name="TIMEOFFSET"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a setting in minutes to add
    54715472        to the normal GMT to local time conversion. This is useful if
    54725473        you are serving a lot of PCs that have incorrect daylight
     
    54755476</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>time offset</code></em> = <code class="literal">60</code>
    54765477</em></span>
    5477 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561576"></a>
     5478</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561577"></a>
    54785479
    54795480time server (G)
    5480 </h3></div></div></div><a class="indexterm" name="id2561577"></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
     5481</h3></div></div></div><a class="indexterm" name="id2561578"></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
    54815482clients.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>time server</code></em> = <code class="literal">no</code>
    54825483</em></span>
    5483 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561626"></a>
     5484</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561627"></a>
    54845485
    54855486unix charset (G)
    5486 </h3></div></div></div><a class="indexterm" name="id2561627"></a><a name="UNIXCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the charset the unix machine
     5487</h3></div></div></div><a class="indexterm" name="id2561628"></a><a name="UNIXCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the charset the unix machine
    54875488                Samba runs on uses. Samba needs to know this in order to be able to
    54885489                convert text to the charsets other SMB clients use.
     
    54935494</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>unix charset</code></em> = <code class="literal">ASCII</code>
    54945495</em></span>
    5495 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561692"></a>
     5496</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561693"></a>
    54965497
    54975498unix extensions (G)
    5498 </h3></div></div></div><a class="indexterm" name="id2561693"></a><a name="UNIXEXTENSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
    5499     implments the CIFS UNIX extensions, as defined by HP.
     5499</h3></div></div></div><a class="indexterm" name="id2561694"></a><a name="UNIXEXTENSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
     5500    implements the CIFS UNIX extensions, as defined by HP.
    55005501    These extensions enable Samba to better serve UNIX CIFS clients
    55015502    by supporting features such as symbolic links, hard links, etc...
     
    55365537        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>update encrypted</code></em> = <code class="literal">no</code>
    55375538</em></span>
    5538 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561919"></a>
     5539</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561920"></a>
    55395540
    55405541use client driver (S)
    5541 </h3></div></div></div><a class="indexterm" name="id2561920"></a><a name="USECLIENTDRIVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter applies only to Windows NT/2000
     5542</h3></div></div></div><a class="indexterm" name="id2561921"></a><a name="USECLIENTDRIVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter applies only to Windows NT/2000
    55425543    clients.  It has no effect on Windows 95/98/ME clients.  When
    55435544    serving a printer to Windows NT/2000 clients without first installing
     
    55645565        server.</em></span></p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use client driver</code></em> = <code class="literal">no</code>
    55655566</em></span>
    5566 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562000"></a>
     5567</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562001"></a>
    55675568
    55685569use kerberos keytab (G)
    5569 </h3></div></div></div><a class="indexterm" name="id2562001"></a><a name="USEKERBEROSKEYTAB"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5570</h3></div></div></div><a class="indexterm" name="id2562002"></a><a name="USEKERBEROSKEYTAB"></a><div class="variablelist"><dl><dt></dt><dd><p>
    55705571        Specifies whether Samba should attempt to maintain service principals in the systems
    55715572        keytab file for <code class="constant">host/FQDN</code> and <code class="constant">cifs/FQDN</code>.
     
    55795580        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use kerberos keytab</code></em> = <code class="literal">False</code>
    55805581</em></span>
    5581 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562068"></a>
     5582</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562069"></a>
    55825583
    55835584use mmap (G)
     
    55915592    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use mmap</code></em> = <code class="literal">yes</code>
    55925593</em></span>
    5593 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562120"></a>
     5594</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562121"></a>
    55945595
    55955596username level (G)
     
    56095610</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>username level</code></em> = <code class="literal">5</code>
    56105611</em></span>
    5611 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562202"></a>
     5612</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562203"></a>
    56125613
    56135614username map script (G)
    5614 </h3></div></div></div><a class="indexterm" name="id2562203"></a><a name="USERNAMEMAPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This script is a mutually exclusive alternative to the
     5615</h3></div></div></div><a class="indexterm" name="id2562204"></a><a name="USERNAMEMAPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This script is a mutually exclusive alternative to the
    56155616        <a class="link" href="smb.conf.5.html#USERNAMEMAP" target="_top">username map</a> parameter.  This parameter
    56165617        specifies and external program or script that must accept a single
     
    56235624</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>
    56245625</em></span>
    5625 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562279"></a>
     5626</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562280"></a>
    56265627
    56275628username map (G)
    5628 </h3></div></div></div><a class="indexterm" name="id2562280"></a><a name="USERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5629</h3></div></div></div><a class="indexterm" name="id2562281"></a><a name="USERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    56295630        This option allows you to specify a file containing a mapping of usernames from the clients to the server.
    56305631        This can be used for several purposes. The most common is to map usernames that users use on DOS or Windows
     
    57105711# no username map</code>
    57115712</em></span>
    5712 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562559"></a>
     5713</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562560"></a>
    57135714
    57145715<a name="USER"></a>user
    5715 </h3></div></div></div><a class="indexterm" name="id2562560"></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="id2562591"></a>
     5716</h3></div></div></div><a class="indexterm" name="id2562561"></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="id2562592"></a>
    57165717
    57175718<a name="USERS"></a>users
    5718 </h3></div></div></div><a class="indexterm" name="id2562592"></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="id2562623"></a>
     5719</h3></div></div></div><a class="indexterm" name="id2562593"></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="id2562623"></a>
    57195720
    57205721username (S)
     
    57575758</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>username</code></em> = <code class="literal">fred, mary, jack, jane, @users, @pcgroup</code>
    57585759</em></span>
    5759 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562793"></a>
     5760</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562794"></a>
    57605761
    57615762usershare allow guests (G)
    5762 </h3></div></div></div><a class="indexterm" name="id2562794"></a><a name="USERSHAREALLOWGUESTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether user defined shares are allowed
     5763</h3></div></div></div><a class="indexterm" name="id2562795"></a><a name="USERSHAREALLOWGUESTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether user defined shares are allowed
    57635764        to be accessed by non-authenticated users or not. It is the equivalent
    57645765        of allowing people who can create a share the option of setting
     
    57675768        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>
    57685769</em></span>
    5769 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562845"></a>
     5770</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562846"></a>
    57705771
    57715772usershare max shares (G)
    5772 </h3></div></div></div><a class="indexterm" name="id2562846"></a><a name="USERSHAREMAXSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of user defined shares
     5773</h3></div></div></div><a class="indexterm" name="id2562847"></a><a name="USERSHAREMAXSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of user defined shares
    57735774        that are allowed to be created by users belonging to the group owning the
    57745775        usershare directory. If set to zero (the default) user defined shares are ignored.
    57755776        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare max shares</code></em> = <code class="literal">0</code>
    57765777</em></span>
    5777 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562891"></a>
     5778</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562892"></a>
    57785779
    57795780usershare owner only (G)
    5780 </h3></div></div></div><a class="indexterm" name="id2562892"></a><a name="USERSHAREOWNERONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether the pathname exported by
     5781</h3></div></div></div><a class="indexterm" name="id2562893"></a><a name="USERSHAREOWNERONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether the pathname exported by
    57815782        a user defined shares must be owned by the user creating the
    57825783        user defined share or not. If set to True (the default) then
     
    58305831</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>usershare prefix allow list</code></em> = <code class="literal">/home /data /space</code>
    58315832</em></span>
    5832 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563084"></a>
     5833</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563085"></a>
    58335834
    58345835usershare prefix deny list (G)
    5835 </h3></div></div></div><a class="indexterm" name="id2563085"></a><a name="USERSHAREPREFIXDENYLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
     5836</h3></div></div></div><a class="indexterm" name="id2563086"></a><a name="USERSHAREPREFIXDENYLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
    58365837        the root of which are NOT allowed to be exported by user defined share definitions.
    58375838        If the pathname exported starts with one of the strings in this
     
    58705871
    58715872use sendfile (S)
    5872 </h3></div></div></div><a class="indexterm" name="id2563233"></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>
     5873</h3></div></div></div><a class="indexterm" name="id2563234"></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>
    58735874    system call is supported by the underlying operating system, then some SMB read calls
    58745875    (mainly ReadAndX and ReadRaw) will use the more efficient sendfile system call for files that
     
    58795880    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use sendfile</code></em> = <code class="literal">false</code>
    58805881</em></span>
    5881 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563289"></a>
     5882</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563290"></a>
    58825883
    58835884use spnego (G)
    5884 </h3></div></div></div><a class="indexterm" name="id2563290"></a><a name="USESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p>This variable controls controls whether samba will try
     5885</h3></div></div></div><a class="indexterm" name="id2563291"></a><a name="USESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p>This variable controls controls whether samba will try
    58855886    to use Simple and Protected NEGOciation (as specified by rfc2478) with
    58865887    WindowsXP and Windows2000 clients to agree upon an authentication mechanism.
     
    58905891        disabled.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use spnego</code></em> = <code class="literal">yes</code>
    58915892</em></span>
    5892 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563339"></a>
     5893</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563340"></a>
    58935894
    58945895utmp directory (G)
    5895 </h3></div></div></div><a class="indexterm" name="id2563340"></a><a name="UTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only available if Samba has
     5896</h3></div></div></div><a class="indexterm" name="id2563341"></a><a name="UTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only available if Samba has
    58965897        been configured and compiled with the option <code class="literal">
    58975898        --with-utmp</code>. It specifies a directory pathname that is
     
    59055906</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>utmp directory</code></em> = <code class="literal">/var/run/utmp</code>
    59065907</em></span>
    5907 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563417"></a>
     5908</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563418"></a>
    59085909
    59095910utmp (G)
    5910 </h3></div></div></div><a class="indexterm" name="id2563418"></a><a name="UTMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5911</h3></div></div></div><a class="indexterm" name="id2563419"></a><a name="UTMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    59115912        This boolean parameter is only available if Samba has been configured and compiled 
    59125913        with the option <code class="literal">--with-utmp</code>. If set to
     
    59395940</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>valid users</code></em> = <code class="literal">greg, @pcusers</code>
    59405941</em></span>
    5941 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563571"></a>
     5942</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563572"></a>
    59425943
    59435944-valid (S)
    5944 </h3></div></div></div><a class="indexterm" name="id2563572"></a><a name="-VALID"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter indicates whether a share is
     5945</h3></div></div></div><a class="indexterm" name="id2563573"></a><a name="-VALID"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter indicates whether a share is
    59455946        valid and thus can be used. When this parameter is set to false,
    59465947        the share will be in no way visible nor accessible.
     
    59855986        </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>
    59865987</em></span>
    5987 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563739"></a>
     5988</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563740"></a>
    59885989
    59895990veto oplock files (S)
    5990 </h3></div></div></div><a class="indexterm" name="id2563740"></a><a name="VETOOPLOCKFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5991</h3></div></div></div><a class="indexterm" name="id2563741"></a><a name="VETOOPLOCKFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    59915992        This parameter is only valid when the <a class="link" href="smb.conf.5.html#OPLOCKS" target="_top">oplocks</a>
    59925993        parameter is turned on for a share. It allows the Samba administrator
     
    60096010# No files are vetoed for oplock grants</code>
    60106011</em></span>
    6011 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563832"></a>
     6012</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563833"></a>
    60126013
    60136014<a name="VFSOBJECT"></a>vfs object
    6014 </h3></div></div></div><a class="indexterm" name="id2563834"></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="id2563864"></a>
     6015</h3></div></div></div><a class="indexterm" name="id2563834"></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="id2563865"></a>
    60156016
    60166017vfs objects (S)
     
    60226023</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>vfs objects</code></em> = <code class="literal">extd_audit recycle</code>
    60236024</em></span>
    6024 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563924"></a>
     6025</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563925"></a>
    60256026
    60266027volume (S)
     
    60306031# the name of the share</code>
    60316032</em></span>
    6032 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563968"></a>
     6033</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563969"></a>
    60336034
    60346035wide links (S)
    6035 </h3></div></div></div><a class="indexterm" name="id2563969"></a><a name="WIDELINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not links
     6036</h3></div></div></div><a class="indexterm" name="id2563970"></a><a name="WIDELINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not links
    60366037        in the UNIX file system may be followed by the server. Links
    60376038        that point to areas within the directory tree exported by the
     
    60416042        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>
    60426043</em></span>
    6043 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564020"></a>
     6044</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564021"></a>
    60446045
    60456046winbind cache time (G)
    6046 </h3></div></div></div><a class="indexterm" name="id2564021"></a><a name="WINBINDCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of
     6047</h3></div></div></div><a class="indexterm" name="id2564022"></a><a name="WINBINDCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of
    60476048        seconds the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon will cache
    60486049        user and group information before querying a Windows NT server
     
    60526053        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind cache time</code></em> = <code class="literal">300</code>
    60536054</em></span>
    6054 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564092"></a>
     6055</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564093"></a>
    60556056
    60566057winbind enum groups (G)
    6057 </h3></div></div></div><a class="indexterm" name="id2564093"></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
     6058</h3></div></div></div><a class="indexterm" name="id2564094"></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
    60586059        the enumeration of groups through the <code class="literal">setgrent()</code>,
    60596060        <code class="literal">getgrent()</code> and
     
    60636064        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>
    60646065</em></span>
    6065 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564182"></a>
     6066</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564183"></a>
    60666067
    60676068winbind enum users (G)
     
    60786079        usernames. </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind enum users</code></em> = <code class="literal">no</code>
    60796080</em></span>
    6080 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564276"></a>
     6081</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564277"></a>
    60816082
    60826083winbind expand groups (G)
    6083 </h3></div></div></div><a class="indexterm" name="id2564277"></a><a name="WINBINDEXPANDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum depth that winbindd
     6084</h3></div></div></div><a class="indexterm" name="id2564278"></a><a name="WINBINDEXPANDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum depth that winbindd
    60846085              will traverse when flattening nested group memberships
    60856086              of Windows domain groups.  This is different from the
     
    61046105                 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>
    61056106</em></span>
    6106 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564395"></a>
     6107</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564396"></a>
    61076108
    61086109winbind normalize names (G)
    6109 </h3></div></div></div><a class="indexterm" name="id2564396"></a><a name="WINBINDNORMALIZENAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether winbindd will replace
     6110</h3></div></div></div><a class="indexterm" name="id2564397"></a><a name="WINBINDNORMALIZENAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether winbindd will replace
    61106111        whitespace in user and group names with an underscore (_) character.
    61116112        For example, whether the name "Space Kadet" should be
     
    61446145</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind nss info</code></em> = <code class="literal">template sfu</code>
    61456146</em></span>
    6146 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564580"></a>
     6147</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564581"></a>
    61476148
    61486149winbind offline logon (G)
    6149 </h3></div></div></div><a class="indexterm" name="id2564581"></a><a name="WINBINDOFFLINELOGON"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control whether Winbind should
     6150</h3></div></div></div><a class="indexterm" name="id2564582"></a><a name="WINBINDOFFLINELOGON"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control whether Winbind should
    61506151        allow to login with the <em class="parameter"><code>pam_winbind</code></em>
    61516152        module using Cached Credentials. If enabled, winbindd will store user credentials
     
    61656166</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind refresh tickets</code></em> = <code class="literal">true</code>
    61666167</em></span>
    6167 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564716"></a>
     6168</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564717"></a>
    61686169
    61696170winbind rpc only (G)
    6170 </h3></div></div></div><a class="indexterm" name="id2564717"></a><a name="WINBINDRPCONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6171</h3></div></div></div><a class="indexterm" name="id2564718"></a><a name="WINBINDRPCONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    61716172        Setting this parameter to <code class="literal">yes</code> forces
    61726173        winbindd to use RPC instead of LDAP to retrieve information from Domain
     
    61886189</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind separator</code></em> = <code class="literal">+</code>
    61896190</em></span>
    6190 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564852"></a>
     6191</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564853"></a>
    61916192
    61926193winbind trusted domains only (G)
    6193 </h3></div></div></div><a class="indexterm" name="id2564853"></a><a name="WINBINDTRUSTEDDOMAINSONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6194</h3></div></div></div><a class="indexterm" name="id2564854"></a><a name="WINBINDTRUSTEDDOMAINSONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    61946195        This parameter is designed to allow Samba servers that are members
    61956196        of a Samba controlled domain to use UNIX accounts distributed via NIS,
     
    62036204        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind trusted domains only</code></em> = <code class="literal">no</code>
    62046205</em></span>
    6205 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564931"></a>
     6206</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564932"></a>
    62066207
    62076208winbind use default domain (G)
    6208 </h3></div></div></div><a class="indexterm" name="id2564932"></a><a name="WINBINDUSEDEFAULTDOMAIN"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether the
     6209</h3></div></div></div><a class="indexterm" name="id2564933"></a><a name="WINBINDUSEDEFAULTDOMAIN"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether the
    62096210         <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon should operate on users 
    62106211        without domain component in their username. Users without a domain
     
    62406241                        empty then the name should be deleted.</p></li></ul></div><p>An example script that calls the BIND dynamic DNS update
    62416242        program <code class="literal">nsupdate</code> is provided in the examples
    6242         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="id2565110"></a>
     6243        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="id2565111"></a>
    62436244
    62446245wins proxy (G)
    6245 </h3></div></div></div><a class="indexterm" name="id2565111"></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
     6246</h3></div></div></div><a class="indexterm" name="id2565112"></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
    62466247        queries on behalf of  other hosts. You may need to set this
    62476248        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>
    62486249</em></span>
    6249 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565165"></a>
     6250</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565166"></a>
    62506251
    62516252wins server (G)
    6252 </h3></div></div></div><a class="indexterm" name="id2565166"></a><a name="WINSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the IP address (or DNS name: IP
     6253</h3></div></div></div><a class="indexterm" name="id2565167"></a><a name="WINSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the IP address (or DNS name: IP
    62536254        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
    62546255        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
     
    62696270</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>
    62706271</em></span>
    6271 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565275"></a>
     6272</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565276"></a>
    62726273
    62736274wins support (G)
    6274 </h3></div></div></div><a class="indexterm" name="id2565276"></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
     6275</h3></div></div></div><a class="indexterm" name="id2565277"></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
    62756276        not set this to <code class="constant">yes</code> unless you have a multi-subnetted network and
    62766277        you wish a particular <code class="literal">nmbd</code> to be your WINS server.
     
    62896290</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>workgroup</code></em> = <code class="literal">MYGROUP</code>
    62906291</em></span>
    6291 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565417"></a>
     6292</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565418"></a>
    62926293
    62936294<a name="WRITABLE"></a>writable
    6294 </h3></div></div></div><a class="indexterm" name="id2565418"></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="id2565449"></a>
     6295</h3></div></div></div><a class="indexterm" name="id2565419"></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="id2565449"></a>
    62956296
    62966297writeable (S)
     
    63186319#  for a 256k cache size per file</code>
    63196320</em></span>
    6320 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565583"></a>
     6321</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565584"></a>
    63216322
    63226323write list (S)
    6323 </h3></div></div></div><a class="indexterm" name="id2565584"></a><a name="WRITELIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6324</h3></div></div></div><a class="indexterm" name="id2565585"></a><a name="WRITELIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
    63246325    This is a list of users that are given read-write access to a service. If the
    63256326    connecting user is in this list then they will be given write access, no matter
     
    63366337</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>write list</code></em> = <code class="literal">admin, root, @staff</code>
    63376338</em></span>
    6338 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565676"></a>
     6339</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565677"></a>
    63396340
    63406341write raw (G)
     
    63436344    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>
    63446345</em></span>
    6345 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565720"></a>
     6346</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565721"></a>
    63466347
    63476348wtmp directory (G)
    6348 </h3></div></div></div><a class="indexterm" name="id2565721"></a><a name="WTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6349</h3></div></div></div><a class="indexterm" name="id2565722"></a><a name="WTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    63496350        This parameter is only available if Samba has been configured and compiled with the option <code class="literal">
    63506351        --with-utmp</code>. It specifies a directory pathname that is used to store the wtmp or wtmpx files (depending on
     
    63586359</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>wtmp directory</code></em> = <code class="literal">/var/log/wtmp</code>
    63596360</em></span>
    6360 </p></dd></dl></div></div></div></div><div class="refsect1" lang="en"><a name="id2565804"></a><h2>WARNINGS</h2><p>
     6361</p></dd></dl></div></div></div></div><div class="refsect1" lang="en"><a name="id2565805"></a><h2>WARNINGS</h2><p>
    63616362        Although the configuration file permits service names to contain spaces, your client software may not.
    63626363        Spaces will be ignored in comparisons anyway, so it shouldn't be a problem - but be aware of the possibility.
     
    63716372        care when designing these sections. In particular, ensure that the permissions on spool directories are
    63726373        correct.
    6373         </p></div><div class="refsect1" lang="en"><a name="id2565854"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2565865"></a><h2>SEE ALSO</h2><p>
    6374         <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="id2565944"></a><h2>AUTHOR</h2><p>
     6374        </p></div><div class="refsect1" lang="en"><a name="id2565855"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2565866"></a><h2>SEE ALSO</h2><p>
     6375        <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="id2565945"></a><h2>AUTHOR</h2><p>
    63756376        The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed
    63766377        by the Samba Team as an Open Source project similar to the way the Linux kernel is developed.
Note: See TracChangeset for help on using the changeset viewer.