Man page - ls(1)

Packages contains this manual

Available languages:

en fr pt_BR es pl vi nb ko nl da cs tr hu sv ja uk fi ru ro zh_TW sr zh_CN de

Manual

LS

NOME
SINOPSE
DESCRIÇÃO
Status de saída:
AUTOR
RELATANDO PROBLEMAS
VEJA TAMBÉM
TRADUÇÃO

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.
-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, 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 o tempo para mostrar; com --sort = time , ordena por PALAVRA com o mais

--time-style = ESTILO_HORA

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.

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 .