Provided by:
manpages-pt_20040726-4_all 
NOME
ls, dir, vdir - lista o conteudo do diretorio
SINOPSE
ls [op,c~oes] [arquivo...]
dir [arquivo...]
vdir [arquivo...]
Opcoes POSIX: [-CFRacdilqrtu1]
Opcoes 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,C~AO
O programa ls lista primeiramente seus argumentos que nao sejam
arquivos de diretorios, e, entao, para um argumento diretorio, todos os
arquivos listaveis incluidos dentro daquele diretorio. Se nenhum
argumento de opcao estiver presente, o argumento padrao '.' (diretorio
atual) e assumido. A opcao -d faz com que diretorios sejam tratados
como arquivos. Um arquivo e listavel quando ou seu nome nao inicia com
'.', ou a opcao -a for fornecida.
Cada uma das listas de arquivos (que pertence a arquivos regulares, e
para cada diretorio a lista interna de arquivos) e ordenada
separadamente de acordo com a sequencia correspondente, no local atual.
Quando a opcao -l e fornecida, cada uma das listas e precedida por uma
linha de sumario que fornece o tamanho total de todos os arquivos na
lista, medidos em grupos de 512 bytes.
A saida e a saida padrao, uma entrada por linha, ate que a saida em
multiplas colunas seja requesitada pela opcao -C. De qualquer forma,
para saida em um terminal, em linha simples ou multiplas colunas e
indefinido. As opcoes -1 e -C podem ser usadas para forcar a saida em
linha simples ou em multiplas colunas, respectivamente.
OP,C~OES POSIX
-C Lista arquivos em colunas, ordenados verticalmente.
-F Sufixa o nome de cada diretorio com '/', cada nome de FIFO com
'|', e cada nome de executavel com '*'.
-R Lista os diretorios encontrados, recursivamente.
-a Inclue os arquivos com o nome iniciando com '.' na listagem.
-c Usa o status do tempo de alteracao ao inves do tempo de
modificacao para ordenar (com -t) ou listar (com -l).
-d Lista nome de diretorios como arquivo, preferencialmente no
lugar de seus conteudos.
-i Precede a saida para o arquivo pelo numero serial do arquivo
(numero do i-node).
-l Escreve (no formato de coluna simples) o modo do arquivo, o
numero de ligacoes para o arquivo, o nome do proprietario, o
nome do grupo, o tamanho do arquivo (em bytes), o rotulo de
tempo, e o nome do arquivo.
Os tipos de arquivos sao os seguintes: - para um arquivo comum,
d para um diretorio, b para um dispositivo especial de bloco, c
para um dispositivo especial de caractere, l para uma ligacao
simbolica, p para um FIFO, s para um socket.
Por padrao, o rotulo de tempo exibido e aquele da ultima
modificacao; as opcoes -c e -u selecionam outros dois rotulos de
tempo. Para arquivos de dispositivos especiais o tamanho do
campo e geralmente substituido pelos numeros de dispositivos
maior e menor.
-q Mostra caracteres nao imprimiveis no nome do arquivo como ponto
de interrogacao. (Isto e permitido como padrao para a saida em
um terminal.)
-r Inverte a ordem do ordenacao.
-t Ordena a exibicao pelo rotulo de tempo.
-u Use o tempo do ultimo acesso no lugar do tempo de modificacao
para ordenar (com -t) ou listar (com -l).
-1 Para saida em coluna simples.
DETALHES GNU
Se a saida padrao e um terminal, a saida e em colunas (ordenadas
verticalmente).
dir (tambem instalado como d) e equivalente a 'ls -C -b'; isto e,
arquivos listados em colunas, ordenados verticalmente. vdir (tambem
instalado como v) e equivalente a 'ls -l -b'; isto e, arquivos listados
no formato longo.
OP,C~OES GNU
-1, --format=single-column
Lista um arquivo por linha. Isto e o padrao quando a saida
padrao nao e um terminal.
-a, --all
Lista todos os arquivos nos diretorios, incluindo todos os
arquivos comecados com '.'.
-b, --escape, --quoting-style=escape
Coloca aspas em nomes de arquivos com caracteres nao graficos
usando sequencia de barra invertida alfabetica e octal como
usado em C. Esta opcao e como a opcao -Q exceto que os nome de
arquivos nao sao colocados entre duas aspas.
-c, --time=ctime, --time=status
Ordena os conteudos do diretorio de acordo com os arquivos de
status do tempo de alteracao (o 'ctime' no inode). Se a listagem
em formato longo e iniciada used (-l) mostra o status do tempo
de alteracao ao inves do tempo de modificacao.
-d, --directory
Lista nomes de diretorios como arquivos, ao inves de seus
conteudos.
-f Nao ordena os conteudos do diretorio; lista-os na ordem que
estao armazenados no disco. Tambem 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 binarios de
megabytes ('mebibytes'), para cada tamanho. (Novo no
Utilitarios de Arquivo 4.0.)
-i, --inode
Imprime o numero inode (tambem chamado de numero serial do
arquivo e numero indice) de cada arquivo no lado esquerdo de
cada nome de arquivo. (Este numero 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, permissao, numero de ligacoes fortes, nome do
proprietario, nome do grupo, tamanho em bytes, e rotulo de tempo
(o tempo de modificacao ate que outros tempos sejam
selecionados). Para arquivos com um tempo maior que 6 meses
passados ou com mais de uma hora futura, o rotulo de tempo
contem o ano ao inves do dia.
Para cada diretorio que e listado, inicia o arquivo com uma
linha 'totaldeblocos' , onde " blocos " e o total de espaco de
disco usado por todos arquivos no diretorio. Por padrao, blocos
de 1024 bytes sao usados; se a variavel de ambiente
POSIXLY_CORRECT e selecionada, blocos de 512 bytes sao usados (a
menos que a opcao -k
sejafornecida).Osblocoscomputadoscontamcadaliga,c~aoforte
separadamente; isto e discutivelmente uma deficiencia.
As permissoes listadas sao similares as especificacoes de modo
simbolico mas ls combina multiplos bits no terceiro caractere de
cada conjunto de permissoes
s Se o bit setuid ou setgid e o bit correspondente para
executaveis estao ambos selecionados.
S Se o bit setuid ou setgid sao selecionados e o bit
correspondente para executaveis nao e selecionado.
t Se o bit contrario e o bit de outros executaveis estao
ambos selecionados.
T Se o bit contrario e selecionado e o bit de outros
executaveis nao e selecionado.
x Se o bit para executaveis e selecionado e nada dos acima
citados e aplicado.
- De outra forma.
-m, --format=commas
Lista os arquivos horizontalmente, com muitos ajustes em cada
linha, cada um separado por virgula e um espaco.
-n, --numeric-uid-gid
Lista a identificacao numerica de usuario e de grupo ao inves
dos nomes.
-o Produz listas em formato longo, mas nao exibe informacoes de
grupo. Isto e equivalente ao uso de --format=long --no-group.
Esta opcao e fornecida para compatibilidades com outras versoes
do ls.
-p, --file-type, --indicator-style=file-type
Anexa um caractere para cada nome de arquivo indicando o tipo de
arquivo. Isto e como -F exceto que executaveis nao sao marcados.
(Na realidade o Utilitarios de Arquivo 4.0 trata a opcao --file-
type como --classify.)
-q, --hide-control-chars
Imprime pontos de interrogacao ao invs de caracteres nao
graficos no nome de arquivo. Isto e o padrao.
-r, --reverse
Ordena os conteudos do diretorio 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 variavel de ambiente
POSIXLY_CORRECT e selecionada, blocos de 512 bytes sao usadas ao
inves de, a menos que a opcao -k seja fornecida.
-t, --sort=time
Ordena pelo tempo de modificacao (o 'mtime' no inode) ao inves
de alfabeticamente , com o nome do arquivo mais recente listado
primeiramente.
-u, --time=atime, --time=access, --time=use
Ordena o conteudo do diretorio de acordo com tempo do ultimo
acesso do arquivo ao inves do tempo de modificacao (o 'atime' no
inode). Se na listagem em formato longo e inicialmente usada,
imprime o tempo do ultimo accesso no lugar do tempo de
modificacao.
-v Ordena o conteudo do diretorio de acordo com a versao do
arquivo. Isto leva em conta o fato de que nome de arquivos
frequentemente incluem indices ou numeros de versao. Funcoes
padrao de ordenamento usualmente nao produzem a ordem que o
pessoal espera por causa da semelhanca encontrada entre bases de
caracteres. A versao ordena este problema, e e especialmente
util quando navegando por diretorios que contem muitos arquivos
com numeros de indices/versao 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 tambem que partes numericas sao iniciadas com zeros e sao
consideradas como fracionaria:
> 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 Utilitarios de Arquivo 4.0.)
-w, --width cols
Assume a tela com largura de coluna colunas. O padrao e dado
pelo driver de terminal se possivel; de outra forma a variavel
de ambiente COLUMNS e usada se estiver selecionada; de outra
forma o padrao e 80.
-x, --format=across, --format=horizontal
Lista os arquivos em colunas, ordenados horizontalmente.
-A, --almost-all
Lista todos os arquivos nos diretorios, exceto os '.' e '..'.
-B, --ignore-backups
Nao 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 e o
padrao se a saida padrao e um terminal. E sempre padrao para dir
e d.
-D, --dired
Com listagem em formato longo (-l) , imprime uma linha adicional
depois da saida principal:
//DIRED// BEG1 END1 BEG2 END2 ...
Os BEGn and ENDn sao inteiros sem sinal que registram o byte de
posicionamento do inicio e do fim de cada um dos nomes de
arquivos na saida. Isto facilita para o Emacs achar os nomes,
ate quando eles contem caracteres nao usuais como espacos ou
inicio de linha, sem pesquisa especial.
Se a listagem de diretorios e iniciada de forma recursiva (-R),
sai uma linha parecida depois de cada sub-diretorio:
//SUBDIRET'ORIO// BEG1 END1 ...
-F, --classify, --indicator-style=classify
Anexa um caractere para cada nome de arquivo indicando o tipo do
arquivo. Para arquivos regulares que sao executaveis, anexa um
'*'. O tipos de indicadores de arquivos sao '/' para diretorios,
'@' para ligacoes simbolicas, '|' para FIFOs,
-G, --no-group
Inibe a exibicao da informacao do grupo na listagem de diretorio
em formato longo.
-H, --si
Como em -h, mas usa a unidade oficial do SI (com potencia de
1000 no lugar de 1024, de forma que M significa 1000000 ao inves
de 1048576). (Novo no Utilitarios de Arquivo 4.0.)
-I, --ignore=modelo
Nao lista arquivos com nomes combinando com o modelo do
interpretador de comandos (nao e expressao regular) a menos que
eles sejam fornecidos na linha de comando. Como no interpretador
de comando, um '.' inicial no nome do arquivo nao e comparavel
com um caractere coringa no inicio do modelo.
-L, --dereference
Lista a informacao do arquivo correspondendo as ligacoes
simbolicas referentes no lugar das proprias ligacoes.
-N, --literal
Nao coloca aspas no nome do arquivo.
-Q, --quote-name, --quoting-style=c
Confina o nome do arquivo em aspas duplas e os caracteres nao
graficos entre aspas como no C.
-R, --recursive
Lista o conteudo de todos diretorios de forma recursiva.
-S, --sort=size
Ordena o conteudo do diretorio pelo tamanho do arquivo no lugar
de ordem alfabetica, com os maiores arquivos listados primeiro.
-T, --tabsize cols
Assume que cada marca de tabulacao e uma largura de cols
colunas. O padrao e 8 e pode ser sobrescrita pela variavel de
ambiente TABSIZE quando POSIXLY_CORRECT nao esta definido. ls
usa a tabulacao quando possivel na saida, para eficiencia. Se
cols e zero, nao se usa tabulacao.
-U, --sort=none
Nao ordena o conteudo do diretorio; lista-os na ordem que estao
armazenados no disco. (A diferenca entre -U e -f e que o
anterior nao desativa ou ativa opcoes.) Isto e especialmente
util quando listamos diretorios muitos grandes, desde que nao
fazendo que qualquer ordenacao possa ser notavelmente mais
rapida.
-X, --sort=extension
Ordena o conteudo do diretorio alfabeticamente pela extensao do
arquivo (caractere depois do ultimo '.'); arquivos sem extensao
sao ordenados primeiramente.
--block-size=size
Imprime o tamanho em blocos de tamanho bytes. (Novo no
Utilitarios de Arquivo 4.0.)
--color[=when]
Especifica a cor que sera usada para distinguir os tipos de
arquivo. Cores sao especificadas usando a variavel de ambiente
LS_COLORS. Para informacao sobre como selecionar esta variavel,
veja dircolors(1). quando pode ser omitido , ou um dos:
none Nao usa cores. Isto e o padrao.
auto Somente usa cores se a saida padrao e um terminal.
always Sempre usa cores. Especificando --color e nao when e
equivalente a --color=always.
--full-time
Lista o tempo completo, em detrimento a abreviacao padrao. O
formato e como no padrao date(1) ; nao e possivel alterar isto,
mas voce pode extrair a cadeia de caracteres da data com cut(1)
e passar o resultado para 'date -d'.
Isto e muito util por que o tempo na saida inclui os segundos.
(O sistema de arquivo do Unix armazena o rotulo de tempo do
arquivo somente para os segundos mais proximos, assim esta opcao
mostra todas as informacoes existentes). Por exemplo, isto pode
ajudar quando voce tem um Makefile que nao regenera arquivos
adequadamente.
--quoting-style=word
Usa o estilo word para colocar aspas nos nomes da saida. A word
pode ser uma das seguintes:
literal
Saida de nomes como e. Isto e o comportamento padrao de
ls.
shell Colocar aspas nos nomes para o interpretador de comandos
se eles contem meta caracteres do interpretador de
comandos ou que causaria saida ambigua.
shell-always
Coloca aspas nos nomes para o interpretador de comandos,
mesmo se eles normalmente nao requereriam aspas.
c Coloca aspas nos nomes como nas cadeias de caracteres da
linguagem C; isto e igual a opcao -Q
escape Coloca aspas como o c exceto que omite as aspas duplas ao
redor; isto e igual a opcao -b
Um valor padrao para esta opcao pode ser especificada com a
variavel de ambiente QUOTING_STYLE. (Veja AMBIENTE abaixo.)
--show-control-chars
Imprime caracteres nao graficos como no nome do arquivo. Isto e
o padrao a menos que a saida seja um terminal e o programa seja
ls.
OP,C~OES PADR~AO GNU
--help Imprime a mensagem de uso na saida padrao e sai.
--version
Imprime a versao na saida padrao e sai.
-- Encerra a lista de opcao.
AMBIENTE
A variavel POSIXLY_CORRECT determina a escolha da unidade. Se ela nao
e fixada, entao a variavel TABSIZE determina o numero de caracteres por
tabulacao. A variavel COLUMNS (quando contem a representacao de um
decimal inteiro) determina a largura da coluna de saida (para usar com
a opcao -C). O nome do arquivos nao devem ser truncados para torna-los
adequados a saida em multiplas colunas.
As variaveis LANG, LC_ALL, LC_CTYPE e LC_MESSAGES tem seus significados
usuais. A variavel TZ fornece a zona de tempo para a cadeia de
caracteres de tempo escrita por ls. A variavel LS_COLORS e usada para
especificar as cores usadas.
A variavel QUOTING_STYLE e usada para especificar o valor padrao para a
opcao --quoting-style literal, embora os autores advertissem que este
padrao pode mudar para shell em qualquer versao futura de ls.
PROBLEMAS
Em sistemas BSD, a opcao -s relata tamanhos que sao a metade dos
valores corretos para arquivos que sao montados de sistemas HP-UX via
NFS. Em sistemas HP-UX, ls relata tamanhos que sao duas vezes maiores
que os valores corretos para arquivos que sao montados de sistemas BSD
via NFS. Isto e devido a uma falha no HP-UX; e tambem afeta o programa
ls do HP-UX.
DE ACORDO COM
POSIX 1003.2
VEJA TAMB'EM
dircolors(1)
NOTAS
Esta pagina descreve ls como e encontrada no pacote Utilitarios de
Arquivo 4.0; outras versoes podem ser um pouco diferentes. Envie
correcoes e adicoes para aeb@cwi.nl. Relatorio de problemas no
programa para fileutils-bugs@gnu.ai.mit.edu.
TRADUZIDO POR LDP-BR em 21/08/2000.
Andre L. Fassone Canova <lonelywolf@blv.com.br> (traducao) Roberto
Selbach Teixeira <robteix@zaz.com.br> (revisao)
Utilitarios de Arquivo GNU 4.0 10/1998 LS(1)