attr

mostra propriedades de arquivos e pastas; sem caminho, usa a pasta atual

ArquivosVersão 1.3.2Estável
lil-terminal

Visão geral

attr mostra propriedades de arquivos e pastas; sem caminho, usa a pasta atual. Sem suporte a xattr, exibe campos portáteis somente de leitura: path, type, permissions, access, size, mime, dimensions, modified. Exemplo: attr feed.xml MIME.

Consultar MIME e permissões

attr feed.xml MIME consulta o tipo; attr feed.xml permissions -x transforma o texto de permissões em hexadecimal.

Sintaxe

lil-terminal
attr [path [key]] [-x|-d|-s <value>]

Referência

attr

mostrar metadados portáteis do diretório atual

attr <path>

mostrar chaves estendidas ou metadados portáteis

attr <path> <key>

mostrar um campo portátil ou o valor de um atributo estendido

attr <path> <key> : <value>

definir texto bruto em um atributo estendido

-x

mostrar o valor selecionado em hexadecimal

-s <value>

definir um valor de texto em um atributo estendido

-d

excluir um atributo estendido

Observações

Os nomes dos campos portáteis ignoram maiúsculas; chaves xattr reais não. -x exibe hexadecimal, -s e : gravam um atributo estendido e -d o remove, desde que haja suporte a xattr.

Segurança

Os campos portáteis não podem ser alterados. Use mod para permissões. A demonstração representa um servidor sem xattr e mostra o aviso correspondente em vez de fingir sucesso.

Prévia interativa do sandbox

Execute os exemplos preparados diretamente na página. Os resultados são predefinidos e exibidos no navegador; nenhum comando do terminal é executado no servidor.

Inspecionar metadados do arquivo

A extensão .xml não altera as verificações do sistema de arquivos; informações MIME só são adicionadas quando o PHP consegue identificá-las corretamente.

Instalar e gerenciar

Instale a versão compatível atual. Escolha Base para o conjunto completo de recursos ou Minimum para o pacote reduzido; use upgrade para atualizar um módulo já instalado.

Base e Minimum são dois pacotes da mesma versão atual do módulo.

Pacote Base

Instala o pacote completo com referência local e todos os modos publicados.

install attr
Pacote Minimum

Instalar o pacote reduzido. A referência local é omitida; help <cmd> -i abre a referência atual do servidor.

install attr -m
Versão pública exata

Instalar exatamente esta versão publicada.

install attr -v 1.3.2
Verificar ou atualizar

upgrade verifica compatibilidade e substitui o bloco somente quando necessário.

upgrade attr
Remover módulo

Remove o bloco da extensão sem afetar o núcleo ou outros módulos.

install attr -u

Exemplos

Os exemplos podem ser copiados, mas o site não os executa. Revise caminhos, permissões e opções destrutivas.

Inspecionar metadados do arquivo
attr
Path [path]                sandbox
Type [type]                directory
Permissions [permissions]  0755
Access [access]            rwx
Modified [modified]        2026-08-11 18:40:00

A extensão .xml não altera as verificações do sistema de arquivos; informações MIME só são adicionadas quando o PHP consegue identificá-las corretamente.

Ler um campo de metadados
attr \sandbox\feed.xml
Caminho [path]            sandbox/feed.xml
Tipo [type]               file
Permissões [permissions]  0644
Acesso [access]           rw-
Tamanho [size]            127 B
MIME [mime]               application/xml
Modificado [modified]     2026-08-11 18:40:00

Imagens reconhecidas acrescentam dimensões em pixels aos mesmos metadados portáteis do arquivo.

Gravar um campo de metadados personalizado
attr \sandbox\feed.xml MIME
text/xml

Diretórios mantêm seu próprio tipo de objeto e omitem campos exclusivos de arquivos: tamanho, MIME e dados de imagem.

Ler um campo de metadados personalizado
attr \sandbox\feed.xml permissions -x
30363434
Salvar metadados em um arquivo
attr \sandbox\feed.xml permissions -s 0600
Os atributos portáteis são somente leitura
Tratar um caminho inexistente
attr \sandbox\feed.xml user.note : reviewed
Atributos estendidos não estão disponíveis; atributos portáteis são somente leitura
Definir um valor de texto em um atributo estendido
attr \sandbox\feed.xml user.note -s reviewed
Atributos estendidos não estão disponíveis; atributos portáteis são somente leitura
Excluir um atributo estendido
attr \sandbox\feed.xml user.note -d
Atributos estendidos não estão disponíveis; atributos portáteis são somente leitura
Mostrar o valor selecionado em hexadecimal
attr \sandbox\feed.xml user.note -x
Atributos estendidos não estão disponíveis; atributos portáteis são somente leitura
Excluir um atributo estendido
attr \sandbox\feed.xml permissions -d
Os atributos portáteis são somente leitura
Mostrar um campo portátil ou o valor de um atributo estendido
attr \sandbox\images\icon.svg dimensions
Attribute not found
Mostrar chaves estendidas ou metadados portáteis
attr \sandbox\missing.txt
Caminho não encontrado

Arquivo usado neste exemplo: sandbox/feed.xml

O exemplo usa um arquivo ou diretório do espaço protegido de documentação /sandbox/.

<?xml version="1.0" encoding="UTF-8"?>
<feed>
  <title>lil-sandbox</title>
  <entry id="1">Example XML content</entry>
</feed>

Documentação relacionada

Como as operações no sistema de arquivos são protegidas? →Por que arquivos grandes e saídas extensas são limitados? →

Versão pública atual

v1.3.22026-10-31

Campos portáteis sem distinção de maiúsculas

MIME, Type e outros campos portáteis aceitam qualquer combinação de maiúsculas e minúsculas. As chaves reais mantêm seus nomes.

# Histórico de versões