Provided by: manpages-es_1.55-10_all 
NOMBRE
ls, dir, vdir - listan los contenidos de directorios
SINOPSIS
ls [opciones] [fichero...]
dir [fichero...]
vdir [fichero...]
Opciones de POSIX: [-CFRacdilqrtu1]
Opciones de GNU (en la forma más corta): [-1abcdfghiklmnopqrstuvwxABCDFGHLNQRSUX] [-w
cols] [-T cols] [-I patrón] [--full-time] [--show-control-chars] [--block-size=tamaño]
[--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] [--]
DESCRIPCIÓN
El programa ls lista primero sus argumentos no directorios fichero, y luego para cada
argumento directorio todos los ficheros susceptibles de listarse contenidos en dicho
directorio. Si no hay presente ningún argumento aparte de las opciones, se supone un
argumento predeterminado `.' (el directorio de trabajo). La opción -d hace que los
directorios se traten como argumentos no directorios; es decir, como ficheros normales.
Un fichero es susceptible de listarse cuando su nombre no comienza con `.' o cuando se da
la opción -a (o -A, vea más abajo).
Cada una de las listas de ficheros (las de ficheros no directorios, y para cada directorio
la lista de ficheros de dentro) se clasifica separadamente según la secuencia de
clasificación en la localización en curso. Cuando se da la opción -l, cada lista se
precede por una línea de sumario que da el tamaño total de todos los ficheros en la lista,
medidos en semi-kilobytes (512 B).
La salida es a la salida estándar, una entrada por cada línea, a menos que se pida una
salida multi-columna mediante la opción -C. Sin embargo, para la salida en una terminal,
no está definido si la salida será en una sola columna o en varias. Las opciones -1 y -C
se pueden emplear para forzar la salida en una o en varias columnas, respectivamente.
OPCIONES DE POSIX
-C Lista los ficheros en columnas, ordenados verticalmente.
-F Añade tras cada nombre de directorio un `/', tras cada nombre de FIFO un `|', y
tras cada nombre de un ejecutable un `*'.
-R Lista recursivamente los subdirectorios encontrados.
-a Incluye en el listado ficheros cuyos nombres empiecen por `.'.
-c Emplea el tiempo de cambio de estado en vez del de modificación para la
clasificación (con -t) o el listado (con -l).
-d Lista nombres de directorios como otros ficheros, en vez de listar sus contenidos.
-i Precede la salida para el fichero por el número de serie del fichero (número-í o
número de nodo-í).
-l Escribe (en formato de una sola columna) los permisos del fichero, el número de
enlaces que tiene, el nombre del propietario, el del grupo al que pertenece, el
tamaño (en bytes), una marca de tiempo, y el nombre del fichero. De forma
predeterminada, la marca de tiempo que se muestra es la de la última modificación;
las opciones -c y -u seleccionan las otras dos que hay. Para ficheros especiales
de dispositivo el campo de tamaño se reemplaza comúnmente por los números de
dispositivo mayor y menor.
-q Imprime los caracteres no imprimibles que haya en un nombre de fichero como signos
de interrogación `?'. (Se permite que esto sea lo predeterminado cuando la salida
es una terminal.)
-r Invierte el orden de la clasificación.
-t Clasifica por la marca de tiempo mostrada.
-u Emplea el tiempo de último acceso en vez del de modificación para la clasificación
(con -t) o el listado (con -l).
-1 Para la salida en una sola columna.
DETALLES DE GNU
Si la salida estándar es una terminal, la salida es en columnas (ordenadas verticalmente).
dir (también instalado como d) es equivalente a `ls -C -b'; esto es, los ficheros se
listan de forma predeterminada en columnas, ordenadas verticalmente. vdir (también
instalado como v) es equivalente a `ls -l -b'; esto es, los ficheros se listan de forma
predeterminada en el formato largo.
OPCIONES DE GNU
-1, --format=single-column
Lista un fichero por línea. Esto es lo predeterminadao cuando la salida estándar no
es una terminal.
-a, --all
Lista todos los ficheros en directorios, incluyendo todos los ficheros cuyos
nombres comiencen por `.'.
-b, --escape, --quoting-style=escape
Muestra los caracteres no gráficos en nombres de ficheros empleando secuencias de
escape alfabéticas y octales como las empleadas en el lenguaje C. Esta opción es la
misma que -Q salvo que no se delimintan los nombres de fichero por comillas dobles.
-c, --time=ctime, --time=status
Clasifica los contenidos del directorio de acuerdo con los tiempos de cambio de
estado de los ficheros (el `ctime' en el nodo-í). Si el formato de listado largo se
está empleando (-l) muestra el tiempo de cambio de estado en vez del de
modificación.
-d, --directory
Lista nombres de directorios como otros ficheros, en vez de listar sus contenidos.
-f No ordena los contenidos del directorio; los lista en el orden en que estén
almacenados en el disco. También activa -a y -U y desactiva -l, --color, -s y -t
si se especificaron antes de -f.
-g No hace nada; por compatibilidad con otras versiones de Unix.
-h, --human-readable
Añade una letra indicativa de tamaño, tal como M para megabytes binarios
(`mebibytes'), a cada tamaño. (Nueva en fileutils-4.0.)
-i, --inode
Muestra el número de nodo-í (también llamado el número de serie del fichero o el
número índice o número-í) de cada fichero a la izquierda de su nombre. (Este número
identifica de forma inequívoca a cada fichero dentro de un sistema de ficheros
particular.)
-k, --kilobytes
Si se están listando los tamaños de ficheros, los muestra en kilobytes.
-l, --format=long, --format=verbose
Además del nombre de cada fichero, muestra el tipo del fichero, los permisos, el
número de enlaces duros, el nombre del propietario, el del grupo al que pertenece,
el tamaño en bytes, y la marca de tiempo (el tiempo de modificación a menos que se
seleccione otro). Para ficheros con un tiempo de más de 6 meses o de más de 1 hora
en el futuro, la marca de tiempo contiene el año en lugar de la hora del día.
Para cada directorio que se liste, escribe antes de los ficheros una línea `total
bloques', donde bloques es el espacio de disco total usado por todos los ficheros
en ese directorio. Por omisión, se emplean bloques de 1024 bytes; si la variable de
entorno POSIXLY_CORRECT está definida, se usan bloques de 512 bytes (a menos que se
haya dado la opción -k). Los bloques computados cuentan cada enlace duro
separadamente; esto es discutiblemente una deficiencia.
Los permisos listados son similares a especificaciones de modo simbólico, pero ls
combina varios bits en el tercer carácter de cada conjunto de permisos.
s Si están activados tanto el bit SETUID o SETGID como el correspondiente de
ejecutable.
S Si está activado el bit SETUID o SETGID pero no el correspondiente de
ejecutable.
t Si tanto el bit pegajoso (STI) como el ejecutable para `otros' están
activados.
T Si el bit STI o pegajoso está activado pero el ejecutable para `otros' no lo
está.
x Si el bit ejecutable está activado y no se aplica nada de lo anterior.
- Otra cosa (no hay permiso).
-m, --format=commas
Lista los ficheros horizontalmente, con tantos como quepan en cada línea, separados
unos de otros por una coma y un espacio.
-n, --numeric-uid-gid
Lista los UID y GID numéricos en vez de los nombres.
-o Produce listados de directorio en el formato largo, pero no muestra información de
grupo, como la opción -l antigua. Es equivalente a emplear --format=long
--no-group. Esta opción se proporciona por compatibilidad con otras versiones de
ls.
-p, --file-type, --indicator-style=file-type
Añade un carácter a cada nombre de fichero indicando el tipo del fichero. Esto es
como -F salvo en que los ejecutables no se marcan. (De hecho, fileutils-4.0 trata
la opción --file-type como --classify.)
-q, --hide-control-chars
Muestra signos de interrogación `?' en vez de caracteres no gráficos en nombres de
ficheros. Esto es el comportamiento predeterminado.
-r, --reverse
Clasifica los contenidos de directorios en orden inverso.
-s, --size
Muestra el tamaño de cada fichero en bloques de 1024 bytes a la izquierda del
nombre. Si la variable de entorno POSIXLY_CORRECT está definida, se emplean en su
lugar bloques de 512 bytes, a menos que se haya dado la opción -k.
-t, --sort=time
Clasifica por el tiempo de modificación (el `mtime' en el nodo-í) en vez de
alfabéticamente, con los ficheros más recientes en primer lugar.
-u, --time=atime, --time=access, --time=use
Clasifica los contenidos de los directorios de acuerdo con los tiempos de último
acceso de los ficheros en vez de los de modificación (el `atime' en el nodo-í). Si
se está empleando el formato de listado largo, muestra el tiempo de último acceso
en vez del de modificación.
-v Clasifica los contenidos de los directorios de acuerdo a la versión de los
ficheros. Esto tiene en cuenta el hecho de que los nombres de los ficheros incluyen
con frecuencia índices o números de versión. Las funciones de ordenación estándares
no producen normalmente el orden que la gente espera ya que las comparaciones se
hacen carácter a carácter. La ordenación por versión soluciona este problema,
siendo especialmente útil cuando se recorren directorios que contienen muchos
ficheros con índices/número de versión en sus nombres. Por ejemplo:
> 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
También dese cuenta que las partes numéricas con ceros a la izquierda se consideran
como fraccionarias:
> 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
(Nueva en fileutils-4.0.)
-w, --width cols
Asume que la pantalla tiene cols columnas de ancho. El valor predeterminado se toma
del controlador de terminal si es posible; si no, se emplea la variable de ambiente
COLUMNS si está definida; de otro modo el valor predeterminado es 80.
-x, --format=across, --format=horizontal
Lista los ficheros en columnas, ordenados horizontalmente.
-A, --almost-all
Lista todos los ficheros en los directorios, excepto `.' y `..'.
-B, --ignore-backups
No lista los ficheros que acaben en `~', a menos que se den sus nombres en la línea
de órdenes como argumentos.
-C, --format=vertical
Lista ficheros en columnas, ordenadas verticalmente. Esto es lo predeterminado si
la salida estándar es una terminal. Siempre es el comportamiento predeterminado
también para dir y d.
-D, --dired
Con el formato de listado largo (-l), imprime una línea adicional tras la salida
principal:
//DIRED// COM1 FIN1 COM2 FIN2 ...
Los COMn y FINn son enteros positivos que guardan la posición en bytes del COMienzo
y el FINal respectivamente de cada nombre de fichero en la salida. Esto hace más
fácil a Emacs encontrar los nombres, incluso si contienen caracteres inusuales como
espacios o nuevas-líneas, sin tener que andar buscando.
Si los directorios se están listando recursivamente (-R), muestra una línea similar
tras cada subdirectorio:
//SUBDIRED// COM1 FIN1 ...
-F, --classify, --indicator-style=classify
Añade un carácter a cada nombre de fichero indicando el tipo del fichero. Para
ficheros regulares que sean ejecutables, añade un `*'. Los indicadores de tipos de
ficheros son `/' para directorios, `@' para enlaces simbólicos, `|' para FIFOs, `='
para conectores, y nada para ficheros regulares.
-G, --no-group
Inhibe la salida de información de grupo en un listado de directorio en formato
largo.
-H, --si
Hace lo mismo que -h pero usa las unidades oficiales del SI (con potencias de 1000
en vez de 1024, por lo que M significa 1000000 en lugar de 1048576). (Nueva en
fileutils-4.0.)
-I, --ignore=patrón
No lista los ficheros cuyos nombres concuerden con el patrón del shell patrón (esto
no es una expresión regular) a menos que se den en la línea de órdenes como
argumentos. Como en el shell, un `.' inicial en un nombre de fichero no concuerda
con un comodín al principio de patrón.
-L, --dereference
Lista la información del fichero correspondiente a un enlace simbólico en lugar de
la del mismo enlace.
-N, --literal
No hace nada con los caracteres no gráficos en nombres de ficheros; los muestra en
la salida tal cual.
-Q, --quote-name, --quoting-style=c
Encierra los nombres de ficheros entre comillas dobles y muestra los caracteres no
gráficos de sus nombres como en el lenguaje C.
-R, --recursive
Lista los contenidos de todos los directorios recursivamente.
-S, --sort=size
Clasifica los contenidos de los directorios por los tamaños de los ficheros en vez
de alfabéticamente, con los ficheros más grandes en primer lugar.
-T, --tabsize=cols
Asume que cada parada de tabulación está a cols columnas de ancho; el valor
predeterminado es 8. ls emplea tabuladores donde es posible en la salida, por
eficiencia. Si cols es cero, no usa tabuladores para nada.
-U, --sort=none
No clasifica los contenidos de directorios; los lista en el orden en que estén
almacenados en el disco. (La diferencia entre -U y -f es que el primero no
desactiva o activa opciones.) Esto es especialmente de utilidad cuando se listen
directorios muy grandes, puesto que al no efectuar ninguna ordenación puede ir
bastante más rápido.
-X, --sort=extension
Clasifica los contenidos del directorio alfabéticamente por las extensiones de los
ficheros (caracteres tras el último `.'); los ficheros sin extensión se ponen en
primer lugar.
--block-size=tamaño
Muestra los tamaños en bloques de tamaño bytes. (Nueva en fileutils-4.0.)
--color[=cuándo]
Especifica si emplear color para distinguir tipos de ficheros. Los colores se
especifican mediante la variable de entorno LS_COLORS. Para información acerca de
cómo definir esta variable, consulte dircolors(1). cuándo puede omitirse, o ser
uno de:
none No emplear color en absoluto. Esto es lo predeterminado.
auto Emplear color solamente si la salida estándar es una terminal.
always Emplear color siempre. Especificar --color y no cuándo es equivalente a
--color=always.
--full-time
Lista los tiempos al completo, en vez de emplear los métodos heurísticos para las
abreviaturas normales. El formato es el mismo que el predeterminado de date(1); no
es posible cambiar esto, pero uno puede extraer la cadena de fecha con cut(1) y
luego pasar el resultado a `date -d'.
Esto es mayormente de utilidad porque la salida de tiempo incluye los segundos.
(Los sistemas de ficheros de Unix almacenan las marcas de tiempo solamente al
segundo más cercano, de forma que esta opción muestra toda la información que hay.)
Por ejemplo, esto puede ayudar cuando uno tiene un Makefile que no esté regenerando
correctamente los ficheros.
--quoting-style=word
Usa el estilo word para entrecomillar los nombres de salida. El parámetro word debe
ser uno de los siguientes:
literal
Muestra los nombres "tal cual". Éste es el comportamiento por omisión de ls.
shell Entrecomilla los nombres para el intérprete de órdenes si estos contienen
metacaracteres del intérprete de órdenes o si pueden producir una salida
ambigüa.
shell-always
Entrecomilla los nombres para el intérprete de órdenes, aunque cuando,
normalmente, no necesitaran entrecomillarse.
c Entrecomilla los nombres como si fueran una cadena en C. Esto es lo mismo
que la opción -Q.
escape Entrecomilla como con c pero omite las comillas dobles que delimitan el
nombre. Esto es lo mismo que la opción -b.
Se puede especificar un valor por omisión para esta opción con la variable de
entorno QUOTING_STYLE. (Véase ENTORNO más abajo.)
--show-control-chars
Muestra los caracteres no gráficos "tal cual" en los nombres de los ficheros. Esto
es lo que suele ocurrir a menos que la salida sea una terminal y el programa sea
ls.
OPCIONES ESTÁNDARES DE GNU
--help Muestra un mensaje en la salida estándar sobre el modo de empleo y acaba con estado
de éxito.
--version
Muestra en la salida estándar información sobre la versión, y luego acaba con
estado de éxito.
-- Termina con la lista de opciones.
ENTORNO
La variable POSIXLY_CORRECT determina la elección de la unidad. Si no está definida,
entonces la variable TABSIZE determina el número de caracteres por cada parada de
tabulador. La variable COLUMNS (cuando contiene la representación de un entero en base
10) determina la anchura de columna de salida (para el empleo con la opción -C). Los
nombres de ficheros no deben ser truncados para que quepan en una salida multi-columna.
Las variables LANG, LC_ALL, LC_COLLATE, LC_CTYPE, LC_MESSAGES y LC_TIME tienen los
significados usuales. La variable TZ da el huso horario para cadenas de tiempo escritas
por ls. La variable LS_COLORS se emplea para especificar los colores empleados.
La variable QUOTING_STYLE se usa para especificar el valor por omisión para la opción
--quoting-style. Su valor actual por omisión es literal, aunque los autores han advertido
que podría cambiar a shell en alguna versión futura de ls.
FALLOS
En sistemas BSD, la opción -s da tamaños que son la mitad de los valores correctos para
ficheros que están montados por NFS desde sistemas HP-UX. En sistemas HP-UX, da tamaños
que son el doble de los valores correctos para ficheros que están montados por NFS desde
sistemas BSD. Esto es debido a un defecto de HP-UX; también afecta al programa ls de HP-
UX.
CONFORME A
POSIX 1003.2.
VÉASE TAMBIÉN
dircolors(1)
OBSERVACIONES
Esta página describe ls según se encuentra en el paquete fileutils-4.0; otras versiones
pueden diferir un poco. Envíe por correo electrónico correcciones y adiciones a la
dirección aeb@cwi.nl. Informe de fallos en el programa a fileutils-bugs@gnu.ai.mit.edu.