Comando userdel: opções, exclusão do diretório home com -r e erros ao excluir contas no Linux
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 user1Segundo 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 user1id: 'user1': no such userAo 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ção | Copiar | Descrição |
|---|---|---|
| -r, --remove | Exclui também o diretório home e o spool de e-mail | |
| -f, --force | Exclui a conta mesmo conectada e também um diretório home e um spool de e-mail de outro dono |
| Opção | Copiar | Descrição |
|---|---|---|
| -h, --help | Mostra a ajuda | |
| -R, --root | Faz chroot no diretório indicado e exclui a conta dentro dele | |
| -P, --prefix | Exclui a conta dos arquivos /etc sob o diretório indicado, sem chroot | |
| -Z, --selinux-user | Exclui 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.
3️⃣ Exemplos práticos do comando userdel
🔲 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/bobAo 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 foundAo 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 devuserDa 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:linuxuseruserdel, 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 user1O local do spool de e-mail é definido pelo valor MAIL_DIR de /etc/login.defs.
grep -E '^MAIL_DIR' /etc/login.defsMAIL_DIR /var/spool/mailO 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 23452345 é 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 -lSe 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 user1Usado 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/tempuserO 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.defsUSERGROUPS_ENAB yesSe 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 user2Depois de conferir também a lista de membros no fim da linha, exclua o grupo à parte com groupdel.
groupdel user2Segundo 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/deluserpasswd: /usr/sbin/userdel
adduser: /usr/sbin/deluserNo 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/deluserls: cannot access '/usr/sbin/deluser': No such file or directoryOs 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 = 0As 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
Verificar sessões
Comandos who e w do Linux & comando user
Um artigo que resume como verificar com who e w quais contas estão conectadas ao servidor agora e quais tarefas essas contas estão executando.
Encerrar processos
Comando killall do Linux: instalação, uso e opções
Um artigo que resume como encerrar de uma vez processos com o mesmo nome com killall, como instalá-lo e suas principais opções.
ℹ️ 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.