Руководства по командной строке

Man » ls Manual online - подробная онлайн-документация для страницы справочной информации ls

🌍
ls - отображение содержимого каталога

СИНТАКСИС

ls [ОПЦИЯ]... [ФАЙЛ]...

ОПИСАНИЕ

Отображение информации о ФАЙЛАХ (по умолчанию о текущем каталоге). Сортировка записей в алфавитном порядке, если не указаны опции -cftuvSUX или --sort.

Обязательные аргументы для длинных опций также являются обязательными для коротких опций.

ОПЦИИ

-a, --all
не игнорировать записи, начинающиеся с .

-A, --almost-all
не отображать подразумеваемые . и ..

--author
вместе с -l, отображать автора каждого файла

-b, --escape
отображать символы в стиле C для неграфических символов

--block-size=SIZE
вместе с -l, масштабировать размеры, используя SIZE при их отображении; например, '--block-size=M'; см. формат SIZE ниже

-B, --ignore-backups
не отображать подразумеваемые записи, заканчивающиеся на ~

-c     вместе с -lt: сортировать и отображать время последнего изменения информации о файле (ctime); вместе с -l: отображать ctime и сортировать по имени; в противном случае: сортировать по ctime, начиная с самого нового

-C     отображать записи в колонках

--color[=WHEN]
окрашивать вывод, когда WHEN; подробнее ниже

-d, --directory
отображать сами каталоги, а не их содержимое

-D, --dired
генерировать вывод, предназначенный для режима dired в Emacs

-f     то же, что и -a -U

-F, --classify[=WHEN]
добавлять индикатор (один из */=>@|) к записям, когда WHEN

--file-type
то же, но не добавлять '*'

--format=WORD
across, horizontal (-x), commas (-m), long (-l), single-column (-1), verbose (-l), vertical (-C)

--full-time
аналогично -l --time-style=full-iso

-g     аналогично -l, но не отображать владельца

--group-directories-first
группировать каталоги перед файлами

-G, --no-group
в длинном списке не отображать имена групп

-h, --human-readable
вместе с -l и -s, отображать размеры в виде 1K 234M 2G и т. д.

--si   аналогично, но использовать степени числа 1000, а не 1024

-H, --dereference-command-line
следовать символическим ссылкам, указанным в командной строке

--dereference-command-line-symlink-to-dir
следовать за каждой символической ссылкой в командной строке, которая указывает на каталог

--hide=PATTERN
не отображать подразумеваемые записи, соответствующие шаблону PATTERN (переопределяется -a или -A)

--hyperlink[=WHEN]
добавлять гиперссылки к именам файлов, когда WHEN

--indicator-style=WORD
добавлять индикатор со стилем WORD к именам записей: none (по умолчанию), slash (-p), file-type (--file-type), classify (-F)

-i, --inode
отображать индексный номер каждого файла

-I, --ignore=PATTERN
не отображать подразумеваемые записи, соответствующие шаблону PATTERN

-k, --kibibytes
по умолчанию использовать блоки размером 1024 байта для использования файловой системы; используется только с -s и для сумм по каталогам

-l     использовать длинный формат списка

-L, --dereference
при отображении информации о файле для символической ссылки, отображать информацию о файле, на который указывает ссылка, а не о самой ссылке

-m     заполнить ширину списком записей, разделенных запятыми

-n, --numeric-uid-gid
аналогично -l, но отображать числовые идентификаторы пользователя и группы

-N, --literal
выводить имена записей без кавычек

-o     аналогично -l, но не выводить информацию о группах

-p, --indicator-style=slash
добавлять индикатор / к каталогам

-q, --hide-control-chars
выводить ? вместо неграфических символов

--show-control-chars
выводить неграфические символы как есть (по умолчанию, если программа не 'ls' и вывод не предназначен для терминала)

-Q, --quote-name
обрамлять имена записей в двойные кавычки

--quoting-style=WORD
использовать стиль кавычек WORD для имен записей: literal, locale, shell, shell-always, shell-escape, shell-escape-always, c, escape (переопределяет переменную окружения QUOTING_STYLE)

-r, --reverse
изменять порядок при сортировке

-R, --recursive
рекурсивно выводить содержимое подкаталогов

-s, --size
выводить размер каждого файла в блоках

-S     сортировать по размеру файла, сначала самые большие

--sort=WORD
изменить сортировку по умолчанию с 'name' на WORD: none (-U), size (-S), time (-t), version (-v), extension (-X), name, width

--time=WORD
выбирать, какая временная метка используется для отображения или сортировки; время доступа (-u): atime, access, use;
время изменения метаданных (-c): ctime, status; время изменения (по умолчанию): mtime, modification;
время создания: birth, creation;

с -l, WORD определяет, какую временную метку показывать; с --sort=time, сортировать по WORD (от новых к старым)

--time-style=TIME_STYLE
формат времени/даты с -l; смотрите TIME_STYLE ниже

-t     сортировать по времени, сначала самые новые; смотрите --time

-T, --tabsize=COLS
предполагать, что табуляция начинается на каждой позиции COLS вместо 8

-u     с -lt: сортировать по времени доступа и отображать его; с -l: отображать время доступа и сортировать по имени; в противном случае: сортировать по времени доступа, сначала самые новые

-U     не сортировать записи каталогов

-v     естественная сортировка (версионных) номеров в тексте

-w, --width=COLS
установить ширину вывода в COLS. 0 означает отсутствие ограничений

-x     выводить записи построчно вместо столбцами

-X     сортировать в алфавитном порядке по расширению записи

-Z, --context
выводить контекст безопасности каждого файла

--zero заканчивать каждую строку вывода символом NUL, а не новой строкой

-1     выводить один файл в каждой строке

--help отобразить эту справку и выйти

--version
вывести информацию о версии и выйти

АРГУМЕНТЫ

Аргумент SIZE — это целое число и необязательные единицы измерения (например, 10K — это 10*1024). Единицы измерения: K, M, G, T, P, E, Z, Y, R, Q (степени 1024) или KB, MB и т. д. (степени 1000). Также можно использовать двоичные префиксы: KiB=K, MiB=M и т. д.

Аргумент TIME_STYLE может быть full-iso, long-iso, iso, locale или +FORMAT. FORMAT интерпретируется так же, как в date(1). Если FORMAT имеет вид FORMAT1<новая строка>FORMAT2, то FORMAT1 применяется к недавним файлам, а FORMAT2 — к недавним файлам. TIME_STYLE, начинающийся с 'posix-', применяется только вне среды POSIX. Кроме того, переменная окружения TIME_STYLE устанавливает стиль по умолчанию.

Аргумент WHEN по умолчанию имеет значение 'always', а также может быть 'auto' или 'never'.

Использование цветов для различения типов файлов отключено как по умолчанию, так и с помощью --color=never. При --color=auto, ls выводит цветовые коды только в том случае, если стандартный вывод подключен к терминалу. Переменная окружения LS_COLORS может изменить настройки. Используйте команду dircolors(1) для ее установки.


Статус выхода:

0     если все в порядке,

1     если есть незначительные проблемы (например, нет доступа к подкаталогу),

2     если возникли серьезные проблемы (например, нет доступа к аргументу командной строки).

АВТОР

Написано Ричардом М. Столлманом и Дэвидом Маккензи.

СООБЩЕНИЕ ОБ ОШИБКАХ

Онлайн-справка GNU coreutils: [https://www.gnu.org/software/coreutils/] Сообщайте об ошибках перевода по адресу [https://translationproject.org/team/]

СМ. ТАКЖЕ

dircolors(1)

Полная документация [https://www.gnu.org/software/coreutils/ls] или доступна локально через: info '(coreutils) ls invocation'

Упаковано Debian (9.7-3) Авторское право © 2025 Free Software Foundation, Inc. Лицензия GPLv3+: GNU GPL версии 3 или более поздней [https://gnu.org/licenses/gpl.html]. Это бесплатное программное обеспечение: вы можете изменять и распространять его. Гарантия отсутствует в той мере, в которой это допускается законом.