USERDEL(8) System Management Commands USERDEL(8)

userdel - löscht ein Benutzerkonto und die dazugehörigen Dateien

ÜBERSICHT

userdel [options] LOGIN

The userdel command modifies the system account files, deleting all entries that refer to the user name LOGIN. The named user must exist.

The options which apply to the userdel command are:

-f, --force

This option forces the removal of the user account and any other requested actions, skipping any safety checks.

Note: This option is dangerous and may leave your system in an inconsistent state.

-h, --help

zeigt die Hilfe an und beendet das Programm.

-r, --remove

entfernt das persönliche Verzeichnis des Benutzers mit den darin enthaltenen Dateiein und die Mail-Warteschlange. Dateien in anderen Dateisystemen müssen per Hand gesucht und gelöscht werden.

The mail spool is defined by the MAIL_DIR variable in the login.defs file.

-R, --root CHROOT_DIR

Apply changes in the CHROOT_DIR directory and use the configuration files from the CHROOT_DIR directory. Only absolute paths are supported. No SELINUX support.

-P, --prefix PREFIX_DIR

Apply changes in the PREFIX_DIR directory and use the configuration files from the PREFIX_DIR directory. This option does not chroot and is intended for preparing a cross-compilation target. Some limitations: NIS and LDAP users/groups are not verified. PAM authentication is using the host files. No SELINUX support.

-Z, --selinux-user

entfernt jegliche Zuordnung zu SELinux-Benutzern für das Benutzerkonto.

The following configuration variables in /etc/login.defs change the behavior of this tool:

MAIL_DIR (string)

The mail spool directory. This is needed to manipulate the mailbox when its corresponding user account is modified or deleted. If not specified, a compile-time default is used. The parameter CREATE_MAIL_SPOOL in /etc/default/useradd determines whether the mail spool should be created.

MAIL_FILE (string)

legt fest, wo sich die Dateien der Mail-Warteschlange des Benutzers relativ zu seinem persönlichen Verzeichnis befinden.

The MAIL_DIR and MAIL_FILE variables are used by useradd, usermod, and userdel to create, move, or delete the user's mail spool.

MAX_MEMBERS_PER_GROUP (number)

Maximum members per group entry. When the maximum is reached, a new group entry (line) is started in /etc/group (with the same name, same password, and same GID).

Der Standardwert ist 0, was bedeutet, dass die Anzahl der Mitglieder einer Gruppe nicht begrenzt ist.

Das Aufteilen von Gruppen ermöglicht es, Längenvorgaben für die Zeilen der Gruppendatei einzuhalten. Damit kann sichergestellt werden, dass die Zeilen für NIS-Gruppen nicht länger als 1024 Zeichen sind.

Falls Sie eine solche Begrenzung benötigen, können Sie 25 verwenden.

Hinweis: Mit aufgeteilten Gruppen können möglicherweise nicht alle Hilfsprogramme (nicht einmal jene der Shadow-Programmsammlung) umgehen. Sie sollten diese Variable nur setzen, wenn Sie sie wirklich benötigen.

USERDEL_CMD (string)

falls angegeben, wird dieser Befehl ausgeführt, wenn ein Benutzer entfernt wird. Damit können At-, Cron- und Druckaufträge etc. des Benutzers (sein Name ist als erstes Argument zu übergeben) gelöscht werden.

Der Rückgabewert des Skripts bleibt unberücksichtigt.

Here is an example script, which removes the user's cron, at and print jobs:

#! /bin/sh
# Check for the required argument.
if [ $# != 1 ]; then
	echo "Usage: $0 username"
	exit 1
fi
# Remove cron jobs.
crontab -r -u $1
# Remove at jobs.
# Note that it will remove any jobs owned by the same UID,
# even if it was shared by a different username.
AT_SPOOL_DIR=/var/spool/cron/atjobs
find $AT_SPOOL_DIR -name "[^.]*" -type f -user $1 -delete \;
# Remove print jobs.
lprm $1
# All done.
exit 0

USERGROUPS_ENAB (boolean)

If set to yes, userdel will remove the user's group if it contains no more members, and useradd will create by default a group with the name of the user.

/etc/group

Informationen zu den Gruppenkonten

/etc/login.defs

konfiguriert die Shadow-Hilfsprogramme.

/etc/passwd

Informationen zu den Benutzerkonten

/etc/shadow

geschützte Informationen zu den Benutzerkonten

/etc/shadow-maint/userdel-pre.d/*, /etc/shadow-maint/userdel-post.d/*

Run-part files to execute during user deletion. The environment variable ACTION will be populated with userdel and SUBJECT with the username. userdel-pre.d will be executed prior to any user deletion. userdel-post.d will execute after user deletion. If a script exits non-zero then execution will terminate.

/etc/subgid

enthält untergeordnete Gruppenkennungen der einzelnen Benutzer.

/etc/subuid

enthält untergeordnete Benutzerkennungen der einzelnen Benutzer.

The userdel command exits with the following values:

0

success

1

can't update password file

2

invalid command syntax

6

specified user doesn't exist

8

user currently logged in

10

can't update group file

12

can't remove home directory

userdel will not allow you to remove an account if there are running processes which belong to this account. In that case, you may have to kill those processes or lock the user's password or account and remove the account later. The -f option can force the deletion of this account.

Sie sollten von Hand alle Dateisysteme in Hinblick auf Dateien dieses Benutzers prüfen und sie gegebenenfalls löschen.

Sie dürfen keine NIS-Attribute auf einem NIS-Client löschen. Dies muss auf dem NIS-Server durchgeführt werden.

If USERGROUPS_ENAB is defined to yes in /etc/login.defs, userdel will delete the group with the same name as the user. To avoid inconsistencies in the passwd and group databases, userdel will check that this group is not used as a primary group for another user, and will just warn without deleting the group otherwise. The -f option can force the deletion of this group.

chfn(1), chsh(1), passwd(1), login.defs(5), gpasswd(8), groupadd(8), groupdel(8), groupmod(8), subgid(5), subuid(5), useradd(8), usermod(8).

30.07.2026 shadow-utils 4.20.0