Provided by:
manpages-pt_20040726-4_all 
NOME
ls, dir, vdir - lista o conteúdo do diretório
SINOPSE
ls [opções] [arquivo...]
dir [arquivo...]
vdir [arquivo...]
Opções POSIX: [-CFRacdilqrtu1]
Opções GNU (forma reduzida): [-1abcdfghiklmnopqrstuvwxABCDFGHLNQRSUX]
[-w coluna] [-T coluna] [-I modelo] [--full-time]
[--show-control-chars] [--block-size=size]
[--format={long,verbose,commas,across,vertical,single-column}]
[--sort={none,time,size,extension}]
[--time={atime,access,use,ctime,status}] [--color[={none,auto,always}]]
[--help] [--version] [--]
DESCRIÇÃO
O programa ls lista primeiramente seus argumentos que não sejam
arquivos de diretórios, e, então, para um argumento diretório, todos os
arquivos listáveis incluÃdos dentro daquele diretório. Se nenhum
argumento de opção estiver presente, o argumento padrão ’.’ (diretório
atual) é assumido. A opção -d faz com que diretórios sejam tratados
como arquivos. Um arquivo é listável quando ou seu nome não inicia com
’.’, ou a opção -a for fornecida.
Cada uma das listas de arquivos (que pertence a arquivos regulares, e
para cada diretório a lista interna de arquivos) é ordenada
separadamente de acordo com a seqüência correspondente, no local atual.
Quando a opção -l é fornecida, cada uma das listas é precedida por uma
linha de sumário que fornece o tamanho total de todos os arquivos na
lista, medidos em grupos de 512 bytes.
A saÃda é a saÃda padrão, uma entrada por linha, até que a saÃda em
multiplas colunas seja requesitada pela opção -C. De qualquer forma,
para saÃda em um terminal, em linha simples ou multiplas colunas é
indefinido. As opções -1 e -C podem ser usadas para forçar a saÃda em
linha simples ou em multiplas colunas, respectivamente.
OPÇÕES POSIX
-C Lista arquivos em colunas, ordenados verticalmente.
-F Sufixa o nome de cada diretório com ’/’, cada nome de FIFO com
’|’, e cada nome de executável com ’*’.
-R Lista os diretórios encontrados, recursivamente.
-a Inclue os arquivos com o nome iniciando com ’.’ na listagem.
-c Usa o status do tempo de alteração ao invés do tempo de
modificação para ordenar (com -t) ou listar (com -l).
-d Lista nome de diretórios como arquivo, preferencialmente no
lugar de seus conteúdos.
-i Precede a saÃda para o arquivo pelo número serial do arquivo
(número do i-node).
-l Escreve (no formato de coluna simples) o modo do arquivo, o
número de ligações para o arquivo, o nome do proprietário, o
nome do grupo, o tamanho do arquivo (em bytes), o rótulo de
tempo, e o nome do arquivo.
Os tipos de arquivos são os seguintes: - para um arquivo comum,
d para um diretório, b para um dispositivo especial de bloco, c
para um dispositivo especial de caractere, l para uma ligação
simbólica, p para um FIFO, s para um socket.
Por padrão, o rótulo de tempo exibido é aquele da última
modificação; as opções -c e -u selecionam outros dois rótulos de
tempo. Para arquivos de dispositivos especiais o tamanho do
campo é geralmente substituÃdo pelos números de dispositivos
maior e menor.
-q Mostra caracteres não imprimÃveis no nome do arquivo como ponto
de interrogação. (Isto é permitido como padrão para a saÃda em
um terminal.)
-r Inverte a ordem do ordenação.
-t Ordena a exibição pelo rótulo de tempo.
-u Use o tempo do último acesso no lugar do tempo de modificação
para ordenar (com -t) ou listar (com -l).
-1 Para saÃda em coluna simples.
DETALHES GNU
Se a saÃda padrão é um terminal, a saÃda é em colunas (ordenadas
verticalmente).
dir (também instalado como d) é equivalente a ’ls -C -b’; isto é,
arquivos listados em colunas, ordenados verticalmente. vdir (também
instalado como v) é equivalente a ’ls -l -b’; isto é, arquivos listados
no formato longo.
OPÇÕES GNU
-1, --format=single-column
Lista um arquivo por linha. Isto é o padrão quando a saÃda
padrão não é um terminal.
-a, --all
Lista todos os arquivos nos diretórios, incluindo todos os
arquivos começados com ’.’.
-b, --escape, --quoting-style=escape
Coloca aspas em nomes de arquivos com caracteres não gráficos
usando seqüencia de barra invertida alfabética e octal como
usado em C. Esta opção é como a opção -Q exceto que os nome de
arquivos não são colocados entre duas aspas.
-c, --time=ctime, --time=status
Ordena os conteúdos do diretório de acordo com os arquivos de
status do tempo de alteração (o ’ctime’ no inode). Se a listagem
em formato longo é iniciada used (-l) mostra o status do tempo
de alteração ao invés do tempo de modificação.
-d, --directory
Lista nomes de diretórios como arquivos, ao invés de seus
conteúdos.
-f Não ordena os conteúdos do diretório; lista-os na ordem que
estão armazenados no disco. Também ativa -a e -U e desativa -l,
--color, -s, e -t se elas estavam especificadas antes de -f.
-g Ignorado; para compatibilidade com o Unix.
-h, --human-readable
Anexa a letra de tamanho, por exemplo M para binários de
megabytes (’mebibytes’), para cada tamanho. (Novo no
Utilitários de Arquivo 4.0.)
-i, --inode
Imprime o número inode (também chamado de número serial do
arquivo e número Ãndice) de cada arquivo no lado esquerdo de
cada nome de arquivo. (Este número identifica unicamente cada
arquivo dentro de um sistema de arquivos em particular).
-k, --kilobytes
Se o tamanho do arquivos vai ser listado, imprime-os em
kilobytes.
-l, --format=long, --format=verbose
Adicionalmente ao nome de cada arquivo, imprime o tipo de
arquivo, permissão, número de ligações fortes, nome do
proprietário, nome do grupo, tamanho em bytes, e rótulo de tempo
(o tempo de modificação até que outros tempos sejam
selecionados). Para arquivos com um tempo maior que 6 meses
passados ou com mais de uma hora futura, o rótulo de tempo
contém o ano ao invés do dia.
Para cada diretório que é listado, inicia o arquivo com uma
linha ’totaldeblocos’ , onde " blocos " é o total de espaço de
disco usado por todos arquivos no diretório. Por padrão, blocos
de 1024 bytes são usados; se a variável de ambiente
POSIXLY_CORRECT é selecionada, blocos de 512 bytes são usados (a
menos que a opção -k
sejafornecida).Osblocoscomputadoscontamcadaligaçãoforte
separadamente; isto é discutivelmente uma deficiência.
As permissões listadas são similares às especificações de modo
simbólico mas ls combina multiplos bits no terceiro caractere de
cada conjunto de permissões
s Se o bit setuid ou setgid e o bit correspondente para
executáveis estão ambos selecionados.
S Se o bit setuid ou setgid são selecionados e o bit
correspondente para executáveis não é selecionado.
t Se o bit contrário e o bit de outros executáveis estão
ambos selecionados.
T Se o bit contrário é selecionado e o bit de outros
executáveis não é selecionado.
x Se o bit para executáveis é selecionado e nada dos acima
citados é aplicado.
- De outra forma.
-m, --format=commas
Lista os arquivos horizontalmente, com muitos ajustes em cada
linha, cada um separado por vÃrgula e um espaço.
-n, --numeric-uid-gid
Lista a identificação numérica de usuário e de grupo ao invés
dos nomes.
-o Produz listas em formato longo, mas não exibe informações de
grupo. Isto é equivalente ao uso de --format=long --no-group.
Esta opção é fornecida para compatibilidades com outras versões
do ls.
-p, --file-type, --indicator-style=file-type
Anexa um caractere para cada nome de arquivo indicando o tipo de
arquivo. Isto é como -F exceto que executáveis não são marcados.
(Na realidade o Utilitários de Arquivo 4.0 trata a opção --file-
type como --classify.)
-q, --hide-control-chars
Imprime pontos de interrogação ao invs de caracteres não
gráficos no nome de arquivo. Isto é o padrão.
-r, --reverse
Ordena os conteúdos do diretório na ordem inversa.
-s, --size
Imprime o tamanho de cada arquivo em blocos de 1024 bytes no
lado esquerdo do nome de arquivo. Se a variável de ambiente
POSIXLY_CORRECT é selecionada, blocos de 512 bytes são usadas ao
invés de, a menos que a opção -k seja fornecida.
-t, --sort=time
Ordena pelo tempo de modificação (o ’mtime’ no inode) ao invés
de alfabeticamente , com o nome do arquivo mais recente listado
primeiramente.
-u, --time=atime, --time=access, --time=use
Ordena o conteúdo do diretório de acordo com tempo do último
acesso do arquivo ao invés do tempo de modificação (o ’atime’ no
inode). Se na listagem em formato longo é inicialmente usada,
imprime o tempo do último accesso no lugar do tempo de
modificação.
-v Ordena o conteúdo do diretório de acordo com a versão do
arquivo. Isto leva em conta o fato de que nome de arquivos
freqüentemente incluem Ãndices ou números de versão. Funções
padrão de ordenamento usualmente não produzem a ordem que o
pessoal espera por causa da semelhança encontrada entre bases de
caracteres. A versão ordena este problema, e é especialmente
útil quando navegando por diretórios que contém muitos arquivos
com números de Ãndices/versão em seus nomes. Por exemplo:
> ls -1 > ls -1v
foo.zml-1.gz foo.zml-1.gz
foo.zml-100.gz foo.zml-12.gz
foo.zml-12.gz foo.zml-25.gz
foo.zml-25.gz foo.zml-100.gz
Note também que partes numéricas são iniciadas com zeros e são
consideradas como fracionária:
> ls -1 > ls -1v
abc-1.007.tgz abc-1.007.tgz
abc-1.012b.tgz abc-1.01a.tgz
abc-1.01a.tgz abc-1.012b.tgz
(Novo no Utilitários de Arquivo 4.0.)
-w, --width cols
Assume a tela com largura de coluna colunas. O padrão é dado
pelo driver de terminal se possÃvel; de outra forma a variável
de ambiente COLUMNS é usada se estiver selecionada; de outra
forma o padrão é 80.
-x, --format=across, --format=horizontal
Lista os arquivos em colunas, ordenados horizontalmente.
-A, --almost-all
Lista todos os arquivos nos diretórios, exceto os ’.’ e ’..’.
-B, --ignore-backups
Não lista arquivos que terminam com ’~’, a menos que sejam
fornecidos na linha de comando.
-C, --format=vertical
Lista os arquivos em colunas, ordenados verticalmente. Isto é o
padrão se a saÃda padrão é um terminal. É sempre padrão para dir
e d.
-D, --dired
Com listagem em formato longo (-l) , imprime uma linha adicional
depois da saÃda principal:
//DIRED// BEG1 END1 BEG2 END2 ...
Os BEGn and ENDn são inteiros sem sinal que registram o byte de
posicionamento do inÃcio e do fim de cada um dos nomes de
arquivos na saÃda. Isto facilita para o Emacs achar os nomes,
até quando eles contém caracteres não usuais como espaços ou
inÃcio de linha, sem pesquisa especial.
Se a listagem de diretórios é iniciada de forma recursiva (-R),
sai uma linha parecida depois de cada sub-diretório:
//SUBDIRETÓRIO// BEG1 END1 ...
-F, --classify, --indicator-style=classify
Anexa um caractere para cada nome de arquivo indicando o tipo do
arquivo. Para arquivos regulares que são executáveis, anexa um
’*’. O tipos de indicadores de arquivos são ’/’ para diretórios,
’@’ para ligações simbólicas, ’|’ para FIFOs,
-G, --no-group
Inibe a exibição da informação do grupo na listagem de diretório
em formato longo.
-H, --si
Como em -h, mas usa a unidade oficial do SI (com potência de
1000 no lugar de 1024, de forma que M significa 1000000 ao invés
de 1048576). (Novo no Utilitários de Arquivo 4.0.)
-I, --ignore=modelo
Não lista arquivos com nomes combinando com o modelo do
interpretador de comandos (não é expressão regular) a menos que
eles sejam fornecidos na linha de comando. Como no interpretador
de comando, um ’.’ inicial no nome do arquivo não é comparável
com um caractere coringa no inÃcio do modelo.
-L, --dereference
Lista a informação do arquivo correspondendo as ligações
simbólicas referentes no lugar das próprias ligações.
-N, --literal
Não coloca aspas no nome do arquivo.
-Q, --quote-name, --quoting-style=c
Confina o nome do arquivo em aspas duplas e os caracteres não
gráficos entre aspas como no C.
-R, --recursive
Lista o conteúdo de todos diretórios de forma recursiva.
-S, --sort=size
Ordena o conteúdo do diretório pelo tamanho do arquivo no lugar
de ordem alfabética, com os maiores arquivos listados primeiro.
-T, --tabsize cols
Assume que cada marca de tabulação é uma largura de cols
colunas. O padrão é 8 e pode ser sobrescrita pela variável de
ambiente TABSIZE quando POSIXLY_CORRECT não está definido. ls
usa a tabulação quando possÃvel na saÃda, para eficiência. Se
cols é zero, não se usa tabulação.
-U, --sort=none
Não ordena o conteúdo do diretório; lista-os na ordem que estão
armazenados no disco. (A diferença entre -U e -f é que o
anterior não desativa ou ativa opções.) Isto é especialmente
útil quando listamos diretórios muitos grandes, desde que não
fazendo que qualquer ordenação possa ser notavelmente mais
rápida.
-X, --sort=extension
Ordena o conteúdo do diretório alfabeticamente pela extensão do
arquivo (caractere depois do último ’.’); arquivos sem extensão
são ordenados primeiramente.
--block-size=size
Imprime o tamanho em blocos de tamanho bytes. (Novo no
Utilitários de Arquivo 4.0.)
--color[=when]
Especifica a cor que será usada para distinguir os tipos de
arquivo. Cores são especificadas usando a variável de ambiente
LS_COLORS. Para informação sobre como selecionar esta variável,
veja dircolors(1). quando pode ser omitido , ou um dos:
none Não usa cores. Isto é o padrão.
auto Somente usa cores se a saÃda padrão é um terminal.
always Sempre usa cores. Especificando --color e não when é
equivalente a --color=always.
--full-time
Lista o tempo completo, em detrimento a abreviação padrão. O
formato é como no padrão date(1) ; não é possÃvel alterar isto,
mas você pode extrair a cadeia de caracteres da data com cut(1)
e passar o resultado para ’date -d’.
Isto é muito útil por que o tempo na saÃda inclui os segundos.
(O sistema de arquivo do Unix armazena o rótulo de tempo do
arquivo somente para os segundos mais próximos, assim esta opção
mostra todas as informações existentes). Por exemplo, isto pode
ajudar quando você tem um Makefile que não regenera arquivos
adequadamente.
--quoting-style=word
Usa o estilo word para colocar aspas nos nomes da saÃda. A word
pode ser uma das seguintes:
literal
SaÃda de nomes como é. Isto é o comportamento padrão de
ls.
shell Colocar aspas nos nomes para o interpretador de comandos
se eles contém meta caracteres do interpretador de
comandos ou que causaria saÃda ambÃgua.
shell-always
Coloca aspas nos nomes para o interpretador de comandos,
mesmo se eles normalmente não requereriam aspas.
c Coloca aspas nos nomes como nas cadeias de caracteres da
linguagem C; isto é igual a opção -Q
escape Coloca aspas como o c exceto que omite as aspas duplas ao
redor; isto é igual a opção -b
Um valor padrão para esta opção pode ser especificada com a
variável de ambiente QUOTING_STYLE. (Veja AMBIENTE abaixo.)
--show-control-chars
Imprime caracteres não gráficos como no nome do arquivo. Isto é
o padrão a menos que a saÃda seja um terminal e o programa seja
ls.
OPÇÕES PADRÃO GNU
--help Imprime a mensagem de uso na saÃda padrão e sai.
--version
Imprime a versão na saÃda padrão e sai.
-- Encerra a lista de opção.
AMBIENTE
A variável POSIXLY_CORRECT determina a escolha da unidade. Se ela não
é fixada, então a variável TABSIZE determina o número de caracteres por
tabulação. A variável COLUMNS (quando contém a representação de um
decimal inteiro) determina a largura da coluna de saÃda (para usar com
a opção -C). O nome do arquivos não devem ser truncados para torná-los
adequados à saÃda em múltiplas colunas.
As variáveis LANG, LC_ALL, LC_CTYPE e LC_MESSAGES têm seus significados
usuais. A variável TZ fornece a zona de tempo para a cadeia de
caracteres de tempo escrita por ls. A variável LS_COLORS é usada para
especificar as cores usadas.
A variável QUOTING_STYLE é usada para especificar o valor padrão para a
opção --quoting-style literal, embora os autores advertissem que este
padrão pode mudar para shell em qualquer versão futura de ls.
PROBLEMAS
Em sistemas BSD, a opção -s relata tamanhos que são a metade dos
valores corretos para arquivos que são montados de sistemas HP-UX via
NFS. Em sistemas HP-UX, ls relata tamanhos que são duas vezes maiores
que os valores corretos para arquivos que são montados de sistemas BSD
via NFS. Isto é devido a uma falha no HP-UX; e também afeta o programa
ls do HP-UX.
DE ACORDO COM
POSIX 1003.2
VEJA TAMBÉM
dircolors(1)
NOTAS
Esta página descreve ls como é encontrada no pacote Utilitários de
Arquivo 4.0; outras versões podem ser um pouco diferentes. Envie
correções e adições para aeb@cwi.nl. Relatório de problemas no
programa para fileutils-bugs@gnu.ai.mit.edu.
TRADUZIDO POR LDP-BR em 21/08/2000.
André L. Fassone Canova <lonelywolf@blv.com.br> (tradução) Roberto
Selbach Teixeira <robteix@zaz.com.br> (revisão)