.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH SAMUNLOCK 8  "6th December 2017"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
samunlock \- unlock users in the SAM user database
.SH SYNOPSIS
.B samunlock
.RI [ options ]
.RI -u user
.RI < samfile > 
.br
.SH DESCRIPTION
This manual page documents briefly the
.B samunlock
command.

.PP
.B samunlock
is a non-interactive command line utility that can unlock a user
and/or the user's account bits from the SAM user database file of a
Microsoft Windows system (Windows NT, 2000, XP, Vista, 7, 8.1, etc.).
This file is usually located at
\\WINDOWS\\system32\\config\\SAM on the file system of a Microsoft Windows 
Operating System

On success, the program does not output any informatin and the exit code is 0.

.SH OPTIONS
.TP
.B \-h
Show summary of options.
.TP
.B \-U
Unlock the user.
.TP
.B \-a
Unlock all the users. If this option is used there is no need to specify the next option.
.TP
.B \-u <user>
User to unlock. The user value can be provided as a username, or a RID number in
hexadecimal (if the username is preceded with '0x'). Usernames including
international characters will probably not work.
.TP
.B \-l
Lists the users in the SAM database.
.TP
.B \-H
Output human readable output. The program by default will print a parsable table unless
this option is used.
.TP
.B \-N
Do not allocate more information, only allow the editing of existing values with same size.
.TP
.B \-E
Do not expand the hive file (safe mode).
.TP
.B \-t
Print debug information of allocated blocks.
.TP
.B \-v
Print verbose information and debug messages.

.SH EXAMPLES
.TP
.B samunlock -U -u theboss
Unlock an user named 'theboss', if found.

.TP
.B samunlock -U -u 0x3ea
Unlock an user with RID '0x3a'.

.SH KNOWN BUGS

If the username includes international (non-ASCII) characters the program
will not (usually) find it. Use the RID number instead.

.SH SEE ALSO
.B chntpwd, reged, samusrgrp
.br
You will find  more information available on how this program works, in the
text files
.IR /usr/share/doc/chntpw/README.txt
and
.IR /usr/share/doc/chntpw/MANUAL.txt

More documentation is available at the non upstream's author site:
.BR https://github.com/rescatux/chntpw

.SH AUTHOR
This program was written by Adrian Gibanel Lopez.

This manual page was written by Adrian Gibanel Lopez <adrian15sgd@gmail.com>,
for the Debian GNU/Linux system (but may be used by others).