Ignore:
Timestamp:
May 24, 2009, 7:55:48 AM (16 years ago)
Author:
Herwig Bauernfeind
Message:

Update Samba 3.3 branch to 3.3.4

File:
1 edited

Legend:

Unmodified
Added
Removed
  • branches/samba-3.3.x/docs/htmldocs/manpages/net.8.html

    r218 r224  
    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="id2483410"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The Samba net utility is meant to work just like the net utility
     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="id2483554"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
     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="id2481566"></a><h2>COMMANDS</h2><div class="refsect2" lang="en"><a name="id2481572"></a><h3>CHANGESECRETPW</h3><p>This command allows the Samba machine account password to be set from an external application
     60in the <code class="filename">smb.conf</code> file.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481585"></a><h2>COMMANDS</h2><div class="refsect2" lang="en"><a name="id2481591"></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="id2481593"></a><h3>TIME</h3><p>The <code class="literal">NET TIME</code> command allows you to view the time on a remote server
    65         or synchronise the time on the local server with the time on the remote server.</p><div class="refsect3" lang="en"><a name="id2481610"></a><h4>TIME</h4><p>Without any options, the <code class="literal">NET TIME</code> command
     67</p></div><div class="refsect2" lang="en"><a name="id2481612"></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="id2481629"></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="id2481626"></a><h4>TIME SYSTEM</h4><p>Displays the time on the remote server in a format ready for <code class="literal">/bin/date</code>.</p></div><div class="refsect3" lang="en"><a name="id2481643"></a><h4>TIME SET</h4><p>Tries to set the date and time of the local server to that on
    68 the remote server using <code class="literal">/bin/date</code>. </p></div><div class="refsect3" lang="en"><a name="id2481661"></a><h4>TIME ZONE</h4><p>Displays the timezone in hours from GMT on the remote computer.</p></div></div><div class="refsect2" lang="en"><a name="id2481673"></a><h3>[RPC|ADS] JOIN [TYPE] [-U username[%password]] [createupn=UPN] [createcomputer=OU] [options]</h3><p>
     70</p></div><div class="refsect3" lang="en"><a name="id2481645"></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="id2481662"></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="id2481680"></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="id2481692"></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="id2481707"></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="id2481726"></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="id2481720"></a><h3>[RPC|ADS] USER</h3><div class="refsect3" lang="en"><a name="id2481726"></a><h4>[RPC|ADS] USER</h4><p>List all users</p></div><div class="refsect3" lang="en"><a name="id2481736"></a><h4>[RPC|ADS] USER DELETE <em class="replaceable"><code>target</code></em></h4><p>Delete specified user</p></div><div class="refsect3" lang="en"><a name="id2481748"></a><h4>[RPC|ADS] USER INFO <em class="replaceable"><code>target</code></em></h4><p>List the domain groups of the specified user.</p></div><div class="refsect3" lang="en"><a name="id2481761"></a><h4>[RPC|ADS] USER RENAME <em class="replaceable"><code>oldname</code></em> <em class="replaceable"><code>newname</code></em></h4><p>Rename specified user.</p></div><div class="refsect3" lang="en"><a name="id2481776"></a><h4>[RPC|ADS] USER ADD <em class="replaceable"><code>name</code></em> [password] [-F user flags] [-C comment]</h4><p>Add specified user.</p></div></div><div class="refsect2" lang="en"><a name="id2481791"></a><h3>[RPC|ADS] GROUP</h3><div class="refsect3" lang="en"><a name="id2481797"></a><h4>[RPC|ADS] GROUP [misc options] [targets]</h4><p>List user groups.</p></div><div class="refsect3" lang="en"><a name="id2481808"></a><h4>[RPC|ADS] GROUP DELETE <em class="replaceable"><code>name</code></em> [misc. options]</h4><p>Delete specified group.</p></div><div class="refsect3" lang="en"><a name="id2481821"></a><h4>[RPC|ADS] GROUP ADD <em class="replaceable"><code>name</code></em> [-C comment]</h4><p>Create specified group.</p></div></div><div class="refsect2" lang="en"><a name="id2481836"></a><h3>[RAP|RPC] SHARE</h3><div class="refsect3" lang="en"><a name="id2481842"></a><h4>[RAP|RPC] SHARE [misc. options] [targets]</h4><p>Enumerates all exported resources (network shares) on target server.</p></div><div class="refsect3" lang="en"><a name="id2481853"></a><h4>[RAP|RPC] SHARE ADD <em class="replaceable"><code>name=serverpath</code></em> [-C comment] [-M maxusers] [targets]</h4><p>Adds a share from a server (makes the export active). Maxusers
     90account in server manager first.</p></div><div class="refsect2" lang="en"><a name="id2481739"></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="id2481755"></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="id2481767"></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="id2481780"></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="id2481795"></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="id2481810"></a><h3>[RPC|ADS] GROUP</h3><div class="refsect3" lang="en"><a name="id2481816"></a><h4>[RPC|ADS] GROUP [misc options] [targets]</h4><p>List user groups.</p></div><div class="refsect3" lang="en"><a name="id2481827"></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="id2481840"></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="id2481855"></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="id2481872"></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="id2481870"></a><h4>SHARE DELETE <em class="replaceable"><code>sharename</code></em></h4><p>Delete specified share.</p></div></div><div class="refsect2" lang="en"><a name="id2481883"></a><h3>[RPC|RAP] FILE</h3><div class="refsect3" lang="en"><a name="id2481889"></a><h4>[RPC|RAP] FILE</h4><p>List all open files on remote server.</p></div><div class="refsect3" lang="en"><a name="id2481900"></a><h4>[RPC|RAP] FILE CLOSE <em class="replaceable"><code>fileid</code></em></h4><p>Close file with specified <em class="replaceable"><code>fileid</code></em> on
    90 remote server.</p></div><div class="refsect3" lang="en"><a name="id2481916"></a><h4>[RPC|RAP] FILE INFO <em class="replaceable"><code>fileid</code></em></h4><p>
     92share simultaneously.</p></div><div class="refsect3" lang="en"><a name="id2481889"></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="id2481902"></a><h3>[RPC|RAP] FILE</h3><div class="refsect3" lang="en"><a name="id2481908"></a><h4>[RPC|RAP] FILE</h4><p>List all open files on remote server.</p></div><div class="refsect3" lang="en"><a name="id2481919"></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="id2481935"></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="id2481932"></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="id2481951"></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="id2481956"></a><h3>SESSION</h3><div class="refsect3" lang="en"><a name="id2481962"></a><h4>RAP SESSION</h4><p>Without any other options, SESSION enumerates all active SMB/CIFS
    98 sessions on the target server.</p></div><div class="refsect3" lang="en"><a name="id2481973"></a><h4>RAP SESSION DELETE|CLOSE <em class="replaceable"><code>CLIENT_NAME</code></em></h4><p>Close the specified sessions.</p></div><div class="refsect3" lang="en"><a name="id2481985"></a><h4>RAP SESSION INFO <em class="replaceable"><code>CLIENT_NAME</code></em></h4><p>Give a list with all the open files in specified session.</p></div></div><div class="refsect2" lang="en"><a name="id2482000"></a><h3>RAP SERVER <em class="replaceable"><code>DOMAIN</code></em></h3><p>List all servers in specified domain or workgroup. Defaults
    99 to local domain.</p></div><div class="refsect2" lang="en"><a name="id2482014"></a><h3>RAP DOMAIN</h3><p>Lists all domains and workgroups visible on the
    100 current network.</p></div><div class="refsect2" lang="en"><a name="id2482025"></a><h3>RAP PRINTQ</h3><div class="refsect3" lang="en"><a name="id2482030"></a><h4>RAP PRINTQ INFO <em class="replaceable"><code>QUEUE_NAME</code></em></h4><p>Lists the specified print queue and print jobs on the server.
     100</p></div></div><div class="refsect2" lang="en"><a name="id2481975"></a><h3>SESSION</h3><div class="refsect3" lang="en"><a name="id2481981"></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="id2481992"></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="id2482004"></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="id2482019"></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="id2482044"></a><h3>RAP PRINTQ</h3><div class="refsect3" lang="en"><a name="id2482049"></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="id2482048"></a><h4>RAP PRINTQ DELETE <em class="replaceable"><code>JOBID</code></em></h4><p>Delete job with specified id.</p></div></div><div class="refsect2" lang="en"><a name="id2532525"></a><h3>RAP VALIDATE <em class="replaceable"><code>user</code></em> [<em class="replaceable"><code>password</code></em>]</h3><p>
     105queues are listed.</p></div><div class="refsect3" lang="en"><a name="id2532530"></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="id2532543"></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="id2532548"></a><h3>RAP GROUPMEMBER</h3><div class="refsect3" lang="en"><a name="id2532553"></a><h4>RAP GROUPMEMBER LIST <em class="replaceable"><code>GROUP</code></em></h4><p>List all members of the specified group.</p></div><div class="refsect3" lang="en"><a name="id2532566"></a><h4>RAP GROUPMEMBER DELETE <em class="replaceable"><code>GROUP</code></em> <em class="replaceable"><code>USER</code></em></h4><p>Delete member from group.</p></div><div class="refsect3" lang="en"><a name="id2532581"></a><h4>RAP GROUPMEMBER ADD <em class="replaceable"><code>GROUP</code></em> <em class="replaceable"><code>USER</code></em></h4><p>Add member to group.</p></div></div><div class="refsect2" lang="en"><a name="id2532597"></a><h3>RAP ADMIN <em class="replaceable"><code>command</code></em></h3><p>Execute the specified <em class="replaceable"><code>command</code></em> on
     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="id2532566"></a><h3>RAP GROUPMEMBER</h3><div class="refsect3" lang="en"><a name="id2532571"></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="id2532584"></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="id2532599"></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="id2532615"></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="id2532617"></a><h3>RAP SERVICE</h3><div class="refsect3" lang="en"><a name="id2532622"></a><h4>RAP SERVICE START <em class="replaceable"><code>NAME</code></em> [arguments...]</h4><p>Start the specified service on the remote server. Not implemented yet.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div><div class="refsect3" lang="en"><a name="id2532641"></a><h4>RAP SERVICE STOP</h4><p>Stop the specified service on the remote server.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Currently NOT implemented.</p></div></div></div><div class="refsect2" lang="en"><a name="id2532657"></a><h3>RAP PASSWORD <em class="replaceable"><code>USER</code></em> <em class="replaceable"><code>OLDPASS</code></em> <em class="replaceable"><code>NEWPASS</code></em></h3><p>
     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="id2532635"></a><h3>RAP SERVICE</h3><div class="refsect3" lang="en"><a name="id2532640"></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="id2532659"></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="id2532675"></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="id2532684"></a><h3>LOOKUP</h3><div class="refsect3" lang="en"><a name="id2532690"></a><h4>LOOKUP HOST <em class="replaceable"><code>HOSTNAME</code></em> [<em class="replaceable"><code>TYPE</code></em>]</h4><p>
     113</p></div><div class="refsect2" lang="en"><a name="id2532702"></a><h3>LOOKUP</h3><div class="refsect3" lang="en"><a name="id2532708"></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="id2532708"></a><h4>LOOKUP LDAP [<em class="replaceable"><code>DOMAIN</code></em>]</h4><p>Give IP address of LDAP server of specified <em class="replaceable"><code>DOMAIN</code></em>. Defaults to local domain.</p></div><div class="refsect3" lang="en"><a name="id2532725"></a><h4>LOOKUP KDC [<em class="replaceable"><code>REALM</code></em>]</h4><p>Give IP address of KDC for the specified <em class="replaceable"><code>REALM</code></em>.
    114 Defaults to local realm.</p></div><div class="refsect3" lang="en"><a name="id2532742"></a><h4>LOOKUP DC [<em class="replaceable"><code>DOMAIN</code></em>]</h4><p>Give IP's of Domain Controllers for specified <em class="replaceable"><code>
    115 DOMAIN</code></em>. Defaults to local domain.</p></div><div class="refsect3" lang="en"><a name="id2532759"></a><h4>LOOKUP MASTER <em class="replaceable"><code>DOMAIN</code></em></h4><p>Give IP of master browser for specified <em class="replaceable"><code>DOMAIN</code></em>
    116 or workgroup. Defaults to local domain.</p></div></div><div class="refsect2" lang="en"><a name="id2532776"></a><h3>CACHE</h3><p>Samba uses a general caching interface called 'gencache'. It
     116</p></div><div class="refsect3" lang="en"><a name="id2532726"></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="id2532743"></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="id2532760"></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="id2532777"></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="id2532794"></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="id2532812"></a><h4>CACHE ADD <em class="replaceable"><code>key</code></em> <em class="replaceable"><code>data</code></em> <em class="replaceable"><code>time-out</code></em></h4><p>Add specified key+data to the cache with the given timeout.</p></div><div class="refsect3" lang="en"><a name="id2532831"></a><h4>CACHE DEL <em class="replaceable"><code>key</code></em></h4><p>Delete key from the cache.</p></div><div class="refsect3" lang="en"><a name="id2532843"></a><h4>CACHE SET <em class="replaceable"><code>key</code></em> <em class="replaceable"><code>data</code></em> <em class="replaceable"><code>time-out</code></em></h4><p>Update data of existing cache entry.</p></div><div class="refsect3" lang="en"><a name="id2532862"></a><h4>CACHE SEARCH <em class="replaceable"><code>PATTERN</code></em></h4><p>Search for the specified pattern in the cache data.</p></div><div class="refsect3" lang="en"><a name="id2532874"></a><h4>CACHE LIST</h4><p>
     124</p><div class="refsect3" lang="en"><a name="id2532830"></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="id2532849"></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="id2532861"></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="id2532880"></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="id2532892"></a><h4>CACHE LIST</h4><p>
    122125List all current items in the cache.
    123 </p></div><div class="refsect3" lang="en"><a name="id2532885"></a><h4>CACHE FLUSH</h4><p>Remove all the current items from the cache.</p></div></div><div class="refsect2" lang="en"><a name="id2532896"></a><h3>GETLOCALSID [DOMAIN]</h3><p>Prints the SID of the specified domain, or if the parameter is
    124 omitted, the SID of the local server.</p></div><div class="refsect2" lang="en"><a name="id2532908"></a><h3>SETLOCALSID S-1-5-21-x-y-z</h3><p>Sets SID for the local server to the specified SID.</p></div><div class="refsect2" lang="en"><a name="id2532918"></a><h3>GETDOMAINSID</h3><p>Prints the local machine SID and the SID of the current
    125 domain.</p></div><div class="refsect2" lang="en"><a name="id2532929"></a><h3>SETDOMAINSID</h3><p>Sets the SID of the current domain.</p></div><div class="refsect2" lang="en"><a name="id2532939"></a><h3>GROUPMAP</h3><p>Manage the mappings between Windows group SIDs and UNIX groups.
     126</p></div><div class="refsect3" lang="en"><a name="id2532903"></a><h4>CACHE FLUSH</h4><p>Remove all the current items from the cache.</p></div></div><div class="refsect2" lang="en"><a name="id2532914"></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="id2532926"></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="id2532936"></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="id2532947"></a><h3>SETDOMAINSID</h3><p>Sets the SID of the current domain.</p></div><div class="refsect2" lang="en"><a name="id2532957"></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="id2532982"></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="id2533000"></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="id2532999"></a><h4>GROUPMAP DELETE</h4><p>Delete a group mapping entry. If more than one group name matches, the first entry found is deleted.</p><p>net groupmap delete {ntgroup=string|sid=SID}</p></div><div class="refsect3" lang="en"><a name="id2533014"></a><h4>GROUPMAP MODIFY</h4><p>Update en existing group entry.</p><p>
     137</p></div><div class="refsect3" lang="en"><a name="id2533017"></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="id2533032"></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="id2533034"></a><h4>GROUPMAP LIST</h4><p>List existing group mapping entries.</p><p>net groupmap list [verbose] [ntgroup=string] [sid=SID]</p></div></div><div class="refsect2" lang="en"><a name="id2533050"></a><h3>MAXRID</h3><p>Prints out the highest RID currently in use on the local
     142</p></div><div class="refsect3" lang="en"><a name="id2533052"></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="id2533068"></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="id2533061"></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="id2533080"></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="id2533073"></a><h3>[RPC|ADS] TESTJOIN</h3><p>Check whether participation in a domain is still valid.</p></div><div class="refsect2" lang="en"><a name="id2533084"></a><h3>[RPC|ADS] CHANGETRUSTPW</h3><p>Force change of domain trust password.</p></div><div class="refsect2" lang="en"><a name="id2533094"></a><h3>RPC TRUSTDOM</h3><div class="refsect3" lang="en"><a name="id2533100"></a><h4>RPC TRUSTDOM ADD <em class="replaceable"><code>DOMAIN</code></em></h4><p>Add a interdomain trust account for <em class="replaceable"><code>DOMAIN</code></em>.
     146</p></div><div class="refsect2" lang="en"><a name="id2533091"></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="id2533102"></a><h3>[RPC|ADS] CHANGETRUSTPW</h3><p>Force change of domain trust password.</p></div><div class="refsect2" lang="en"><a name="id2533112"></a><h3>RPC TRUSTDOM</h3><div class="refsect3" lang="en"><a name="id2533118"></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="id2533131"></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="id2533149"></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="id2533153"></a><h4>RPC TRUSTDOM ESTABLISH <em class="replaceable"><code>DOMAIN</code></em></h4><p>
     155</p></div><div class="refsect3" lang="en"><a name="id2533171"></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="id2533167"></a><h4>RPC TRUSTDOM REVOKE <em class="replaceable"><code>DOMAIN</code></em></h4><p>Abandon relationship to trusted domain</p></div><div class="refsect3" lang="en"><a name="id2533179"></a><h4>RPC TRUSTDOM LIST</h4><p>List all current interdomain trust relationships.</p></div><div class="refsect3" lang="en"><a name="id2533190"></a><h4>RPC RIGHTS</h4><p>This subcommand is used to view and manage Samba's rights assignments (also
     158</p></div><div class="refsect3" lang="en"><a name="id2533185"></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="id2533197"></a><h4>RPC TRUSTDOM LIST</h4><p>List all current interdomain trust relationships.</p></div><div class="refsect3" lang="en"><a name="id2533208"></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="id2533220"></a><h3>RPC ABORTSHUTDOWN</h3><p>Abort the shutdown of a remote server.</p></div><div class="refsect2" lang="en"><a name="id2533231"></a><h3>RPC SHUTDOWN [-t timeout] [-r] [-f] [-C message]</h3><p>Shut down the remote server.</p><div class="variablelist"><dl><dt><span class="term">-r</span></dt><dd><p>
     162can be found in the Samba-HOWTO-Collection.</p></div></div><div class="refsect2" lang="en"><a name="id2533239"></a><h3>RPC ABORTSHUTDOWN</h3><p>Abort the shutdown of a remote server.</p></div><div class="refsect2" lang="en"><a name="id2533249"></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="id2533292"></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="id2533303"></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="id2533310"></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="id2533321"></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="id2533316"></a><h3>RPC VAMPIRE KEYTAB</h3><p>Dump remote SAM database to local Kerberos keytab file.
    171 </p></div><div class="refsect2" lang="en"><a name="id2533326"></a><h3>RPC VAMPIRE LDIF</h3><p>Dump remote SAM database to local LDIF file or standard output.
    172 </p></div><div class="refsect2" lang="en"><a name="id2533337"></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="id2533353"></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="id2533363"></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="id2533334"></a><h3>RPC VAMPIRE KEYTAB</h3><p>Dump remote SAM database to local Kerberos keytab file.
     174</p></div><div class="refsect2" lang="en"><a name="id2533344"></a><h3>RPC VAMPIRE LDIF</h3><p>Dump remote SAM database to local LDIF file or standard output.
     175</p></div><div class="refsect2" lang="en"><a name="id2533355"></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="id2533371"></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="id2533381"></a><h3>ADS STATUS</h3><p>Print out status of machine account of the local machine in ADS.
    173176Prints out quite some debug info. Aimed at developers, regular
    174 users should use <code class="literal">NET ADS TESTJOIN</code>.</p></div><div class="refsect2" lang="en"><a name="id2533381"></a><h3>ADS PRINTER</h3><div class="refsect3" lang="en"><a name="id2533386"></a><h4>ADS PRINTER INFO [<em class="replaceable"><code>PRINTER</code></em>] [<em class="replaceable"><code>SERVER</code></em>]</h4><p>
     177users should use <code class="literal">NET ADS TESTJOIN</code>.</p></div><div class="refsect2" lang="en"><a name="id2533399"></a><h3>ADS PRINTER</h3><div class="refsect3" lang="en"><a name="id2533404"></a><h4>ADS PRINTER INFO [<em class="replaceable"><code>PRINTER</code></em>] [<em class="replaceable"><code>SERVER</code></em>]</h4><p>
    175178Lookup info for <em class="replaceable"><code>PRINTER</code></em> on <em class="replaceable"><code>SERVER</code></em>. The printer name defaults to "*", the
    176 server name defaults to the local host.</p></div><div class="refsect3" lang="en"><a name="id2533410"></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="id2533422"></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="id2533436"></a><h3>ADS SEARCH <em class="replaceable"><code>EXPRESSION</code></em> <em class="replaceable"><code>ATTRIBUTES...</code></em></h3><p>Perform a raw LDAP search on a ADS server and dump the results. The
     179server name defaults to the local host.</p></div><div class="refsect3" lang="en"><a name="id2533428"></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="id2533440"></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="id2533454"></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
    177180expression is a standard LDAP search expression, and the
    178181attributes 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>
    179 </p></div><div class="refsect2" lang="en"><a name="id2533464"></a><h3>ADS DN <em class="replaceable"><code>DN</code></em> <em class="replaceable"><code>(attributes)</code></em></h3><p>
     182</p></div><div class="refsect2" lang="en"><a name="id2533482"></a><h3>ADS DN <em class="replaceable"><code>DN</code></em> <em class="replaceable"><code>(attributes)</code></em></h3><p>
    180183Perform a raw LDAP search on a ADS server and dump the results. The
    181184DN standard LDAP DN, and the attributes are a list of LDAP fields
    182185to show in the result.
    183 </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="id2533490"></a><h3>ADS WORKGROUP</h3><p>Print out workgroup name for specified kerberos realm.</p></div><div class="refsect2" lang="en"><a name="id2533501"></a><h3>SAM CREATEBUILTINGROUP &lt;NAME&gt;</h3><p>
     186</p><p>Example: <strong class="userinput"><code>net ads dn 'CN=administrator,CN=Users,DC=my,DC=domain' SAMAccountName</code></strong></p></div><div class="refsect2" lang="en"><a name="id2533508"></a><h3>ADS WORKGROUP</h3><p>Print out workgroup name for specified kerberos realm.</p></div><div class="refsect2" lang="en"><a name="id2533519"></a><h3>SAM CREATEBUILTINGROUP &lt;NAME&gt;</h3><p>
    184187(Re)Create a BUILTIN group.
    185188Only a wellknown set of BUILTIN groups can be created with this command.
     
    191194This command requires a running Winbindd with idmap allocation properly
    192195configured. The group gid will be allocated out of the winbindd range.
    193 </p></div><div class="refsect2" lang="en"><a name="id2533519"></a><h3>SAM CREATELOCALGROUP &lt;NAME&gt;</h3><p>
     196</p></div><div class="refsect2" lang="en"><a name="id2533538"></a><h3>SAM CREATELOCALGROUP &lt;NAME&gt;</h3><p>
    194197Create a LOCAL group (also known as Alias).
    195198
    196199This command requires a running Winbindd with idmap allocation properly
    197200configured. The group gid will be allocated out of the winbindd range.
    198 </p></div><div class="refsect2" lang="en"><a name="id2533533"></a><h3>SAM DELETELOCALGROUP &lt;NAME&gt;</h3><p>
     201</p></div><div class="refsect2" lang="en"><a name="id2533551"></a><h3>SAM DELETELOCALGROUP &lt;NAME&gt;</h3><p>
    199202Delete an existing LOCAL group (also known as Alias).
    200203
    201 </p></div><div class="refsect2" lang="en"><a name="id2533545"></a><h3>SAM MAPUNIXGROUP &lt;NAME&gt;</h3><p>
     204</p></div><div class="refsect2" lang="en"><a name="id2533563"></a><h3>SAM MAPUNIXGROUP &lt;NAME&gt;</h3><p>
    202205Map an existing Unix group and make it a Domain Group, the domain group
    203206will have the same name.
    204 </p></div><div class="refsect2" lang="en"><a name="id2533557"></a><h3>SAM UNMAPUNIXGROUP &lt;NAME&gt;</h3><p>
     207</p></div><div class="refsect2" lang="en"><a name="id2533575"></a><h3>SAM UNMAPUNIXGROUP &lt;NAME&gt;</h3><p>
    205208Remove an existing group mapping entry.
    206 </p></div><div class="refsect2" lang="en"><a name="id2533568"></a><h3>SAM ADDMEM &lt;GROUP&gt; &lt;MEMBER&gt;</h3><p>
     209</p></div><div class="refsect2" lang="en"><a name="id2533586"></a><h3>SAM ADDMEM &lt;GROUP&gt; &lt;MEMBER&gt;</h3><p>
    207210Add a member to a Local group. The group can be specified only by name,
    208211the member can be specified by name or SID.
    209 </p></div><div class="refsect2" lang="en"><a name="id2533581"></a><h3>SAM DELMEM  &lt;GROUP&gt; &lt;MEMBER&gt;</h3><p>
     212</p></div><div class="refsect2" lang="en"><a name="id2533599"></a><h3>SAM DELMEM  &lt;GROUP&gt; &lt;MEMBER&gt;</h3><p>
    210213Remove a member from a Local group. The group and the member must be
    211214specified by name.
    212 </p></div><div class="refsect2" lang="en"><a name="id2533593"></a><h3>SAM LISTMEM &lt;GROUP&gt;</h3><p>
     215</p></div><div class="refsect2" lang="en"><a name="id2533612"></a><h3>SAM LISTMEM &lt;GROUP&gt;</h3><p>
    213216List Local group members. The group must be specified by name.
    214 </p></div><div class="refsect2" lang="en"><a name="id2533604"></a><h3>SAM LIST &lt;users|groups|localgroups|builtin|workstations&gt; [verbose]</h3><p>
     217</p></div><div class="refsect2" lang="en"><a name="id2533622"></a><h3>SAM LIST &lt;users|groups|localgroups|builtin|workstations&gt; [verbose]</h3><p>
    215218List the specified set of accounts by name. If verbose is specified,
    216219the rid and description is also provided for each account.
    217 </p></div><div class="refsect2" lang="en"><a name="id2533618"></a><h3>SAM SHOW &lt;NAME&gt;</h3><p>
     220</p></div><div class="refsect2" lang="en"><a name="id2533637"></a><h3>SAM SHOW &lt;NAME&gt;</h3><p>
    218221Show the full DOMAIN\\NAME the SID and the type for the corresponding
    219222account.
    220 </p></div><div class="refsect2" lang="en"><a name="id2533630"></a><h3>SAM SET HOMEDIR &lt;NAME&gt; &lt;DIRECTORY&gt;</h3><p>
     223</p></div><div class="refsect2" lang="en"><a name="id2533648"></a><h3>SAM SET HOMEDIR &lt;NAME&gt; &lt;DIRECTORY&gt;</h3><p>
    221224Set the home directory for a user account.
    222 </p></div><div class="refsect2" lang="en"><a name="id2533640"></a><h3>SAM SET PROFILEPATH &lt;NAME&gt; &lt;PATH&gt;</h3><p>
     225</p></div><div class="refsect2" lang="en"><a name="id2533658"></a><h3>SAM SET PROFILEPATH &lt;NAME&gt; &lt;PATH&gt;</h3><p>
    223226Set the profile path for a user account.
    224 </p></div><div class="refsect2" lang="en"><a name="id2533651"></a><h3>SAM SET COMMENT &lt;NAME&gt; &lt;COMMENT&gt;</h3><p>
     227</p></div><div class="refsect2" lang="en"><a name="id2533669"></a><h3>SAM SET COMMENT &lt;NAME&gt; &lt;COMMENT&gt;</h3><p>
    225228Set the comment for a user or group account.
    226 </p></div><div class="refsect2" lang="en"><a name="id2533662"></a><h3>SAM SET FULLNAME &lt;NAME&gt; &lt;FULL NAME&gt;</h3><p>
     229</p></div><div class="refsect2" lang="en"><a name="id2533680"></a><h3>SAM SET FULLNAME &lt;NAME&gt; &lt;FULL NAME&gt;</h3><p>
    227230Set the full name for a user account.
    228 </p></div><div class="refsect2" lang="en"><a name="id2533673"></a><h3>SAM SET LOGONSCRIPT &lt;NAME&gt; &lt;SCRIPT&gt;</h3><p>
     231</p></div><div class="refsect2" lang="en"><a name="id2533691"></a><h3>SAM SET LOGONSCRIPT &lt;NAME&gt; &lt;SCRIPT&gt;</h3><p>
    229232Set the logon script for a user account.
    230 </p></div><div class="refsect2" lang="en"><a name="id2533684"></a><h3>SAM SET HOMEDRIVE &lt;NAME&gt; &lt;DRIVE&gt;</h3><p>
     233</p></div><div class="refsect2" lang="en"><a name="id2533702"></a><h3>SAM SET HOMEDRIVE &lt;NAME&gt; &lt;DRIVE&gt;</h3><p>
    231234Set the home drive for a user account.
    232 </p></div><div class="refsect2" lang="en"><a name="id2533695"></a><h3>SAM SET WORKSTATIONS &lt;NAME&gt; &lt;WORKSTATIONS&gt;</h3><p>
     235</p></div><div class="refsect2" lang="en"><a name="id2533714"></a><h3>SAM SET WORKSTATIONS &lt;NAME&gt; &lt;WORKSTATIONS&gt;</h3><p>
    233236Set the workstations a user account is allowed to log in from.
    234 </p></div><div class="refsect2" lang="en"><a name="id2533707"></a><h3>SAM SET DISABLE &lt;NAME&gt;</h3><p>
     237</p></div><div class="refsect2" lang="en"><a name="id2533725"></a><h3>SAM SET DISABLE &lt;NAME&gt;</h3><p>
    235238Set the "disabled" flag for a user account.
    236 </p></div><div class="refsect2" lang="en"><a name="id2533718"></a><h3>SAM SET PWNOTREQ &lt;NAME&gt;</h3><p>
     239</p></div><div class="refsect2" lang="en"><a name="id2533736"></a><h3>SAM SET PWNOTREQ &lt;NAME&gt;</h3><p>
    237240Set the "password not required" flag for a user account.
    238 </p></div><div class="refsect2" lang="en"><a name="id2533729"></a><h3>SAM SET AUTOLOCK &lt;NAME&gt;</h3><p>
     241</p></div><div class="refsect2" lang="en"><a name="id2533747"></a><h3>SAM SET AUTOLOCK &lt;NAME&gt;</h3><p>
    239242Set the "autolock" flag for a user account.
    240 </p></div><div class="refsect2" lang="en"><a name="id2533740"></a><h3>SAM SET PWNOEXP &lt;NAME&gt;</h3><p>
     243</p></div><div class="refsect2" lang="en"><a name="id2533759"></a><h3>SAM SET PWNOEXP &lt;NAME&gt;</h3><p>
    241244Set the "password do not expire" flag for a user account.
    242 </p></div><div class="refsect2" lang="en"><a name="id2533751"></a><h3>SAM SET PWDMUSTCHANGENOW &lt;NAME&gt; [yes|no]</h3><p>
     245</p></div><div class="refsect2" lang="en"><a name="id2533770"></a><h3>SAM SET PWDMUSTCHANGENOW &lt;NAME&gt; [yes|no]</h3><p>
    243246Set or unset the "password must change" flag for a user account.
    244 </p></div><div class="refsect2" lang="en"><a name="id2533763"></a><h3>SAM POLICY LIST</h3><p>
     247</p></div><div class="refsect2" lang="en"><a name="id2533782"></a><h3>SAM POLICY LIST</h3><p>
    245248List the available account policies.
    246 </p></div><div class="refsect2" lang="en"><a name="id2533773"></a><h3>SAM POLICY SHOW &lt;account policy&gt;</h3><p>
     249</p></div><div class="refsect2" lang="en"><a name="id2533792"></a><h3>SAM POLICY SHOW &lt;account policy&gt;</h3><p>
    247250Show the account policy value.
    248 </p></div><div class="refsect2" lang="en"><a name="id2533784"></a><h3>SAM POLICY SET &lt;account policy&gt; &lt;value&gt;</h3><p>
     251</p></div><div class="refsect2" lang="en"><a name="id2533803"></a><h3>SAM POLICY SET &lt;account policy&gt; &lt;value&gt;</h3><p>
    249252Set a value for the account policy.
    250253Valid values can be: "forever", "never", "off", or a number.
    251 </p></div><div class="refsect2" lang="en"><a name="id2533797"></a><h3>SAM PROVISION</h3><p>
     254</p></div><div class="refsect2" lang="en"><a name="id2533816"></a><h3>SAM PROVISION</h3><p>
    252255Only available if ldapsam:editposix is set and winbindd is running.
    253256Properly populates the ldap tree with the basic accounts (Administrator)
    254257and groups (Domain Users, Domain Admins, Domain Guests) on the ldap tree.
    255 </p></div><div class="refsect2" lang="en"><a name="id2533810"></a><h3>IDMAP DUMP &lt;local tdb file name&gt;</h3><p>
     258</p></div><div class="refsect2" lang="en"><a name="id2533829"></a><h3>IDMAP DUMP &lt;local tdb file name&gt;</h3><p>
    256259Dumps the mappings contained in the local tdb file specified.
    257260This command is useful to dump only the mappings produced by the idmap_tdb backend.
    258 </p></div><div class="refsect2" lang="en"><a name="id2533824"></a><h3>IDMAP RESTORE [input file]</h3><p>
     261</p></div><div class="refsect2" lang="en"><a name="id2533843"></a><h3>IDMAP RESTORE [input file]</h3><p>
    259262Restore the mappings from the specified file or stdin.
    260 </p></div><div class="refsect2" lang="en"><a name="id2533835"></a><h3>IDMAP SECRET &lt;DOMAIN&gt;|ALLOC &lt;secret&gt;</h3><p>
     263</p></div><div class="refsect2" lang="en"><a name="id2533854"></a><h3>IDMAP SECRET &lt;DOMAIN&gt;|ALLOC &lt;secret&gt;</h3><p>
    261264Store a secret for the specified domain, used primarily for domains
    262265that use idmap_ldap as a backend. In this case the secret is used
    263266as the password for the user DN used to bind to the ldap server.
    264 </p></div><div class="refsect2" lang="en"><a name="id2533849"></a><h3>USERSHARE</h3><p>Starting with version 3.0.23, a Samba server now supports the ability for
     267</p></div><div class="refsect2" lang="en"><a name="id2533868"></a><h3>USERSHARE</h3><p>Starting with version 3.0.23, a Samba server now supports the ability for
    265268non-root users to add user defined shares to be exported using the "net usershare"
    266269commands.
     
    291294</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>
    292295
    293 </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>
     296</p><div class="refsect3" lang="en"><a name="id2533940"></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>
    294297Add or replace a new user defined share, with name "sharename".
    295298</p><p>
     
    328331at connect time so will see the change immediately, there is no need
    329332to restart smbd on adding, deleting or changing a user defined share.
    330 </div><div class="refsect3" lang="en"><a name="id2481451"></a><h4>USERSHARE DELETE <em class="replaceable"><code>sharename</code></em></h4><p>
     333</div><div class="refsect3" lang="en"><a name="id2534013"></a><h4>USERSHARE DELETE <em class="replaceable"><code>sharename</code></em></h4><p>
    331334Deletes the user defined share by name. The Samba smbd daemon
    332335immediately notices this change, although it will not disconnect
    333336any users currently connected to the deleted share.
    334 </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>
     337</p></div><div class="refsect3" lang="en"><a name="id2534028"></a><h4>USERSHARE INFO <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>[wildcard sharename]</code></em></h4><p>
    335338Get info on user defined shares owned by the current user matching the given pattern, or all users.
    336339</p><p>
     
    351354And is a list of the current settings of the user defined share that can be
    352355modified by the "net usershare add" command.
    353 </p></div><div class="refsect3" lang="en"><a name="id2534168"></a><h4>USERSHARE LIST <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>wildcard sharename</code></em></h4><p>
     356</p></div><div class="refsect3" lang="en"><a name="id2534061"></a><h4>USERSHARE LIST <em class="replaceable"><code>[-l|--long]</code></em> <em class="replaceable"><code>wildcard sharename</code></em></h4><p>
    354357List all the user defined shares owned by the current user matching the given pattern, or all users.
    355358</p><p>
     
    359362If the '-l' or '--long' option is also given, it includes the names of user defined
    360363shares created by other users.
    361 </p></div></div><div class="refsect2" lang="en"><a name="id2534195"></a><h3>CONF</h3><p>Starting with version 3.2.0, a Samba server can be configured by data
     364</p></div></div><div class="refsect2" lang="en"><a name="id2534089"></a><h3>CONF</h3><p>Starting with version 3.2.0, a Samba server can be configured by data
    362365stored in registry. This configuration data can be edited with the new "net
    363366conf" commands.
     
    377380format.</td></tr><tr><td>net conf listshares - List the registry shares.</td></tr><tr><td>net conf drop - Delete the complete configuration from
    378381registry.</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>
    379 </p><div class="refsect3" lang="en"><a name="id2534316"></a><h4>CONF LIST</h4><p>
     382</p><div class="refsect3" lang="en"><a name="id2534209"></a><h4>CONF LIST</h4><p>
    380383Print the configuration data stored in the registry in a smb.conf-like format to
    381384standard output.
    382 </p></div><div class="refsect3" lang="en"><a name="id2534327"></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>
     385</p></div><div class="refsect3" lang="en"><a name="id2534221"></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>
    383386This command imports configuration from a file in smb.conf format.
    384387If a section encountered in the input file is present in registry,
     
    390393the parameter "-T" on the commandline. In test mode, no changes are made to the
    391394registry, and the resulting configuration is printed to standard output instead.
    392 </p></div><div class="refsect3" lang="en"><a name="id2534357"></a><h4>CONF LISTSHARES</h4><p>
     395</p></div><div class="refsect3" lang="en"><a name="id2534250"></a><h4>CONF LISTSHARES</h4><p>
    393396List the names of the shares defined in registry.
    394 </p></div><div class="refsect3" lang="en"><a name="id2534367"></a><h4>CONF DROP</h4><p>
     397</p></div><div class="refsect3" lang="en"><a name="id2534261"></a><h4>CONF DROP</h4><p>
    395398Delete the complete configuration data from registry.
    396 </p></div><div class="refsect3" lang="en"><a name="id2534378"></a><h4>CONF SHOWSHARE <em class="replaceable"><code>sharename</code></em></h4><p>
     399</p></div><div class="refsect3" lang="en"><a name="id2534271"></a><h4>CONF SHOWSHARE <em class="replaceable"><code>sharename</code></em></h4><p>
    397400Show the definition of the share or section specified. It is valid to specify
    398401"global" as sharename to retrieve the global configuration options from
    399402registry.
    400 </p></div><div class="refsect3" lang="en"><a name="id2534392"></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.
     403</p></div><div class="refsect3" lang="en"><a name="id2534286"></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.
    401404The sharename and path have to be given. The share name may
    402405<span class="emphasis"><em>not</em></span> be "global". Optionally, values for the very
     
    404407The same result may be obtained by a sequence of "net conf setparm"
    405408commands.
    406 </p></div><div class="refsect3" lang="en"><a name="id2534426"></a><h4>CONF DELSHARE <em class="replaceable"><code>sharename</code></em></h4><p>
     409</p></div><div class="refsect3" lang="en"><a name="id2534320"></a><h4>CONF DELSHARE <em class="replaceable"><code>sharename</code></em></h4><p>
    407410Delete a share definition from registry.
    408 </p></div><div class="refsect3" lang="en"><a name="id2534439"></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>
     411</p></div><div class="refsect3" lang="en"><a name="id2534333"></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>
    409412Store a parameter in registry. The section may be global or a sharename.
    410413The section is created if it does not exist yet.
    411 </p></div><div class="refsect3" lang="en"><a name="id2534459"></a><h4>CONF GETPARM <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="id2534353"></a><h4>CONF GETPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em></h4><p>
    412415Show a parameter stored in registry.
    413 </p></div><div class="refsect3" lang="en"><a name="id2534475"></a><h4>CONF DELPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em></h4><p>
     416</p></div><div class="refsect3" lang="en"><a name="id2534369"></a><h4>CONF DELPARM <em class="replaceable"><code>section</code></em> <em class="replaceable"><code>parameter</code></em></h4><p>
    414417Delete a parameter stored in registry.
    415 </p></div><div class="refsect3" lang="en"><a name="id2534491"></a><h4>CONF GETINCLUDES <em class="replaceable"><code>section</code></em></h4><p>
     418</p></div><div class="refsect3" lang="en"><a name="id2534384"></a><h4>CONF GETINCLUDES <em class="replaceable"><code>section</code></em></h4><p>
    416419Get the list of includes for the provided section (global or share).
    417420</p><p>
     
    429432configuration. In the future, there will be the ability to include configuration
    430433data from other registry keys.
    431 </p></div><div class="refsect3" lang="en"><a name="id2534526"></a><h4>CONF SETINCLUDES <em class="replaceable"><code>section</code></em> [<em class="replaceable"><code>filename</code></em>]+</h4><p>
     434</p></div><div class="refsect3" lang="en"><a name="id2534419"></a><h4>CONF SETINCLUDES <em class="replaceable"><code>section</code></em> [<em class="replaceable"><code>filename</code></em>]+</h4><p>
    432435Set the list of includes for the provided section (global or share) to the given
    433436list of one or more filenames. The filenames may contain the usual smb.conf
    434437macros like %I.
    435 </p></div><div class="refsect3" lang="en"><a name="id2534545"></a><h4>CONF DELINCLUDES <em class="replaceable"><code>section</code></em></h4><p>
     438</p></div><div class="refsect3" lang="en"><a name="id2534438"></a><h4>CONF DELINCLUDES <em class="replaceable"><code>section</code></em></h4><p>
    436439Delete the list of includes from the provided section (global or share).
    437 </p></div></div><div class="refsect2" lang="en"><a name="id2534559"></a><h3>HELP [COMMAND]</h3><p>Gives usage information for the specified command.</p></div></div><div class="refsect1" lang="en"><a name="id2534570"></a><h2>VERSION</h2><p>This man page is complete for version 3 of the Samba
    438         suite.</p></div><div class="refsect1" lang="en"><a name="id2534581"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     440</p></div></div><div class="refsect2" lang="en"><a name="id2534452"></a><h3>HELP [COMMAND]</h3><p>Gives usage information for the specified command.</p></div></div><div class="refsect1" lang="en"><a name="id2534464"></a><h2>VERSION</h2><p>This man page is complete for version 3 of the Samba
     441        suite.</p></div><div class="refsect1" lang="en"><a name="id2534475"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    439442        were created by Andrew Tridgell. Samba is now developed
    440443        by the Samba Team as an Open Source project similar
Note: See TracChangeset for help on using the changeset viewer.