NAME

       samusrgrp - add or remove users from groups in SAM database files

SYNOPSIS

       samusrgrp [options] <samfile>

DESCRIPTION

       This  manual  page  documents briefly the samusrgrp command.  This manual page was written
       for the Debian distribution because the original program does not have a manual page.

       samusrgrp is a non-interactive command line utility that can add or remove a user  from  a
       local  group  that  exists in the SAM user database 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.

       The  binary  program  supports  multiple  names. If it is called named samusrtogrp it will
       assume -a mode (add user). If it is called named samusrfromgrp  it  will  assume  -r  mode
       (remove user).

OPTIONS

       -h     Show summary of options.

       -a     The user is added to the group.  This option has to be followed by -u and -g .

       -r     The user is removed from the group.  This option has to be followed by -u and -g .

       -u <user>
              User  to  change.  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.

       -g <group>
              Group  to  change.  The  group can only be given as a group number, in hexadecimal,
              preceded with with '0x'.

       -l     Lists the groups in the SAM database.

       -L     Lists the groups in the SAM database as well as their members.

       -s     Print the machine SID.

       -H     Output human readable output. The program by default will print  a  parsable  table
              unless this option is used.

       -N     Do  not  allocate  more information, only allow the editing of existing values with
              same size.

       -E     Do not expand the hive file (safe mode).

       -t     Print debug information of allocated blocks.

       -v     Print verbose information and debug messages.

EXAMPLES

       samusrgrp -a -u theboss -g 0x220 SAMFILE
              Adds a user named 'theboss' to the group 0x220 (Administrators)

       samusrgrp -a -u 0x3ea -g 0x221 SAMFILE
              Adds a user with the id '0x3aa' to the group 0x221 (Users)

       samusrgrp -r -u 0x3ff -g 0x221 SAMFILE
              Remove a user with the id '0x3ff' from the group 0x221 (Users)

KNOWN BUGS

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

SEE ALSO

       chntpwd, reged, sampasswd
       You  will  find   more  information available on how this program works, in the text files
       /usr/share/doc/chntpw/README.txt and /usr/share/doc/chntpw/MANUAL.txt

       More    documentation    is    available    at     the     upstream's     author     site:
       http://pogostick.net/~pnh/ntpasswd/

AUTHOR

       This program was written by Petter N Hagen.

       This manual page was written by Javier Fernandez-Sanguino <jfs@debian.org>, for the Debian
       GNU/Linux system (but may be used by others).

                                         6th August 2014                             SAMUSRGRP(8)