docs: mention new --no-dns-updates parameter in manpage of net.
[obnox/samba/samba-obnox.git] / docs-xml / manpages / net.8.xml
index 6fba00ba4c92df883b4183125c9c3a9008612e8b..f459bf46503ae7cc500b384bc0f7eecc3b03c8e9 100644 (file)
@@ -7,7 +7,7 @@
        <manvolnum>8</manvolnum>
        <refmiscinfo class="source">Samba</refmiscinfo>
        <refmiscinfo class="manual">System Administration tools</refmiscinfo>
-       <refmiscinfo class="version">4.1</refmiscinfo>
+       <refmiscinfo class="version">4.3</refmiscinfo>
 </refmeta>
 
 
                </para></listitem>
                </varlistentry>
 
+               <varlistentry>
+               <term>-T|--test</term>
+               <listitem><para>Only test command sequence, dry-run.
+               </para></listitem>
+               </varlistentry>
+
+               <varlistentry>
+               <term>-F|--flags FLAGS</term>
+               <listitem><para>Pass down integer flags to a net subcommand.
+               </para></listitem>
+               </varlistentry>
+
+               <varlistentry>
+               <term>-C|--comment COMMENT</term>
+               <listitem><para>Pass down a comment string to a net subcommand.
+               </para></listitem>
+               </varlistentry>
+
+               <varlistentry>
+               <term>-n|--myname MYNAME</term>
+               <listitem><para>Use MYNAME as a requester name for a net subcommand.
+               </para></listitem>
+               </varlistentry>
+
+               <varlistentry>
+               <term>-c|--container CONTAINER</term>
+               <listitem><para>Use a specific AD container for net ads operations.
+               </para></listitem>
+               </varlistentry>
+
+               <varlistentry>
+               <term>-M|--maxusers MAXUSERS</term>
+               <listitem><para>Fill in the maxusers field in net rpc share operations.
+               </para></listitem>
+               </varlistentry>
+
+               <varlistentry>
+               <term>-r|--reboot</term>
+               <listitem><para>Reboot a remote machine after a command has been successfully executed (e.g. in remote join operations).
+               </para></listitem>
+               </varlistentry>
+
                <!-- Options for net rpc vampire -->
 
                <varlistentry>
                </para></listitem>
                </varlistentry>
 
+               <!-- Options for net groupmap set -->
+
+               <varlistentry>
+               <term>-L|--local</term>
+               <listitem><para>Sets the type of group mapping to local
+                               (used in "net groupmap set").
+               </para></listitem>
+               </varlistentry>
+
+               <varlistentry>
+               <term>-D|--domain</term>
+               <listitem><para>Sets the type of group mapping to domain
+                               (used in "net groupmap set").
+               </para></listitem>
+               </varlistentry>
+
+               <varlistentry>
+               <term>-N|--ntname NTNAME</term>
+               <listitem><para>Sets the ntname of a group mapping
+                               (used in "net groupmap set").
+               </para></listitem>
+               </varlistentry>
+
+               <varlistentry>
+               <term>-R|--rid RID</term>
+               <listitem><para>Sets the rid of a group mapping
+                               (used in "net groupmap set").
+               </para></listitem>
+               </varlistentry>
+
+               <!-- Options for net registry check -->
+
+               <varlistentry>
+               <term>--reg-version REG_VERSION</term>
+               <listitem><para>Assume database version {n|1,2,3}
+                               (used in "net registry check").
+               </para></listitem>
+               </varlistentry>
+
+               <varlistentry>
+               <term>-o|--output FILENAME</term>
+               <listitem><para>Output database file
+                               (used in "net registry check").
+               </para></listitem>
+               </varlistentry>
+
+               <varlistentry>
+               <term>--wipe</term>
+               <listitem><para>Create a new database from scratch
+                               (used in "net registry check").
+               </para></listitem>
+               </varlistentry>
+
+               <!-- Options for net registry import -->
+
+               <varlistentry>
+               <term>--precheck PRECHECK_DB_FILENAME</term>
+               <listitem><para>Defines filename for database prechecking
+                               (used in "net registry import").
+               </para></listitem>
+               </varlistentry>
+
+               <varlistentry>
+               <term>--no-dns-updates</term>
+               <listitem><para>Do not perform DNS updates as part of
+               "net ads join".
+               </para></listitem>
+               </varlistentry>
+
                &stdarg.encrypt;
                &popt.common.samba.client;
 
@@ -300,7 +411,8 @@ YOU HAVE BEEN WARNED.
 <title>TIME</title>
 
 <para>Without any options, the <command>NET TIME</command> command 
-displays the time on the remote server.
+displays the time on the remote server. The remote server must be
+specified with the -S option.
 </para>
 
 </refsect3>
@@ -308,28 +420,35 @@ displays the time on the remote server.
 <refsect3>
 <title>TIME SYSTEM</title>
 
-<para>Displays the time on the remote server in a format ready for <command>/bin/date</command>.</para>
+<para>Displays the time on the remote server in a format ready for <command>/bin/date</command>.
+The remote server must be specified with the -S option.
+</para>
 
 </refsect3>
 
 <refsect3>
 <title>TIME SET</title>
 <para>Tries to set the date and time of the local server to that on 
-the remote server using <command>/bin/date</command>. </para>
+the remote server using <command>/bin/date</command>.
+The remote server must be specified with the -S option.
+</para>
 
 </refsect3>
 
 <refsect3>
 <title>TIME ZONE</title>
 
-<para>Displays the timezone in hours from GMT on the remote computer.</para>
+<para>Displays the timezone in hours from GMT on the remote server.
+The remote server must be specified with the -S option.
+</para>
 
 </refsect3>
 </refsect2>
 
 <refsect2>
-<title>[RPC|ADS] JOIN [TYPE] [-U username[%password]] [createupn=UPN]
-[createcomputer=OU] [machinepass=PASS] [osName=string osVer=string] [options]</title>
+<title>[RPC|ADS] JOIN [TYPE] [--no-dns-updates] [-U username[%password]]
+[createupn=UPN] [createcomputer=OU] [machinepass=PASS]
+[osName=string osVer=string] [options]</title>
 
 <para>
 Join a domain.  If the account already exists on the server, and 
@@ -1125,6 +1244,8 @@ to run this against the PDC, from a Samba machine joined as a BDC. </para>
 
 <para>Export users, aliases and groups from remote server to 
 local server.  You need to run this against the PDC, from a Samba machine joined as a BDC. 
+This vampire command cannot be used against an Active Directory, only
+against an NT4 Domain Controller.
 </para>
 </refsect2>
 
@@ -1145,7 +1266,7 @@ local server.  You need to run this against the PDC, from a Samba machine joined
 <refsect2>
 <title>RPC GETSID</title>
 
-<para>Fetch domain SID and store it in the local <filename>secrets.tdb</filename> (or <filename>secrets.ntdb</filename>). </para>
+<para>Fetch domain SID and store it in the local <filename>secrets.tdb</filename>. </para>
 
 </refsect2>
 
@@ -1225,6 +1346,59 @@ to show in the result.
 
 </refsect2>
 
+<refsect2>
+       <title>ADS ENCTYPES</title>
+
+<para>
+       List, modify or delete the value of the "msDS-SupportedEncryptionTypes" attribute of an account in AD.
+</para>
+
+<para>
+       This attribute allows to control which Kerberos encryption types are used for the generation of initial and service tickets. The value consists of an integer bitmask with the following values:
+</para>
+
+<para>0x00000001 DES-CBC-CRC</para>
+<para>0x00000002 DES-CBC-MD5</para>
+<para>0x00000004 RC4-HMAC</para>
+<para>0x00000008 AES128-CTS-HMAC-SHA1-96</para>
+<para>0x00000010 AES256-CTS-HMAC-SHA1-96</para>
+
+</refsect2>
+
+<refsect2>
+       <title>ADS ENCTYPES LIST <replaceable>&lt;ACCOUNTNAME&gt;</replaceable></title>
+
+<para>
+       List the value of the "msDS-SupportedEncryptionTypes" attribute of a given account.
+</para>
+
+<para>Example: <userinput>net ads enctypes list Computername</userinput></para>
+
+</refsect2>
+
+<refsect2>
+       <title>ADS ENCTYPES SET <replaceable>&lt;ACCOUNTNAME&gt;</replaceable> <replaceable>[enctypes]</replaceable></title>
+
+<para>
+       Set the value of the "msDS-SupportedEncryptionTypes" attribute of the LDAP object of ACCOUNTNAME to a given value. If the value is ommitted, the value is set to 31 which enables all the currently supported encryption types.
+</para>
+
+<para>Example: <userinput>net ads enctypes set Computername 24</userinput></para>
+
+</refsect2>
+
+<refsect2>
+       <title>ADS ENCTYPES DELETE <replaceable>&lt;ACCOUNTNAME&gt;</replaceable></title>
+
+<para>
+       Deletes the "msDS-SupportedEncryptionTypes" attribute of the LDAP object of ACCOUNTNAME.
+</para>
+
+<para>Example: <userinput>net ads enctypes set Computername 24</userinput></para>
+
+</refsect2>
+
+
 <refsect2>
 <title>SAM CREATEBUILTINGROUP &lt;NAME&gt;</title>