Scroll to navigation

LS(1) Comandos de usuário LS(1)

NOME

ls - lista conteúdo de diretórios

SINOPSE

ls [OPÇÃO]... [ARQUIVO]...

DESCRIÇÃO

Lista informações sobre os ARQUIVOs (o diretório atual por padrão). Classifica as entradas em ordem alfabética se não for usada nenhuma opção -cftuvSUX nem --sort.

Argumentos obrigatórios para opções longas também o são para opções curtas.

não ignora entradas começando com .
não lista as entradas implícitas . e ..
com -l, emite o autor de cada arquivo
emite escapes no estilo C para caracteres não-gráficos
com -l, escala os tamanhos por TAM ao exibi-los; por exemplo, “--block-size=M”; veja o formato de TAM abaixo
não lista as entradas implícitas terminadas com ~
com -lt: ordena por, e mostra, ctime (hora da última modificação da informação de estado do arquivo); com -l: mostra o ctime e ordena por nome; demais casos: ordena por ctime, mais novos primeiro
lista as entradas em colunas
Coloriza a saída QUANDO; mais informações abaixo
lista os diretórios em si, e não seu conteúdo
gera a saída projetada para modo “dired” do Emacs
mesmo que -a -U
anexa indicador (um dos */=>@|) às entradas QUANDO
similar, exceto que não anexa “*”
across,horizontal (-x), commas (-m), long (-l), single-column (-1), verbose (-l), vertical (-C)
o mesmo que -l --time-style=full-iso
o mesmo que -l, mas não lista o dono
agrupa diretórios antes de arquivos
em lista longa, não emite os nomes de grupo
com -l, e/ou -s, emite tamanhos tipo 1K 234M 2G etc.
similar, mas usa potências de 1000, não de 1024
segue os links simbólicos listados na linha de comando
segue cada link simbólico da linha de comando que aponta para um diretório
não lista entradas implícitas que coincidam com o PADRÃO em sintaxe shell (ignorado por -a ou -A)
cria hiperlinks de nomes de arquivos QUANDO
anexa o indicador de tipo no estilo PALAVRA para os nomes das entradas: “none” (nenhum, padrão), “slash” (-p), “file-type” (--file-type), “classify” (-F)
emite o número de índice de cada arquivo
não lista as entradas implícitas que coincidam com o PADRÃO
por padrão, blocos de 1024 bytes para uso do sistema de arquivos; usado apenas com -s e por totais de diretório
usa o formato de lista longa
ao mostrar informações de um link simbólico, mostra as do arquivo ao qual ele referencia, e não do arquivo tipo link em si
preenche toda a largura com uma lista de entradas separadas por vírgula
como -l, mas lista usuário e grupo em IDs numéricos
emite nomes de entrada sem apas
como -l, mas não lista informações sobre o grupo
anexa o indicador / aos diretórios
emite ? em vez de caracteres não gráficos
mostra caracteres não gráficos como são (padrão a menos que o programa seja o “ls” e a saída seja um terminal)
coloca os nomes das entradas entre aspas duplas
usa estilo de aspas PALAVRA para os nomes das entradas: literal, locale, shell, shell-always, shell-escape, shell-escape-always, c, escape (substitui a variável QUOTING_STYLE)
inverte a ordem na ordenação
lista os subdiretórios recursivamente
emite o tamanho alocado de cada arquivo, em blocos
ordena por tamanho de arquivo, maior primeiro
alterar classificação padrão de 'name' para PALAVRA: none (-U), size (-S), time (-t), version (-v), extension (-X), name, width
seleciona qual registro de data e hora será usado para exibir ou classificar; tempo de acesso (-u): atime, access, use; horário de alteração de metadados (-c): ctime, status; horário de criação: birth, creation;
com -l, PALAVRA determina o tempo para mostrar; com --sort=time, ordena por PALAVRA com o mais
formato de hora/data com -l; veja TIME_STYLE abaixo
ordena por horário, mais novo primário; veja --time
presume paradas de tabulação a cada COLS em vez de 8
com -lt: mostra e ordena por horário de acesso com -l: mostra o horário de acesso e ordena por nome; demais casos: ordena por horário de acesso, mais novos primeiro
não classificar entradas de diretório
ordem natural de números (de versão) com texto
define largura saída com COLS. 0 significa sem limite
lista as entradas por linhas em vez de por colunas
ordena alfabeticamente pela extensão da entrada
emite qualquer contexto de segurança de cada arquivo
termina cada linha de saída com NULO, não com nova linha
-1
lista um arquivo por linha
mostra esta ajuda e sai
informa a versão e sai

O argumento TAM é uma unidade opcional e inteiro (exemplo: 10K é 10*1024). As unidades são K,M,G,T,P,E,Z,Y,R,Q (vezes 1024) ou KB,MB,... (vezes 1000). Prefixos binários também podem ser usados: KiB=K, MiB=M e assim por diante.

O argumento ESTILO_HORA pode ser full-iso, long-iso, iso, locale ou +FORMAT. FORMATO é interpretado como no date(1). Se FORMATO for FORMATO1<nova-linha>FORMATO2, então FORMATO1 se aplica a arquivos não recentes e FORMATO2 a arquivos recentes. ESTILO_HORA prefixado com “posix-” tem efeito somente fora do locale POSIX. Além disso, a variável de ambiente TIME_STYLE define o estilo padrão para usar.

O argumento QUANDO assume como padrão 'always' e também pode ser 'auto' ou 'never'.

O uso de cor para distinguir tipos de arquivos é desabilitado por padrão e com --color=never. --color=auto, ls emite códigos de cor apenas quando a saída padrão está conectada a um terminal. A variável de ambiente LS_COLORS pode alterar as configurações. Use o comando dircolors(1) configurá-la.

Status de saída:

0
se OK,
1
se problemas menores (por exemplo, sem acesso ao subdiretório);
2
se sérios problemas (por exemplo, sem acesso ao argumento de linha de comando).

AUTOR

Escrito por Richard M. Stallman e David MacKenzie.

RELATANDO PROBLEMAS

Página de ajuda do GNU coreutils: <https://www.gnu.org/software/coreutils/>
Relate erros de tradução para <https://translationproject.org/team/pt_BR.html>

VEJA TAMBÉM

dircolors(1)

Documentação completa <https://www.gnu.org/software/coreutils/ls>
ou localmente disponível em: info '(coreutils) ls invocation'

Packaged by Debian (9.7-2)
Copyright © 2025 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

TRADUÇÃO

A tradução para português brasileiro desta página man foi criada por André Luiz Fassone <lonely_wolf@ig.com.br>, Roberto Selbach Teixeira <robteix@zaz.com.br> e Rafael Fontenelle <rafaelff@gnome.org>.

Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.

Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores.

Abril de 2025 GNU coreutils 9.7