chmod - alterar bits de modo de arquivo
SINTAXE
chmod [OPÇÃO]... MODO[,MODO]... ARQUIVO...
chmod [OPÇÃO]... MODO_OCTAL ARQUIVO...
chmod [OPÇÃO]... --referência=ARQUIVO_REF ARQUIVO...
DESCRIÇÃO
Esta página de manual documenta a versão GNU do chmod. chmod altera os bits de modo de arquivo de cada arquivo fornecido de acordo com o modo, que pode ser uma representação simbólica das alterações a serem feitas, ou um número octal representando o padrão de bits para os novos bits de modo.
O formato de um modo simbólico é [ugoa...][[-+=][permissões...]..., onde permissões é um ou mais caracteres do conjunto rwxXst, ou um único caractere do conjunto ugo. Vários modos simbólicos podem ser fornecidos, separados por vírgulas.
Uma combinação das letras ugoa controla quais permissões de acesso ao arquivo serão alteradas: o
usuário que o possui (u), outros usuários no grupo do arquivo (g), outros usuários que não estão no grupo
do arquivo (o) ou todos os usuários (a). Se nenhum deles for fornecido, o efeito é como se (a) fosse fornecido, mas os bits
que estão definidos no umask não são afetados.
O operador + faz com que os bits de modo de arquivo selecionados sejam adicionados aos bits de modo de arquivo existentes de cada arquivo; - faz com que sejam removidos; e = faz com que sejam adicionados e faz com que os bits não mencionados sejam removidos, exceto que os bits de ID de usuário e grupo de um diretório não são afetados.
As letras rwxXst selecionam os bits de modo de arquivo para os usuários afetados: leitura (r), gravação (w), execução (ou pesquisa para diretórios) (x), execução/pesquisa somente se o arquivo for um diretório ou já tiver permissão de execução para algum usuário (X), definir ID de usuário ou grupo na execução (s), sinalizador de exclusão restrita ou bit "sticky" (t). Em vez de um ou mais desses caracteres, você pode especificar exatamente um dos caracteres ugo: as permissões concedidas ao usuário que possui o arquivo (u), as permissões concedidas a outros usuários que são membros do grupo do arquivo (g) e as permissões concedidas a usuários que não estão em nenhuma das duas categorias anteriores (o).
Um modo numérico tem de um a quatro dígitos octais (0-7), obtidos somando os bits com valores 4 2 e 1. Os dígitos omitidos são considerados zeros à esquerda. O primeiro dígito seleciona os atributos de ID de grupo (4) e ID de grupo (2) e de exclusão restrita ou "sticky" (1). O segundo dígito seleciona as permissões para o usuário que possui o arquivo: leitura (4), gravação (2) e execução (1); o terceiro seleciona as permissões para outros usuários no grupo do arquivo, com os mesmos valores; e o quarto para outros usuários que não estão no grupo do arquivo, com os mesmos valores.
chmod não altera as permissões de links simbólicos; a chamada de sistema chmod não pode alterar suas
permissões na maioria dos sistemas e a maioria dos sistemas ignora as permissões de links simbólicos. No entanto, para
cada link simbólico listado na linha de comando, chmod altera as permissões do arquivo referenciado. Em contraste, chmod ignora links simbólicos encontrados durante travessias recursivas de diretórios. Opções que modificam esse comportamento são descritas na seção OPÇÕES.
BITS SETUID E SETGID
chmod limpa o bit de ID de grupo de um arquivo regular se o ID de grupo do arquivo não corresponder ao
ID de grupo efetivo do usuário ou a um dos IDs de grupo suplementares do usuário, a menos que o usuário
tenha privilégios apropriados. Restrições adicionais podem fazer com que os bits de ID de usuário e ID de grupo de
MODO ou ARQUIVO_REF sejam ignorados. Esse comportamento depende da política e da funcionalidade da chamada de sistema chmod subjacente. Em caso de dúvida, verifique o comportamento do sistema subjacente.
Para diretórios, chmod preserva os bits de ID de usuário e ID de grupo, a menos que você especifique explicitamente o contrário. Você pode definir ou limpar os bits com modos simbólicos como u+s e g-s. Para limpar esses bits para diretórios com um modo numérico, é necessário um zero à esquerda adicional, como 00755, um hífen à esquerda, como -6000, ou um sinal de igual, como =755.
SINALIZADOR DE EXCLUSÃO RESTRITA OU BIT "STICKY"
O sinalizador de exclusão restrita ou bit "sticky" é um único bit, cuja interpretação depende do tipo de arquivo. Para diretórios, impede que usuários não privilegiados removam ou renomeiem um arquivo no diretório, a menos que possuam o arquivo ou o diretório; isso é chamado de sinalizador de exclusão restrita para o diretório e é comum em diretórios graváveis pelo mundo, como /tmp. Para arquivos regulares em alguns sistemas mais antigos, o bit salva a imagem de texto do programa no dispositivo de swap para que ele seja carregado mais rapidamente quando executado; isso é chamado de bit "sticky".
OPÇÕES
Altere o modo de cada ARQUIVO para MODO. Com --referência, altere o modo de cada ARQUIVO para o de ARQUIVO_REF.
-c, --alterações
semelhante a verbose, mas relata somente quando uma alteração é feita
-f, --silencioso, --quiet
suprime a maioria das mensagens de erro
-v, --verbose
gera uma mensagem de diagnóstico para cada arquivo processado
--desreferenciar
afeta o referenciado de cada link simbólico, em vez do próprio link simbólico
-h, --não-desreferenciar
afeta cada link simbólico, em vez do referenciado
--não-preservar-raiz
não trate '/' especialmente (o padrão)
--preservar-raiz
falhe ao operar recursivamente em '/'
--referência=ARQUIVO_REF
use o modo de ARQUIVO_REF em vez de especificar os valores MODO. ARQUIVO_REF é sempre desreferenciado se for um
link simbólico.
-R, --recursivo
altere arquivos e diretórios recursivamente
As seguintes opções modificam como uma hierarquia é atravessada quando a opção -R também é especificada. Se mais de uma for especificada, apenas a última terá efeito. -H é o padrão.
-H se um argumento da linha de comando for um link simbólico para um diretório, atravesse-o
-L atravesse cada link simbólico para um diretório encontrado
-P não atravesse nenhum link simbólico
--ajuda exibe esta ajuda e sai
--versão
gera informações de versão e sai
Cada MODO é da forma '[ugoa]\*(\[-+=\]([rwxXst]\*|[ugo]))+|\[-+=\][0-7]+'.
AUTOR
Escrito por David MacKenzie e Jim Meyering.
RELATANDO BUGS
Ajuda online do GNU coreutils: [https://www.gnu.org/software/coreutils/] Relate quaisquer bugs de tradução para [https://translationproject.org/team/]
VEJA TAMBÉM
chmod(2)
Documentação completa [https://www.gnu.org/software/coreutils/chmod] ou disponível localmente via: info '(coreutils) chmod invocation'
Empacotado por Debian (9.7-3) Copyright © 2025 Free Software Foundation, Inc. Licença GPLv3+: GNU GPL versão 3 ou posterior [https://gnu.org/licenses/gpl.html]. Este é um software livre: você é livre para alterá-lo e redistribuí-lo. NÃO HÁ GARANTIA, na medida permitida por lei.