Comando userdel: opções, exclusão do diretório home com -r e erros ao excluir contas no Linux

Ambiente de testeFamília RHELAlmaLinux 9.8shadow-utils 4.9conta rootDebian 12 conta comum
Usuários · gruposuserdelLocalização/usr/sbin/userdel

O comando userdel exclui uma conta de usuário no Linux. Ao excluir contas diretamente em um servidor AlmaLinux 9.8 e comparar também as configurações de um servidor Debian 12, viu-se que excluir sem opções deixa o diretório home e o spool de e-mail para trás, e que é preciso acrescentar -r para excluí-los juntos.

A saída abaixo foi obtida em um servidor AlmaLinux 9.8 com a conta root e em um servidor Debian 12 com uma conta comum. Os nomes das contas e os números de processo são valores de exemplo.

1️⃣ Como usar o comando userdel

A forma básica é [userdel opções nome_da_conta]. Como ele modifica os arquivos de informações das contas, é executado com a conta root ou com sudo.

userdel user1

Segundo o manual oficial, o userdel exclui de /etc/passwd, /etc/shadow e /etc/group todas as entradas que contêm esse nome de conta. O nome da conta também sai das listas de membros de outros grupos.

Segundo a tabela de códigos de saída do manual oficial, o código é 0 em caso de sucesso, 6 quando a conta não existe e 8 quando a conta está conectada. A conta excluída é verificada com id; ao consultar no servidor AlmaLinux o nome de conta inexistente user1, o comando terminou como abaixo.

id user1
id: 'user1': no such user

Ao consultar o mesmo nome com getent passwd, nenhuma linha apareceu e o comando terminou com o código de saída 2. Para verificar em um script se uma conta foi excluída, use esse código de saída.

2️⃣ Opções do userdel

A lista de opções é exibida com userdel --help. O shadow-utils 4.9 do servidor AlmaLinux 9.8 e o userdel do servidor Debian 12 mostraram as mesmas seis opções.

OpçãoCopiarDescrição
-r, --removeExclui também o diretório home e o spool de e-mail
-f, --forceExclui a conta mesmo conectada e também um diretório home e um spool de e-mail de outro dono
OpçãoCopiarDescrição
-h, --helpMostra a ajuda
-R, --rootFaz chroot no diretório indicado e exclui a conta dentro dele
-P, --prefixExclui a conta dos arquivos /etc sob o diretório indicado, sem chroot
-Z, --selinux-userExclui o mapeamento de usuário SELinux da conta

Sem opções, ele exclui só as informações da conta e o grupo com o nome da conta. As opções mais usadas são -r e -f.

-R e -P são usadas para modificar os arquivos de contas de um sistema que está em outro diretório. -Z só se aplica a contas com mapeamento de usuário SELinux definido à parte.

🔲 Simulador do comando userdel

No simulador abaixo, você pode digitar por conta própria como excluir uma conta com userdel, conferir com ls o diretório home e o spool de e-mail que sobraram e ver o erro de exclusão de uma conta com processos ativos.

Simulador do comando userdelshadow-utils 4.9
[root@server work]#
É um servidor AlmaLinux virtual que funciona só dentro do navegador; as contas que restam aparecem na tabela à esquerda e os diretórios home na árvore /home, e ↑↓ recupera os comandos digitados antes.

3️⃣ Exemplos práticos do comando userdel

  • ↪️ Excluir uma conta com processos ativos e erros comuns no começo

🔲 Encerrar processos e excluir uma conta

A conta devuser, criada com useradd e com período de uso de senha definido com chage, foi excluída. Ao conferir com pgrep antes da exclusão, um processo sleep iniciado com essa conta ainda estava ativo, e ao excluir com -r nesse estado o comando parou com o código de saída 8 junto com o número do processo. Ao consultar com id, a conta também continuava lá.

~]# pgrep -u devuser -l
8397 sleep
~]# userdel -r devuser
userdel: user devuser is currently used by process 8397
~]# id devuser
uid=1001(devuser) gid=1001(devuser) groups=1001(devuser),10(wheel)

Depois de encerrar os processos da conta com pkill e executar o comando de novo, a conta foi excluída junto com o diretório home e o spool de e-mail.

~]# pkill -u devuser
~]# userdel -r devuser
userdel: group devuser not removed because it has other members.
~]# ls -ld /home/devuser
ls: cannot access '/home/devuser': No such file or directory
~]# ls -l /var/spool/mail/devuser
ls: cannot access '/var/spool/mail/devuser': No such file or directory

🔲 Erros comuns no começo

Na conta bob, excluída sem -r, o diretório home e o spool de e-mail ficaram como estavam. O campo do dono mostrou o UID 1002 no lugar do nome da conta, e o wheel no campo do grupo é o grupo primário definido com -g ao criar bob.

~]# userdel bob
~]# ls -ld /home/bob
drwx------. 2 1002 wheel 4096 Nov 14 07:40 /home/bob
~]# ls -l /var/spool/mail/bob
-rw-rw----. 1 1002 mail 0 Nov 14 07:40 /var/spool/mail/bob

Ao excluir com -r a conta tempuser, criada sem diretório home, apareceu uma linha dizendo que o diretório home não foi encontrado, mas o código de saída foi 0 e a conta foi excluída.

~]# userdel -r tempuser
userdel: tempuser home directory (/home/tempuser) not found

Ao digitar de novo um nome de conta já excluído, o comando terminou com o código de saída 6 e uma mensagem de que a conta não existe.

~]# userdel devuser
userdel: user 'devuser' does not exist

🔲 Como ler o resultado do userdel

O userdel não mostra nada em caso de sucesso, então, quando uma linha aparece, confira o que ela avisa junto com o código de saída. Como alice tinha sido colocada no grupo devuser com usermod -aG antes da exclusão, ao excluir devuser apareceu uma linha, [userdel: group devuser not removed because it has other members.], e só o grupo ficou. A linha que restou foi conferida com getent group e depois excluída com groupdel.

~]# getent group devuser
devuser:x:1001:alice
~]# groupdel devuser

Da lista de membros do grupo wheel adicionado com -G, devuser saiu e só ficaram as contas que já estavam lá.

~]# grep -E '^wheel:' /etc/group
wheel:x:10:linuxuser

userdel, a opção -r e a conferência do diretório home que sobrou podem ser digitados diretamente no Simulador do comando userdel.

4️⃣ Excluir o diretório home e o spool de e-mail com userdel -r

A opção -r exclui, junto com a conta, o diretório home, os arquivos dentro dele e o spool de e-mail.

userdel -r user1

O local do spool de e-mail é definido pelo valor MAIL_DIR de /etc/login.defs.

grep -E '^MAIL_DIR' /etc/login.defs
MAIL_DIR	/var/spool/mail

O MAIL_DIR do servidor AlmaLinux 9.8 era /var/spool/mail, e o do servidor Debian 12 era /var/mail. No servidor Debian 12, /var/spool/mail é um link para /var/mail, então os dois caminhos são o mesmo diretório.

O valor padrão do useradd no servidor Debian 12 era CREATE_MAIL_SPOOL=no, que não cria arquivo de spool de e-mail. Ao excluir com -r uma conta sem arquivo de spool de e-mail, aparece [userdel: user1 mail spool (/var/mail/user1) not found].

O diretório home e o spool de e-mail de uma conta excluída sem -r ficam como estão. O dono dos arquivos que sobraram aparece no [ls -l] como um número UID no lugar do nome da conta.

O manual oficial diz que nem o -r exclui arquivos que estão em outros sistemas de arquivos, então é preciso encontrá-los e excluí-los manualmente. Depois de excluir uma conta, procure os arquivos sem dono com o -nouser do find.

find / -xdev -nouser

-xdev é uma opção que impede o find de descer para outros sistemas de arquivos, então, em um servidor com vários discos conectados, execute para cada ponto de montagem.

5️⃣ Erros ao excluir contas no Linux e exclusão forçada com -f

Se um processo da conta estiver em execução quando ela for excluída, o userdel não exclui a conta e termina com a mensagem abaixo.

userdel: user user1 is currently used by process 2345

2345 é um número de processo de exemplo, e nesse caso o código de saída do userdel é 8.

Os processos da conta são conferidos com pgrep. -u é a opção que busca pela conta que executa o processo, e -l é a opção que mostra também o nome do processo.

pgrep -u user1 -l

Se a conta não existir, o mesmo comando termina com erro. Ao consultar no servidor AlmaLinux o nome de conta inexistente no-such-user1, apareceu [pgrep: invalid user name: no-such-user1].

O manual oficial orienta, nesse caso, a encerrar primeiro os processos, ou bloquear a senha ou a conta e excluí-la depois. Para encerrar de uma vez os processos dessa conta, use [pkill -u].

pkill -u user1

-f é a opção que leva a exclusão adiante mesmo que a conta esteja conectada. A descrição do -f no manual oficial não diz nada sobre encerrar processos e traz o aviso de que é uma opção perigosa, que pode deixar o sistema em um estado inconsistente.

userdel -f user1

Usado com -r, o -f exclui mesmo que outra conta use o mesmo diretório home ou que o spool de e-mail tenha outro dono. Os processos de uma conta excluída com -f não podem ser encontrados pelo nome, então procure colocando o UID no lugar do nome da conta em [pgrep -u].

No servidor AlmaLinux 9.8, um processo sleep foi deixado em execução na conta tempuser, recém-criada com diretório home, e depois a conta foi excluída com -f. Apareceu a mesma mensagem de conta em uso que sem -f, mas o código de saída foi 0, e ao consultar com id a conta estava excluída.

~]# userdel -f tempuser
userdel: user tempuser is currently used by process 21569
~]# id tempuser
id: ‘tempuser’: no such user
~]# pgrep -u 1001 -l
21569 sleep
~]# ls -ld /home/tempuser
drwx------. 2 1001 1001 4096 Nov 14 08:13 /home/tempuser

O processo sleep que sobrou só pôde ser encontrado pelo UID 1001, e como a exclusão foi feita sem -r, o diretório home também ficou, com o campo do dono trocado pelo UID. Ao criar em seguida uma nova conta bob, o mesmo UID 1001 foi atribuído de novo, e o processo sleep que sobrou apareceu no [pgrep -u bob] como processo de bob. Por isso, depois de excluir com -f, limpe primeiro os processos com o mesmo UID.

6️⃣ Exclusão de grupos com userdel e USERGROUPS_ENAB

Se o USERGROUPS_ENAB de /etc/login.defs for yes, o userdel exclui também o grupo com o mesmo nome da conta. Era yes tanto no servidor AlmaLinux 9.8 quanto no servidor Debian 12.

grep -E '^USERGROUPS_ENAB' /etc/login.defs
USERGROUPS_ENAB yes

Se outras contas forem membros desse grupo, o grupo fica e aparece [userdel: group user2 not removed because it has other members.]. Quando o grupo é usado como grupo primário de outra conta, também aparece [userdel: group user2 is the primary group of another user and is not removed.] e o grupo fica.

Com -f, o grupo é excluído mesmo que seja o grupo primário de outra conta.

Os grupos que sobraram são conferidos com getent group.

getent group user2

Depois de conferir também a lista de membros no fim da linha, exclua o grupo à parte com groupdel.

groupdel user2

Segundo o manual oficial, o groupdel não exclui o grupo primário de uma conta existente. Se houver uma conta que use esse grupo como grupo primário, exclua primeiro a conta e depois o grupo.

7️⃣ Diferenças entre userdel e deluser

deluser é um comando do pacote adduser da família Debian. O manual oficial apresenta o deluser como um programa que fica à frente do userdel e do groupdel e acrescenta funções como excluir o diretório home.

dpkg -S /usr/sbin/userdel /usr/sbin/deluser
passwd: /usr/sbin/userdel
adduser: /usr/sbin/deluser

No servidor Debian 12, o userdel estava no pacote passwd e o deluser no pacote adduser. O servidor AlmaLinux 9.8 não tinha deluser.

ls -l /usr/sbin/deluser
ls: cannot access '/usr/sbin/deluser': No such file or directory

Os valores padrão do deluser são definidos em /etc/deluser.conf. As três linhas que definem o alcance da exclusão foram consultadas no servidor Debian 12.

grep -E '^#?(REMOVE_HOME|REMOVE_ALL_FILES|BACKUP) ' /etc/deluser.conf
#REMOVE_HOME = 0
#REMOVE_ALL_FILES = 0
#BACKUP = 0

As três linhas eram 0 e estavam comentadas. Por isso, o deluser também exclui só a conta quando executado sem opções, e só exclui o diretório home e o spool de e-mail com --remove-home.

deluser --remove-home user1

--remove-all-files exclui todos os arquivos de que a conta é dona, inclusive os que estão fora do diretório home. Segundo o manual oficial, o deluser se recusa a excluir a conta root.

🔢 FAQ & conteúdo recomendado

O userdel --help não tem opção de backup, então, antes de excluir com -r, compacte o diretório home, como em [tar -czf /root/user1-home.tar.gz -C /home user1]. Segundo o manual oficial, o deluser da família Debian cria com --backup um arquivo tar com o nome da conta antes da exclusão.

O manual oficial explica como definir com USERDEL_CMD um script que apaga as tarefas cron e at da conta quando ela é excluída, e essa linha estava comentada no /etc/login.defs dos dois servidores. Em um servidor onde isso não foi definido, exclua primeiro as tarefas cron da conta com [crontab -r -u nome_da_conta] antes da exclusão.

Para bloquear só o login sem excluir a conta, bloqueie a senha ou a conta. [passwd -l nome_da_conta] bloqueia só a senha, então ainda dá para fazer login com outra autenticação, como chaves SSH; para bloquear a conta inteira, use [chage -E 0 nome_da_conta].

ℹ️ Aviso de afiliados
O conteúdo deste site contém links de afiliados. Quando um visitante compra um produto ou serviço por meio de um desses links, o site recebe uma comissão do vendedor. O valor que o comprador paga (em promoções, ele diminui ↓) não aumenta por causa disso. Preços, descontos e informações de estoque valem para o momento em que o texto foi escrito e podem ter mudado, por isso confirme com o vendedor antes de comprar. Os produtos são escolhidos e avaliados por critérios próprios, e o recebimento de comissão não influencia a ordem de apresentação nem o conteúdo das avaliações.

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *

Demonstre sua humanidade: 10   +   2   =