ls - listar o conteúdo do diretório
SINTAXE
ls [OPÇÃO]... [ARQUIVO]...
DESCRIÇÃO
Lista informações sobre os ARQUIVOS (o diretório atual por padrão). Classifica as entradas alfabeticamente se nenhuma das opções -cftuvSUX ou --sort for especificada.
Os argumentos obrigatórios para opções longas também são obrigatórios para opções curtas.
OPÇÕES
-a, --all
não ignora entradas que começam com .
-A, --almost-all
não lista as entradas implícitas . e ..
--author
com -l, imprime o autor de cada arquivo
-b, --escape
imprime escapes no estilo C para caracteres não gráficos
--block-size=TAMANHO
com -l, dimensiona os tamanhos por TAMANHO ao imprimi-los; por exemplo, '--block-size=M'; veja o formato de TAMANHO abaixo
-B, --ignore-backups
não lista as entradas implícitas que terminam com ~
-c com -lt: classifica por e mostra, ctime (hora da última alteração das informações de status do arquivo); com -l: mostra ctime e classifica por nome; caso contrário: classifica por ctime, do mais recente para o mais antigo
-C lista as entradas por colunas
--color[=QUANDO]
colore a saída QUANDO; mais informações abaixo
-d, --directory
lista os diretórios em si, não o conteúdo deles
-D, --dired
gera a saída projetada para o modo dired do Emacs
-f é o mesmo que -a -U
-F, --classify[=QUANDO]
anexa um indicador (um de */=>@|) às entradas QUANDO
--file-type
da mesma forma, exceto que não anexa '*'
--format=PALAVRA
através, horizontal (-x), vírgulas (-m), longo (-l), coluna única (-1), detalhado (-l), vertical (-C)
--full-time
como -l --time-style=full-iso
-g como -l, mas não lista o proprietário
--group-directories-first
agrupa os diretórios antes dos arquivos
-G, --no-group
em uma listagem longa, não imprime os nomes dos grupos
-h, --human-readable
com -l e -s, imprime os tamanhos como 1K 234M 2G, etc.
--si da mesma forma, mas usa potências de 1000 em vez 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 as entradas implícitas que correspondem ao PADRÃO do shell (substituído por -a ou -A)
--hyperlink[=QUANDO]
cria hiperlinks para os nomes dos arquivos QUANDO
--indicator-style=PALAVRA
anexa o indicador com o estilo PALAVRA aos nomes das entradas: nenhum (padrão), barra (-p), tipo de arquivo (--file-type), classificar (-F)
-i, --inode
imprime o número de índice de cada arquivo
-I, --ignore=PADRÃO
não lista as entradas implícitas que correspondem ao PADRÃO do shell
-k, --kibibytes
usa blocos de 1024 bytes por padrão para o uso do sistema de arquivos; usado apenas com -s e para os totais por diretório
-l usa um formato de listagem longa
-L, --dereference
ao mostrar informações sobre o arquivo para um link simbólico, mostra as informações sobre o arquivo ao qual o link se refere, em vez de sobre o próprio link.
-m preenche a largura com uma lista separada por vírgulas de entradas
-n, --numeric-uid-gid
semelhante a -l, mas lista os IDs de usuário e grupo numéricos
-N, --literal
imprime os nomes das entradas sem aspas
-o semelhante a -l, mas não lista informações do grupo
-p, --indicator-style=slash
adiciona um indicador / aos diretórios
-q, --hide-control-chars
imprime ? em vez de caracteres não gráficos
--show-control-chars
mostra caracteres não gráficos como estão (o padrão, a menos que o programa seja 'ls' e a saída seja um terminal)
-Q, --quote-name
encerra os nomes das entradas em aspas duplas
--quoting-style=WORD
use o estilo de aspas WORD para os nomes das entradas: literal, locale, shell, shell-always, shell-escape, shell-escape-always, c, escape (substitui a variável de ambiente QUOTING_STYLE)
-r, --reverse
ordena em ordem inversa
-R, --recursive
lista os subdiretórios recursivamente
-s, --size
imprime o tamanho alocado de cada arquivo, em blocos
-S ordena por tamanho de arquivo, do maior para o menor
--sort=WORD
altera a ordenação padrão de 'name' para WORD: none (-U), size (-S), time (-t), version (-v), extension (-X), name, width
--time=WORD
seleciona qual timestamp é usado para exibir ou ordenar; tempo de acesso (-u): atime, access, use;
tempo de alteração dos metadados (-c): ctime, status; tempo de modificação (padrão): mtime, modification;
tempo de criação: birth, creation;
com -l, WORD determina qual tempo exibir; com --sort=time, ordena por WORD (do mais recente para o mais antigo)
--time-style=TIME_STYLE
formato de hora/data com -l; veja TIME_STYLE abaixo
-t ordena por hora, do mais recente para o mais antigo; veja --time
-T, --tabsize=COLS
assume que os tab stops estão em cada COLS em vez de 8
-u com -lt: ordena por e mostra o tempo de acesso; com -l: mostra o tempo de acesso e ordena por nome; caso contrário: ordena por tempo de acesso, do mais recente para o mais antigo
-U não ordena as entradas do diretório
-v ordenação natural de (números de) versão dentro do texto
-w, --width=COLS
define a largura de saída para COLS. 0 significa sem limite
-x lista as entradas por linhas em vez de por colunas
-X ordena alfabeticamente por extensão da entrada
-Z, --context
imprime qualquer contexto de segurança de cada arquivo
--zero termina cada linha de saída com NUL, não com nova linha
-1 lista um arquivo por linha
--help exibe esta ajuda e sai
--version
exibe informações da versão e sai
ARGUMENTOS
O argumento SIZE é um inteiro e uma unidade opcional (exemplo: 10K é 10*1024). As unidades são K,M,G,T,P,E,Z,Y,R,Q (potências de 1024) ou KB,MB,... (potências de 1000). Os prefixos binários também podem ser usados: KiB=K, MiB=M, e assim por diante.
O argumento TIME_STYLE pode ser full-iso, long-iso, iso, locale ou +FORMAT. FORMAT é interpretado como em date(1). Se FORMAT for FORMAT1
O argumento WHEN tem como padrão 'always' e também pode ser 'auto' ou 'never'.
O uso de cores para distinguir os tipos de arquivo é desativado por padrão e com --color=never. Com --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) para defini-la.
Status de saída:
0 se OK,
1 se problemas menores (por exemplo, não é possível acessar o subdiretório),
2 se problemas sérios (por exemplo, não é possível acessar o argumento da linha de comando).
AUTOR
Escrito por Richard M. Stallman e David MacKenzie.
RELATANDO BUGS
Ajuda online do GNU coreutils: [https://www.gnu.org/software/coreutils/] Relate quaisquer bugs de tradução para [https://translationproject.org/team/]
VEJA TAMBÉM
dircolors(1)
Documentação completa [https://www.gnu.org/software/coreutils/ls] ou disponível localmente via: info '(coreutils) ls invocation'
Empacotado por Debian (9.7-3) Copyright © 2025 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ê tem a liberdade de modificá-lo e redistribuí-lo. Não há GARANTIA, na medida permitida pela lei.