ls - listar el contenido de un directorio
SINTAXIS
ls [OPCIÓN]... [ARCHIVO]...
DESCRIPCIÓN
Lista información sobre los ARCHIVOS (el directorio actual por defecto). Ordena las entradas alfabéticamente si no se especifica ninguna de las opciones -cftuvSUX ni --sort.
Los argumentos obligatorios para las opciones largas también son obligatorios para las opciones cortas.
OPCIONES
-a, --all
no ignore las entradas que comienzan con .
-A, --almost-all
no liste las entradas implícitas . y ..
--author
con -l, imprima el autor de cada archivo
-b, --escape
imprima caracteres de escape estilo C para los caracteres no gráficos
--block-size=SIZE
con -l, escale los tamaños por SIZE al imprimirlos; por ejemplo, '--block-size=M'; vea el formato de SIZE a continuación
-B, --ignore-backups
no liste las entradas implícitas que terminan con ~
-c con -lt: ordene por y muestre ctime (hora del último cambio de la información del estado del archivo); con -l: muestre ctime y ordene por nombre; de lo contrario: ordene por ctime, el más reciente primero
-C liste las entradas por columnas
--color[=WHEN]
coloree la salida CUANDO; más información a continuación
-d, --directory
liste los directorios en sí, no su contenido
-D, --dired
genere una salida diseñada para el modo dired de Emacs
-f es lo mismo que -a -U
-F, --classify[=WHEN]
agregue un indicador (uno de */=>@|) a las entradas CUANDO
--file-type
igualmente, excepto que no agregue '*'
--format=WORD
across, horizontal (-x), commas (-m), long (-l), single-column (-1), verbose (-l), vertical (-C)
--full-time
como -l --time-style=full-iso
-g como -l, pero no liste el propietario
--group-directories-first
agrupe los directorios antes que los archivos
-G, --no-group
en una lista larga, no imprima los nombres de los grupos
-h, --human-readable
con -l y -s, imprima los tamaños como 1K 234M 2G, etc.
--si igualmente, pero use potencias de 1000 en lugar de 1024
-H, --dereference-command-line
siga los enlaces simbólicos que se enumeran en la línea de comandos
--dereference-command-line-symlink-to-dir
siga cada enlace simbólico de la línea de comandos que apunta a un directorio
--hide=PATTERN
no liste las entradas implícitas que coincidan con el patrón de shell PATTERN (anulado por -a o -A)
--hyperlink[=WHEN]
cree hipervínculos para los nombres de archivo CUANDO
--indicator-style=WORD
agregue un indicador con el estilo WORD a los nombres de las entradas: ninguno (predeterminado), barra (/), tipo de archivo (--file-type), clasificar (-F)
-i, --inode
imprima el número de índice de cada archivo
-I, --ignore=PATTERN
no liste las entradas implícitas que coincidan con el patrón de shell PATTERN
-k, --kibibytes
establezca el valor predeterminado en bloques de 1024 bytes para el uso del sistema de archivos; se utiliza solo con -s y los totales por directorio
-l use un formato de lista larga
-L, --dereference
al mostrar la información del archivo para un enlace simbólico, muestre la información del archivo al que apunta el enlace en lugar de la del enlace en sí.
-m rellena el ancho con una lista de entradas separadas por comas
-n, --numeric-uid-gid
similar a -l, pero muestra los ID numéricos de usuario y grupo
-N, --literal
imprime los nombres de las entradas sin comillas
-o similar a -l, pero no muestra la información del grupo
-p, --indicator-style=slash
agrega un indicador / a los directorios
-q, --hide-control-chars
imprime ? en lugar de caracteres no gráficos
--show-control-chars
muestra los caracteres no gráficos tal cual (el valor predeterminado, a menos que el programa sea 'ls' y la salida sea una terminal)
-Q, --quote-name
encierra los nombres de las entradas entre comillas dobles
--quoting-style=WORD
usa el estilo de comillas WORD para los nombres de las entradas: literal, locale, shell, shell-always, shell-escape, shell-escape-always, c, escape (anula la variable de entorno QUOTING_STYLE)
-r, --reverse
invierte el orden al ordenar
-R, --recursive
lista los subdirectorios de forma recursiva
-s, --size
imprime el tamaño asignado de cada archivo, en bloques
-S ordena por tamaño de archivo, del más grande al más pequeño
--sort=WORD
cambia la opción de ordenación predeterminada 'name' a WORD: none (-U), size (-S), time (-t), version (-v), extension (-X), name, width
--time=WORD
selecciona qué marca de tiempo se utilizará para mostrar u ordenar; tiempo de acceso (-u): atime, access, use;
tiempo de cambio de metadatos (-c): ctime, status; tiempo de modificación (predeterminado): mtime, modification;
tiempo de creación: birth, creation;
con -l, WORD determina qué hora mostrar; con --sort=time, ordena por WORD (el más reciente primero)
--time-style=TIME_STYLE
formato de hora/fecha con -l; consulte TIME_STYLE a continuación
-t ordena por hora, el más reciente primero; consulte --time
-T, --tabsize=COLS
asume que los tabuladores están en cada COLS en lugar de 8
-u con -lt: ordena por, y muestra, el tiempo de acceso; con -l: muestra el tiempo de acceso y ordena por nombre; de lo contrario: ordena por el tiempo de acceso, el más reciente primero
-U no ordena las entradas del directorio
-v ordenamiento natural de números (versión) dentro del texto
-w, --width=COLS
establece el ancho de salida en COLS. 0 significa sin límite
-x lista las entradas por líneas en lugar de por columnas
-X ordena alfabéticamente por extensión de entrada
-Z, --context
imprime cualquier contexto de seguridad de cada archivo
--zero finaliza cada línea de salida con NUL, no con nueva línea
-1 lista un archivo por línea
--help muestra esta ayuda y sale
--version
muestra la información de la versión y sale
ARGUMENTOS
El argumento SIZE es un entero y una unidad opcional (ejemplo: 10K es 10*1024). Las unidades son K,M,G,T,P,E,Z,Y,R,Q (potencias de 1024) o KB,MB,... (potencias de 1000). También se pueden usar prefijos binarios: KiB=K, MiB=M, y así sucesivamente.
El argumento TIME_STYLE puede ser full-iso, long-iso, iso, locale o +FORMAT. FORMAT se interpreta como en date(1). Si FORMAT es FORMAT1
El argumento WHEN tiene el valor predeterminado 'always' y también puede ser 'auto' u 'never'.
El uso de color para distinguir los tipos de archivo está deshabilitado tanto de forma predeterminada como con --color=never. Con --color=auto, ls emite códigos de color solo cuando la salida estándar está conectada a una terminal. La variable de entorno LS_COLORS puede cambiar la configuración. Use el comando dircolors(1) para configurarla.
Estado de salida:
0 si todo está bien,
1 si hay problemas menores (por ejemplo, no se puede acceder a un subdirectorio),
2 si hay problemas graves (por ejemplo, no se puede acceder al argumento de la línea de comandos).
AUTOR
Escrito por Richard M. Stallman y David MacKenzie.
INFORMES DE ERRORES
Ayuda en línea de GNU coreutils: [https://www.gnu.org/software/coreutils/] Informe cualquier error de traducción a [https://translationproject.org/team/]
VÉASE TAMBIÉN
dircolors(1)
Documentación completa [https://www.gnu.org/software/coreutils/ls] o disponible localmente mediante: info '(coreutils) ls invocation'
Empaquetado por Debian (9.7-3) Copyright © 2025 Free Software Foundation, Inc. Licencia GPLv3+: GNU GPL versión 3 o posterior [https://gnu.org/licenses/gpl.html]. Este es un software libre: puede cambiarlo y redistribuirlo. No hay GARANTÍA, en la medida permitida por la ley.