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)