docs: Update doc to use absolute path for 'dedicated keytab file'
[sfrench/samba-autobuild/.git] / docs-xml / manpages / pdbedit.8.xml
index 413e0e4c41e283a53c18205f05f13da7a1c09b49..6e168ef32e21d76cd0f7dfcdc519355fcddbf112 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.3</refmiscinfo>
+       <refmiscinfo class="version">4.6</refmiscinfo>
 </refmeta>
 
 
@@ -43,6 +43,7 @@
                <arg choice="opt">-r</arg>
                <arg choice="opt">-s configfile</arg>
                <arg choice="opt">-S script</arg>
+               <arg choice="opt">--set-nt-hash</arg>
                <arg choice="opt">-t</arg>
                <arg choice="opt">--time-format</arg>
                <arg choice="opt">-u username</arg>
@@ -99,7 +100,8 @@ samba:45:Test User
                <term>-v|--verbose</term>
                <listitem><para>This option enables the verbose listing format.
                It causes pdbedit to list the users in the database, printing
-               out the account fields in a descriptive format.</para>
+               out the account fields in a descriptive format. Used together
+               with -w also shows passwords hashes.</para>
 
                <para>Example: <command>pdbedit -L -v</command></para>
                <para><programlisting>
@@ -134,7 +136,9 @@ Profile Path:   \\BERSERKER\profile
                out the account fields in a format compatible with the
                <filename>smbpasswd</filename> file format. (see the
                <citerefentry><refentrytitle>smbpasswd</refentrytitle>
-               <manvolnum>5</manvolnum></citerefentry> for details)</para>
+               <manvolnum>5</manvolnum></citerefentry> for details).
+               Instead used together with (-v) displays the passwords
+               hashes in verbose output.</para>
 
                <para>Example: <command>pdbedit -L -w</command></para>
                <programlisting>
@@ -204,6 +208,18 @@ samba:45:0F2B255F7B67A7A9AAD3B435B51404EE:
                </varlistentry>
                
                
+               <varlistentry>
+               <term>--set-nt-hash</term>
+               <listitem><para>This option can be used while modifying
+               a user account. It will set the user's password using
+               the nt-hash value given as hexadecimal string.
+               Useful to synchronize passwords.</para>
+       
+               <para>Example: <command>--set-nt-hash 8846F7EAEE8FB117AD06BDD830B7586C</command>
+               </para>
+               </listitem>
+               </varlistentry>
+
                <varlistentry>
                <term>-p|--profile profile</term>
                <listitem><para>This option can be used while adding or