Provided by: manpages-pt_20040726-4_all bug

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)