SAMUSRGRP(8)

📦 version 140201, in debian bookworm, debian trixie, fedora 43, fedora 44, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ SAMUSRGRP ✨

okay bestie, sit down, hydrate, and let me tell you about samusrgrp — it lives in section 8 of the System Manager's Manual and it's here to 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 page is a lil quick-and-dirty rundown of the samusrgrp command, no cap. It got written for the Debian distribution specifically because the original program straight up doesn't have a manual page of its own. 🙈

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.). That file is usually hanging out at \WINDOWS\system32\config\SAM on the file system of a Microsoft Windows Operating System. 👑

When it slays, it's silent: on success, the program does not output any information and the exit code is 0. No notes, no drama, just done. ✨

The binary program supports multiple names, which is very main character of it. If it's called under the name samusrtogrp it will assume -a mode (add user). If it's called under the name samusrfromgrp it will assume -r mode (remove user). 🦋

💅 OPTIONS 💅

  • -h — show summary of options. the vibe check, basically. 👀
  • -a — the user is added to the group. This option has to be followed by -u and -g. like, mandatory besties, you can't run it alone. 🫶
  • -r — the user is removed from the group. This option has to be followed by -u and -g. same deal, it needs its duo. 💔
  • -u <user> — user to change. You can hand over the user value as a username, or as 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'. that's the only way, periodt. 💀
  • -l — lists the groups in the SAM database. 📋
  • -L — lists the groups in the SAM database as well as their members. the deluxe version, we love a bonus feature. 🌟
  • -s — print the machine SID. 🖨️
  • -H — output human readable output. By default the program will print a parsable table unless this option is used. so if the default table is giving robot, this is your girl. 🤖➡️🧚
  • -N — do not allocate more information, only allow the editing of existing values with same size. lowkey restrictive on purpose. 🔒
  • -E — do not expand the hive file (safe mode). it's giving cautious queen energy, and honestly? valid. 🛡️
  • -t — print debug information of allocated blocks. 🧠
  • -v — print verbose information and debug messages. the yapper option, respectfully. 🗣️

🌈 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. fr fr, just use the RID. 🙏

🔍 SEE ALSO 🔍

chntpwd, reged, sampasswd — the whole friend group. 🫂

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

okay that's the whole page bestie, go forth and edit your SAM files responsibly 💖 and if you were wondering, this lil love letter to samusrgrp is dated 6th August 2014, and it comes to you from the System Manager's Manual, section 8. mwah, slay, bye 💅✨🎀

📦 where this page comes from