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 mas corta):
[-1abcdfghiklmnopqrstuvwxABCDFGHLNQRSUX] [-w cols] [-T cols] [-I
patr'on] [--full-time] [--show-control-chars] [--block-size=tama~no]
[--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'ON
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 ningun
argumento aparte de las opciones, se supone un argumento predeterminado
`.' (el directorio de trabajo). La opcion -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 opcion -a (o -A, vea mas 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 segun la secuencia de clasificacion en la localizacion en
curso. Cuando se da la opcion -l, cada lista se precede por una linea
de sumario que da el tamano total de todos los ficheros en la lista,
medidos en semi-kilobytes (512 B).
La salida es a la salida estandar, una entrada por cada linea, a menos
que se pida una salida multi-columna mediante la opcion -C. Sin
embargo, para la salida en una terminal, no esta definido si la salida
sera 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 Anade 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 modificacion
para la clasificacion (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 numero de serie del
fichero (numero-i o numero de nodo-i).
-l Escribe (en formato de una sola columna) los permisos del
fichero, el numero de enlaces que tiene, el nombre del
propietario, el del grupo al que pertenece, el tamano (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
ultima modificacion; las opciones -c y -u seleccionan las otras
dos que hay. Para ficheros especiales de dispositivo el campo
de tamano se reemplaza comunmente por los numeros de dispositivo
mayor y menor.
-q Imprime los caracteres no imprimibles que haya en un nombre de
fichero como signos de interrogacion `?'. (Se permite que esto
sea lo predeterminado cuando la salida es una terminal.)
-r Invierte el orden de la clasificacion.
-t Clasifica por la marca de tiempo mostrada.
-u Emplea el tiempo de ultimo acceso en vez del de modificacion
para la clasificacion (con -t) o el listado (con -l).
-1 Para la salida en una sola columna.
DETALLES DE GNU
Si la salida estandar es una terminal, la salida es en columnas
(ordenadas verticalmente).
dir (tambien instalado como d) es equivalente a `ls -C -b'; esto es,
los ficheros se listan de forma predeterminada en columnas, ordenadas
verticalmente. vdir (tambien 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 linea. Esto es lo predeterminadao cuando la
salida estandar 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 graficos en nombres de ficheros
empleando secuencias de escape alfabeticas y octales como las
empleadas en el lenguaje C. Esta opcion 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-i). Si el formato de listado largo se esta empleando (-l)
muestra el tiempo de cambio de estado en vez del de
modificacion.
-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 esten almacenados en el disco. Tambien 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
Anade una letra indicativa de tamano, tal como M para megabytes
binarios (`mebibytes'), a cada tamano. (Nueva en file-
utils-4.0.)
-i, --inode
Muestra el numero de nodo-i (tambien llamado el numero de serie
del fichero o el numero indice o numero-i) de cada fichero a la
izquierda de su nombre. (Este numero identifica de forma
inequivoca a cada fichero dentro de un sistema de ficheros
particular.)
-k, --kilobytes
Si se estan listando los tamanos de ficheros, los muestra en
kilobytes.
-l, --format=long, --format=verbose
Ademas del nombre de cada fichero, muestra el tipo del fichero,
los permisos, el numero de enlaces duros, el nombre del
propietario, el del grupo al que pertenece, el tamano en bytes,
y la marca de tiempo (el tiempo de modificacion a menos que se
seleccione otro). Para ficheros con un tiempo de mas de 6 meses
o de mas de 1 hora en el futuro, la marca de tiempo contiene el
ano en lugar de la hora del dia.
Para cada directorio que se liste, escribe antes de los ficheros
una linea `total bloques', donde bloques es el espacio de disco
total usado por todos los ficheros en ese directorio. Por
omision, se emplean bloques de 1024 bytes; si la variable de
entorno POSIXLY_CORRECT esta definida, se usan bloques de 512
bytes (a menos que se haya dado la opcion -k). Los bloques
computados cuentan cada enlace duro separadamente; esto es
discutiblemente una deficiencia.
Los permisos listados son similares a especificaciones de modo
simbolico, pero ls combina varios bits en el tercer caracter de
cada conjunto de permisos.
s Si estan activados tanto el bit SETUID o SETGID como el
correspondiente de ejecutable.
S Si esta activado el bit SETUID o SETGID pero no el
correspondiente de ejecutable.
t Si tanto el bit pegajoso (STI) como el ejecutable para
`otros' estan activados.
T Si el bit STI o pegajoso esta activado pero el ejecutable
para `otros' no lo esta.
x Si el bit ejecutable esta 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 linea, separados unos de otros por una coma y un espacio.
-n, --numeric-uid-gid
Lista los UID y GID numericos en vez de los nombres.
-o Produce listados de directorio en el formato largo, pero no
muestra informacion de grupo, como la opcion -l antigua. Es
equivalente a emplear --format=long --no-group. Esta opcion se
proporciona por compatibilidad con otras versiones de ls.
-p, --file-type, --indicator-style=file-type
Anade un caracter 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 opcion --file-type
como --classify.)
-q, --hide-control-chars
Muestra signos de interrogacion `?' en vez de caracteres no
graficos en nombres de ficheros. Esto es el comportamiento
predeterminado.
-r, --reverse
Clasifica los contenidos de directorios en orden inverso.
-s, --size
Muestra el tamano de cada fichero en bloques de 1024 bytes a la
izquierda del nombre. Si la variable de entorno POSIXLY_CORRECT
esta definida, se emplean en su lugar bloques de 512 bytes, a
menos que se haya dado la opcion -k.
-t, --sort=time
Clasifica por el tiempo de modificacion (el `mtime' en el
nodo-i) en vez de alfabeticamente, con los ficheros mas
recientes en primer lugar.
-u, --time=atime, --time=access, --time=use
Clasifica los contenidos de los directorios de acuerdo con los
tiempos de ultimo acceso de los ficheros en vez de los de
modificacion (el `atime' en el nodo-i). Si se esta empleando el
formato de listado largo, muestra el tiempo de ultimo acceso en
vez del de modificacion.
-v Clasifica los contenidos de los directorios de acuerdo a la
version de los ficheros. Esto tiene en cuenta el hecho de que
los nombres de los ficheros incluyen con frecuencia indices o
numeros de version. Las funciones de ordenacion estandares no
producen normalmente el orden que la gente espera ya que las
comparaciones se hacen caracter a caracter. La ordenacion por
version soluciona este problema, siendo especialmente util
cuando se recorren directorios que contienen muchos ficheros con
indices/numero de version 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
Tambien dese cuenta que las partes numericas 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
esta 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 linea de ordenes como argumentos.
-C, --format=vertical
Lista ficheros en columnas, ordenadas verticalmente. Esto es lo
predeterminado si la salida estandar es una terminal. Siempre es
el comportamiento predeterminado tambien para dir y d.
-D, --dired
Con el formato de listado largo (-l), imprime una linea
adicional tras la salida principal:
//DIRED// COM1 FIN1 COM2 FIN2 ...
Los COMn y FINn son enteros positivos que guardan la posicion en
bytes del COMienzo y el FINal respectivamente de cada nombre de
fichero en la salida. Esto hace mas facil a Emacs encontrar los
nombres, incluso si contienen caracteres inusuales como espacios
o nuevas-lineas, sin tener que andar buscando.
Si los directorios se estan listando recursivamente (-R),
muestra una linea similar tras cada subdirectorio:
//SUBDIRED// COM1 FIN1 ...
-F, --classify, --indicator-style=classify
Anade un caracter a cada nombre de fichero indicando el tipo del
fichero. Para ficheros regulares que sean ejecutables, anade un
`*'. Los indicadores de tipos de ficheros son `/' para
directorios, `@' para enlaces simbolicos, `|' para FIFOs, `='
para conectores, y nada para ficheros regulares.
-G, --no-group
Inhibe la salida de informacion 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'on
No lista los ficheros cuyos nombres concuerden con el patron del
shell patr'on (esto no es una expresion regular) a menos que se
den en la linea de ordenes como argumentos. Como en el shell, un
`.' inicial en un nombre de fichero no concuerda con un comodin
al principio de patr'on.
-L, --dereference
Lista la informacion del fichero correspondiente a un enlace
simbolico en lugar de la del mismo enlace.
-N, --literal
No hace nada con los caracteres no graficos 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 graficos 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 tamanos de
los ficheros en vez de alfabeticamente, con los ficheros mas
grandes en primer lugar.
-T, --tabsize=cols
Asume que cada parada de tabulacion esta 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 esten 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 ordenacion puede ir
bastante mas rapido.
-X, --sort=extension
Clasifica los contenidos del directorio alfabeticamente por las
extensiones de los ficheros (caracteres tras el ultimo `.'); los
ficheros sin extension se ponen en primer lugar.
--block-size=tama~no
Muestra los tamanos en bloques de tama~no bytes. (Nueva en file-
utils-4.0.)
--color[=cu'ando]
Especifica si emplear color para distinguir tipos de ficheros.
Los colores se especifican mediante la variable de entorno
LS_COLORS. Para informacion acerca de como definir esta
variable, consulte dircolors(1). cu'ando puede omitirse, o ser
uno de:
none No emplear color en absoluto. Esto es lo predeterminado.
auto Emplear color solamente si la salida estandar es una
terminal.
always Emplear color siempre. Especificar --color y no cu'ando es
equivalente a --color=always.
--full-time
Lista los tiempos al completo, en vez de emplear los metodos
heuristicos 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 mas cercano,
de forma que esta opcion muestra toda la informacion que hay.)
Por ejemplo, esto puede ayudar cuando uno tiene un Makefile que
no este regenerando correctamente los ficheros.
--quoting-style=word
Usa el estilo word para entrecomillar los nombres de salida. El
parametro word debe ser uno de los siguientes:
literal
Muestra los nombres "tal cual". Este es el comportamiento
por omision de ls.
shell Entrecomilla los nombres para el interprete de ordenes si
estos contienen metacaracteres del interprete de ordenes
o si pueden producir una salida ambigua.
shell-always
Entrecomilla los nombres para el interprete de ordenes,
aunque cuando, normalmente, no necesitaran
entrecomillarse.
c Entrecomilla los nombres como si fueran una cadena en C.
Esto es lo mismo que la opcion -Q.
escape Entrecomilla como con c pero omite las comillas dobles
que delimitan el nombre. Esto es lo mismo que la opcion
-b.
Se puede especificar un valor por omision para esta opcion con
la variable de entorno QUOTING_STYLE. (Vease ENTORNO mas
abajo.)
--show-control-chars
Muestra los caracteres no graficos "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'ANDARES DE GNU
--help Muestra un mensaje en la salida estandar sobre el modo de empleo
y acaba con estado de exito.
--version
Muestra en la salida estandar informacion sobre la version, y
luego acaba con estado de exito.
-- Termina con la lista de opciones.
ENTORNO
La variable POSIXLY_CORRECT determina la eleccion de la unidad. Si no
esta definida, entonces la variable TABSIZE determina el numero de
caracteres por cada parada de tabulador. La variable COLUMNS (cuando
contiene la representacion de un entero en base 10) determina la
anchura de columna de salida (para el empleo con la opcion -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 omision
para la opcion --quoting-style. Su valor actual por omision es
literal, aunque los autores han advertido que podria cambiar a shell en
alguna version futura de ls.
FALLOS
En sistemas BSD, la opcion -s da tamanos que son la mitad de los
valores correctos para ficheros que estan montados por NFS desde
sistemas HP-UX. En sistemas HP-UX, da tamanos que son el doble de los
valores correctos para ficheros que estan montados por NFS desde
sistemas BSD. Esto es debido a un defecto de HP-UX; tambien afecta al
programa ls de HP-UX.
CONFORME A
POSIX 1003.2.
V'EASE TAMBI'EN
dircolors(1)
OBSERVACIONES
Esta pagina describe ls segun se encuentra en el paquete fileutils-4.0;
otras versiones pueden diferir un poco. Envie por correo electronico
correcciones y adiciones a la direccion aeb@cwi.nl. Informe de fallos
en el programa a fileutils-bugs@gnu.ai.mit.edu.