---
name: "samusrgrp"
section: "8"
platform: "linux"
package: "chntpw"
version: "140201-1.2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/samusrgrp"
---

# samusrgrp(8)

add or remove users from groups in SAM database files

## 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).