Manuais para a linha de comandos

Man » Manual online do groupmod - documentação online detalhada para a página de manual do groupmod

🌍
groupmod - modifica a definição de um grupo no sistema

SINTAXE

groupmod [opções] GRUPO

DESCRIÇÃO

O comando groupmod modifica a definição do GRUPO especificado, modificando a entrada apropriada no banco de dados de grupos.

OPÇÕES

As opções que se aplicam ao comando groupmod são:

-a, --append

Se os membros do grupo forem especificados com -U, adicione-os à lista de membros existente, em vez de substituí-la.

-g, --gid GID

O ID de grupo do GRUPO especificado será alterado para GID.

O valor de GID deve ser um inteiro decimal não negativo. Este valor deve ser exclusivo, a menos que a opção -o seja usada.

Os usuários que usam o grupo como grupo primário serão atualizados para manter o grupo como seu grupo primário.

Todos os arquivos que têm o ID de grupo antigo e devem continuar pertencendo ao GRUPO devem ter seu ID de grupo alterado manualmente.

Nenhuma verificação será realizada em relação a GID_MIN, GID_MAX, SYS_GID_MIN ou SYS_GID_MAX do /etc/login.defs.

-h, --help

Exibe a mensagem de ajuda e sai.

-n, --new-name NOVO_GRUPO

O nome do grupo será alterado de GRUPO para NOVO_GRUPO.

-o, --non-unique

Quando usado com a opção -g, permite alterar o ID de grupo para um valor não exclusivo.

-p, --password SENHA

A senha criptografada, conforme retornada por crypt(3).

Observação: esta opção não é recomendada porque a senha (ou senha criptografada) será visível para os usuários que listam os processos.

Você deve garantir que a senha respeite a política de senhas do sistema.

-R, --root CHROOT_DIR

Aplique as alterações no diretório CHROOT_DIR e use os arquivos de configuração do diretório CHROOT_DIR. Apenas caminhos absolutos são suportados.

-P, --prefix PREFIX_DIR

Aplique as alterações no diretório PREFIX_DIR e use os arquivos de configuração do diretório PREFIX_DIR. Esta opção não usa chroot e é destinada à preparação de um destino de compilação cruzada. Algumas limitações: usuários/grupos NIS e LDAP não são verificados. A autenticação PAM está usando os arquivos do host. Sem suporte SELINUX.

-U, --users

Uma lista separada por vírgulas de nomes de usuário a serem adicionados como membros do grupo.

O comportamento padrão (se as opções -g e -U não forem especificadas) é definido pela variável USERGROUPS_ENAB em /etc/login.defs.

CONFIGURAÇÃO

As seguintes variáveis de configuração em /etc/login.defs alteram o comportamento desta ferramenta:

MAX_MEMBERS_PER_GROUP (número)

Número máximo de membros por entrada de grupo. Quando o máximo é atingido, uma nova entrada de grupo (linha) é iniciada em /etc/group (com o mesmo nome, mesma senha e mesmo GID).

O valor padrão é 0, o que significa que não há limites no número de membros em um grupo.

Este recurso (divisão de grupo) permite limitar o comprimento das linhas no arquivo de grupo. Isso é útil para garantir que as linhas para grupos NIS não sejam maiores que 1024 caracteres.

Se você precisar aplicar esse limite, pode usar 25.

Observação: grupos divididos podem não ser suportados por todas as ferramentas (mesmo no conjunto de ferramentas Shadow). Você não deve usar esta variável, a menos que realmente precise.

ARQUIVOS

/etc/group

Informações da conta de grupo.

/etc/gshadow

Informações seguras da conta de grupo.

/etc/login.defs

Configuração do conjunto de ferramentas de senha Shadow.

/etc/passwd

Informações da conta de usuário.

VALORES DE SAÍDA

O comando groupmod sai com os seguintes valores:

0   E_SUCCESS: sucesso

2   E_USAGE: sintaxe de comando inválida

3   E_BAD_ARG: argumento inválido para a opção

4   E_GID_IN_USE: ID de grupo já em uso

6   E_NOTFOUND: grupo especificado não existe

9   E_NAME_IN_USE: nome de grupo já em uso

10  E_GRP_UPDATE: não é possível atualizar o arquivo de grupo

11  E_CLEANUP_SERVICE: não é possível configurar o serviço de limpeza

12  E_PAM_USERNAME: não é possível determinar seu nome de usuário para uso com o pam

13  E_PAM_ERROR: o pam retornou um erro, consulte a instalação syslog id groupmod para a mensagem de erro PAM

VEJA TAMBÉM

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