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

ls - lista conteúdo de diretórios

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

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.

-a, --all
não ignora entradas começando com .
-A, --almost-all
não lista as entradas implícitas . e ..
--author
com -l, emite o autor de cada arquivo
-b, --escape
emite escapes no estilo C para caracteres não-gráficos
--block-size=TAM
com -l, escala os tamanhos por TAM ao exibi-los; por exemplo, “--block-size=M”; veja o formato de TAM abaixo
-B, --ignore-backups
não lista as entradas implícitas terminadas com ~
-c
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
-C
lista as entradas em colunas
--color[=QUANDO]
Coloriza a saída QUANDO; mais informações abaixo
-d, --directory
lista os diretórios em si, e não seu conteúdo
-D, --dired
gera a saída projetada para modo “dired” do Emacs
-f
mesmo que -a -U
-F, --classify[=QUANDO]
anexa indicador (um dos */=>@|) às entradas QUANDO
--file-type
similar a -F, exceto que não anexa “*”
--format=PALAVRA
across,horizontal (-x), commas (-m), long (-l), single-column (-1), verbose (-l), vertical (-C)
--full-time
o mesmo que -l --time-style=full-iso
-g
o mesmo que -l, mas não lista o dono
--group-directories-first
agrupa diretórios antes de arquivos
-G, --no-group
em lista longa, não emite os nomes de grupo
-h, --human-readable
com -l, e/ou -s, emite tamanhos tipo 1K 234M 2G etc.
--si
similar, mas usa potências de 1000, não de 1024
-H, --dereference-command-line
segue os links simbólicos listados na linha de comando
--dereference-command-line-symlink-to-dir
segue cada link simbólico da linha de comando que aponta para um diretório
--hide=PADRÃO
não lista entradas implícitas que coincidam com o PADRÃO em sintaxe shell (ignorado por -a ou -A)
--hyperlink[=QUANDO]
cria hiperlinks de nomes de arquivos QUANDO
--indicator-style=PALAVRA
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)
-i, --inode
emite o número de índice de cada arquivo
-I, --ignore=PADRÃO
não lista as entradas implícitas que coincidam com o PADRÃO
-k, --kibibytes
por padrão, blocos de 1024 bytes para uso do sistema de arquivos; usado apenas com -s e por totais de diretório
-l
usa o formato de lista longa
-L, --dereference
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
-m
preenche toda a largura com uma lista de entradas separadas por vírgula
-n, --numeric-uid-gid
como -l, mas lista usuário e grupo em IDs numéricos
-N, --literal
emite nomes de entrada sem apas
-o
como -l, mas não lista informações sobre o grupo
-p, --indicator-style=slash
anexa o indicador / aos diretórios
-q, --hide-control-chars
emite ? em vez de caracteres não gráficos
--show-control-chars
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
-Q, --quote-name
coloca os nomes das entradas entre aspas duplas
--quoting-style=PALAVRA
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)
-r, --reverse
inverte a ordem na ordenação
-R, --recursive
lista os subdiretórios recursivamente
-s, --size
emite o tamanho alocado de cada arquivo, em blocos
-S
ordena por tamanho de arquivo, maior primeiro
--sort=PALAVRA
alterar classificação padrão de 'name' para PALAVRA: none (-U), size (-S), time (-t), version (-v), extension (-X), name, width
--time=PALAVRA
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 qual horário para mostrar; com --sort=horário, ordenado por PALAVRA (mais novo primeiro)
--time-style=ESTILO_HORÁRIO
formato de hora/data com -l; veja TIME_STYLE abaixo
-t
ordena por horário, mais novo primário; veja --time
-T, --tabsize=COLS
presume paradas de tabulação a cada COLS em vez de 8
-u
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
-U
não classificar entradas de diretório
-v
ordem natural de números (de versão) com texto
-w, --width=COLS
define largura saída com COLS. 0 significa sem limite
-x
lista as entradas por linhas em vez de por colunas
-X
ordena alfabeticamente pela extensão da entrada
-Z, --context
emite qualquer contexto de segurança de cada arquivo
--zero
termina cada linha de saída com NULO, não com nova linha
-1
lista um arquivo por linha
--help
mostra esta ajuda e sai
--version
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.

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).

Escrito por Richard M. Stallman e David MacKenzie.

Relate erros para: bug-coreutils@gnu.org
Página do GNU coreutils: https://www.gnu.org/software/coreutils/
Ajuda em geral no uso de software GNU: https://www.gnu.org/gethelp/
Relate erros de tradução para https://translationproject.org/team/pt_BR.html

Copyright © 2026 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Á QUALQUER GARANTIA, na máxima extensão permitida em lei.

dircolors(1)

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

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.

Fevereiro de 2026 GNU coreutils 9.10