Converta permissões Unix entre formato simbólico e octal
rwxr-xr-- equivale a 754, e 754 volta a ser rwxr-xr--, porque ler vale 4, gravar 2 e executar 1 para cada público. Cole qualquer uma das formas e receba as duas; valores malformados são apontados, não adivinhados. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Texto
- rwxr-xr--
- Entrada
- rwxr-xr--
- Formato de entrada
- symbolic
- Octal
- 754
- Simbólico
- rwxr-xr--
As permissões Unix são compactas, mas alternar entre os formatos pode gerar erros ao revisar uma implantação, escrever um comando chmod ou documentar uma alteração de segurança. Este conversor aceita um valor simbólico de nove caracteres, como rwxr-xr--, ou um valor octal de três dígitos, como 754, valida cada posição e retorna as duas representações. A conversão é determinística e não acessa a rede nem o sistema de arquivos, tampouco interpreta a permissão em um arquivo real. Dígitos inválidos, letras fora de posição, prefixos adicionais, espaços e valores incompletos produzem um erro explícito em vez de um resultado plausível, porém incorreto.
Entenda as duas representações de permissões
Uma permissão Unix padrão descreve o acesso de três públicos em uma ordem fixa: o proprietário do arquivo, o grupo proprietário e os demais usuários. A notação simbólica atribui a cada público um bloco de três caracteres. As posições sempre significam leitura, gravação e execução; portanto, rwx concede as três permissões, r-x concede leitura e execução, e r-- concede apenas leitura.
A notação octal compacta esses mesmos bits em um dígito por público. A leitura vale quatro, a gravação vale dois e a execução vale um. A soma dos valores habilitados gera um dígito de zero a sete.
Assim, rwx vira 7, r-x vira 5 e r-- vira 4, fazendo com que rwxr-xr-- seja equivalente a 754. O conversor preserva exatamente a ordem proprietário-grupo-demais. Ele não consulta usuários, grupos, listas de controle de acesso ou metadados do sistema de arquivos.
Esse foco torna o resultado previsível para scripts, revisões, procedimentos operacionais e materiais educativos.
Informe um valor simbólico ou octal rigoroso
Digite exatamente uma cadeia de permissão no campo de texto. Para uma entrada octal, forneça três caracteres usando somente os dígitos de zero a sete, por exemplo 640 ou 755. Para uma entrada simbólica, forneça exatamente nove caracteres, divididos conceitualmente em blocos de proprietário, grupo e demais.
Cada bloco deve ter r na posição de leitura, w na posição de gravação e x na posição de execução; use um hífen quando a permissão não estiver definida. Um valor como rw-r----- é válido, enquanto wr-r----- não é, pois as letras estão em posições erradas. A validação é propositalmente rigorosa.
O conversor não remove espaços, não aceita um comando chmod, não aceita o caractere inicial de tipo de arquivo exibido por ls e não descarta silenciosamente um zero à esquerda. Também exclui setuid, setgid e sticky bit, pois esses bits especiais exigem outras regras simbólicas. Rejeitar formatos incompatíveis evita normalizações acidentais em automações de implantação.
Use o resultado com segurança em operações
A resposta identifica se o valor enviado era octal ou simbólico e retorna campos normalizados para os dois formatos. Você pode apresentar o campo simbólico a quem deseja direitos de acesso legíveis e usar o campo octal em um comando, modelo de infraestrutura ou registro de configuração. Lembre-se sempre de que conversão não é análise de autorização.
Um modo matematicamente correto ainda pode ser inadequado para uma chave confidencial, diretório compartilhado, executável ou conta de serviço. Antes de aplicá-lo, confirme quem é o proprietário do destino, se o diretório precisa de permissão de execução para travessia, se ACLs padrão ampliam o acesso e se o aplicativo espera bits especiais. A ferramenta nunca altera arquivos e nunca afirma que um modo é seguro; ela apenas converte o valor informado.
Casos de uso
Revise uma alteração chmod
Transforme um modo octal em blocos legíveis de proprietário, grupo e demais antes de aprovar uma implantação.
Prepare uma configuração
Converta uma permissão simbólica revisada no valor compacto de três dígitos exigido pela automação.
Valide a documentação
Confira se as formas simbólica e octal de um procedimento descrevem os mesmos bits básicos do Unix.
Perguntas frequentes
Esta ferramenta modifica algum arquivo?
Não. Ela apenas converte texto e nunca acessa o sistema de arquivos.
Modos de quatro dígitos são aceitos?
Não. Esta versão aceita três dígitos básicos de proprietário, grupo e demais, sem bits especiais.
Posso colar a saída de ls -l?
Não. Remova o caractere inicial de tipo de arquivo e informe exatamente os nove caracteres de permissão.
Por que os espaços são rejeitados?
A validação rigorosa impede que formatações ocultas sejam aceitas silenciosamente em automações sensíveis à segurança.
Por que um valor como wr-r----- é recusado?
Cada bloco de três tem posições fixas: primeiro leitura, depois gravação e por fim execução. Em wr-r----- as letras estão trocadas, então não é uma permissão válida. Coloque cada letra no lugar certo e use um hífen onde faltar um direito.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/security/file-permission-symbolic-convert \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"rwxr-xr--"}'const res = await fetch("https://api.kit.forhosting.com/security/file-permission-symbolic-convert", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "rwxr-xr--"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/security/file-permission-symbolic-convert",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "rwxr-xr--"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/security/file-permission-symbolic-convert", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"rwxr-xr--"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"rwxr-xr--"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/security/file-permission-symbolic-convert", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"text": "rwxr-xr--"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "security.file_permission_symbolic_convert",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Use o resultado com segurança em operações
Clientes automatizados podem tratar uma resposta invalid_input como interrupção obrigatória, em vez de continuar com permissões presumidas ou parcialmente interpretadas.
Perguntas técnicas
Quanto custa a chamada de API?
Cada solicitação de API custa US$ 0,002. A versão do navegador pode ser executada localmente na página.