Provided by: manpages-pt_20040726-4_all bug

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)