Manpages

ИМЯ

ls, dir, vdir − выводит содержимое каталога

ОБЗОР

ls [опции] [файл...]
dir [файл...]
vdir [файл...]

Опции POSIX: [−CFRacdilqrtu1] [−−]

Опции GNU (краткая форма): [−1abcdfghiklmnopqrstuvwxABCDFGHLNQRSUX] [−w cols] [−T cols] [−I шаблон] [−−full−time] [−−show−control−chars] [−−block−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] [−−]

ОПИСАНИЕ

Программа ls сначала выводит список всех файлов (не каталогов), перечисленных в командной строке, а затем выводит список всех файлов, находящихся в каталогах, перечисленных в командной строке. Если не указано ни одного файла, то по умолчанию аргументом назначается ’.’ (текущий каталог). Опция −d заставляет ls не считать аргументы-каталоги каталогами. Будут отображаться только файлы, которые не начинаются с ’.’ или все файлы, если задана опция −a.

Каждый список файлов (для файлов, которые не являются каталогами и для каждого каталога, содержащего список файлов) сортируется отдельно в алфавитной последовательности текущих региональных настроек (locale). Когда указана опция −l, то перед каждым списком выводится итоговая строка с общим размером всех файлов в списке, который измеряется в полу-килобайтах (512 байт).

Результаты печатаются на стандартный вывод, по одному файлу на строку, если с помощью опции −C не задан многоколоночный вывод. Однако при выводе на терминал не определено, будет ли вывод осуществляться в одну колонку или в несколько. Для задания одноколоночного или многоколоночного режима вывода могут использоваться опции −1 и −C, соответственно.

ОПЦИИ POSIX

Типы файлов могут принимать следующие значения: − для обычного файла, d для каталога, b для блочного устройства, c для символьного устройства, l для символической ссылки, p для FIFO и s для гнезда (socket).

По умолчанию, временной штамп является временем последней модификации; опции −c и −u позволяют выбрать два других временных штампа. Для файлов устройств, поле размера обычно заменяется на старший и младший номера устройства.

ПОДРОБНОСТИ ВЕРСИИ GNU

Если стандартный вывод является терминалом, то вывод производится в многоколоночном формате (с вертикальной сортировкой).

Программа dir (также установленная под именем d) является эквивалентом ’ls −C −b’; таким образом, файлы по умолчанию выдаются в многоколоночном формате (с вертикальной сортировкой). Программа vdir (также установленная под именем v) эквивалентна ’ls −l −b’; таким образом, файлы по умолчанию выдаются в длинном формате.

ОПЦИИ GNU

−1, −−format=single−column

Выдавать один файл на строку. Эта опция включается по умолчанию, если стандартный вывод не является терминалом.

−a, −−all

Выдавать все файлы в каталогах, включая все файлы, начинающиеся с ’.’.

−b, −−escape, −−quoting−style=escape

Заменять неграфические символы в именах файлов, используя алфавитно-цифровые последовательности, а также последовательности вида −Q, за исключением того, что имена файлов не заключаются в двойные кавычки.

−c, −−time=ctime, −−time=status

Сортировать содержимое каталога в соответствии с временем изменения состояния файла (поле ’ctime’ в inode). Если с помощью опции -l задан длинный формат, то выдавать время изменения состояния файла вместо времени его модификации.

−d, −−directory

Выдавать имена каталогов, как будто они обычные файлы, вместо того, чтобы показывать их содержимое.

−h, −−human−readable

Добавлять к каждому размеру файла букву размера, например, M для двоичных мегабайт (’мебибайт’). (Новое в fileutils-4.0.)

−i, −−inode

Выдавать номер inode (также называемый серийным номером файла и номером индекса) каждого файла, слева от его имени. (Этот номер однозначно идентифицирует каждый файл в каждой файловой системе)

−k, −−kilobytes

Если выдаются размеры файлов, то выдавать их в килобайтах.

−l, −−format=long, −−format=verbose

В дополнении к имени каждого файла, выводятся тип файла, права доступа к файлу, количество ссылок на файл, имя владельца, имя группы, размер файла в байтах и временной штамп (время последней модификации файла, если не задано другое). Для файлов с временем больше чем 6 месяцев назад или больше, чем 1 час в будущее, временной штамп содержит год вместо времени дня.

Каждый каталог со списком содержимого предваряется строкой ’total blocks’, где blocks -- это общее дисковое пространство, используемое всеми файлами в данном каталоге. По умолчанию, размер блока составляет 1024 байта; если установлена переменная окружения POSIXLY_CORRECT , то используется размер блока 512 байт (если не задана опция −k ). blocks считает каждую жесткую ссылку отдельно; задать по другому через аргументы невозможно.

Права доступа отображаются в практически обычном символьном виде, но ls комбинирует несколько битов в третий символ каждого набора прав доступа:

−m, −−format=commas

Выдавать список файлов в строчку с максимально возможным количеством имен файлов на строку, разделяя имена запятой и пробелом.

−n, −−numeric−uid−gid

Выдавать числовые UID и GID вместо имен владельца и группы.

−p, −−file−type, −−indicator−style=file−type

Добавлять символ, показывающий тип файла, к каждому имени файла. Данная опция похожа на −F, за исключением того, что исполняемые файлы не помечаются. (Фактически в fileutils-4.0 опция --file-type эквивалентна --classify.)

−q, −−hide−control−chars

Выдавать знаки вопроса вместо неграфических символов в имени файла. Эта опция включена по умолчанию.

−r, −−reverse

Сортировать содержимое каталога в обратном порядке.

−s, −−size

Выдавать размер каждого файла в блоках по 1024 байта слева от имени файла. Если установлена переменная окружения POSIXLY_CORRECT, то применяется размер блока 512, если не задана опция −k .

−t, −−sort=time

Сортировать по времени последней модификации (поле ’mtime’ в inode) вместо того, чтобы производить сортировку по алфавиту. Самые свежие файлы будут отображаться первыми.

−u, −−time=atime, −−time=access, −−time=use

Сортировать по времени последнего доступа к файлу, вместо времени последней модификации (поле ’atime’ в inode). Если задан длинный формат вывода, выдавать время последнего доступа вместо времени последней модификации.

> 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

Заметим, что цифровые части с лидирующими нулями определяются как более маленькие:

> 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

(Новое в fileutils-4.0.)

−w, −−width cols

Назначает вывод на экран в cols колонок. По умолчанию, если это возможно, данное значение узнается от драйвера терминала; в противном случае используется значение переменной окружения COLUMNS, если она установлена; в противном случае, по умолчанию, устанавливается 80.

−x, −−format=across, −−format=horizontal

Выдавать список файлов в многоколоночном режиме, с сортировкой по горизонтали.

−A, −−almost−all

Выдавать все файлы, кроме ’.’ и ’..’.

−B, −−ignore−backups

Не показывать файлы, которые заканчиваются на ’~’, если они не заданы в командной строке.

−C, −−format=vertical

Выдавать файлы в многоколоночном режиме, с сортировкой по вертикали. Опция устанавливается по умолчанию, если стандартный вывод является терминалом. Данная опция всегда устанавливается по умолчанию для программ dir и d.

−D, −−dired

При длинном формате (−l), после основного вывода, выдавать дополнительную строку вида:
//DIRED// BEG1 END1 BEG2 END2 ...

Здесь BEGn и ENDn -- это целые беззнаковые числа, которые для каждой записи показывают байтовую позицию начала и конца каждого имени файла. Таким образом, Emacs может легко найти имена, даже когда они содержат необычные символы, такие как пробелы или символы новой строки.

Если каталоги отображаются рекурсивно (−R), то похожая строка выводится после каждого подкаталога:
//SUBDIRED// BEG1 END1 ...

−F, −−classify, −−indicator−style=classify

Добавлять к каждому имени файла символ, показывающий его тип. Для обычных исполняемых файлов это ’*’. Для каталога добавляется ’/’, для FIFO - ’|’, для символических ссылок ’@’, для гнезд ’=’, для обычных файлов ничего не добавляется.

−G, −−no−group

Не отображать информацию о группе в длинном формате вывода.

−H, −−si

Делает то же, что и опция −h, но использует официальные единицы измерения SI (где для расчетов используется 1000 вместо 1024 и, таким образом, M -- это 1000000 вместо 10485576). (Новое в fileutils-4.0.)

−I, −−ignore=шаблон

Не показывать файлы, имена которых совпадают с заданным шаблоном (шаблон - это не регулярное выражение), если только они не заданы в командной строке. Как и в shell, начальная ’.’ в имени файла не совпадает с символом ’*’, заданным в начале шаблона. Чтобы спрятать ваши каталоги, вы можете просто добавить LS_OPTIONS="$LS_OPTIONS -I mystuff" в /etc/profile.

−L, −−dereference

Выдавать информацию о файлах, на которые указывают символические ссылки, вместо информации о самих символических ссылках.

−N, −−literal

Не заключать в кавычки имена файлов.

−Q, −−quote−name, −−quoting−style=c

Заключать имена файлов в двойные кавычки и показывать неграфические символы как в языке С.

−R, −−recursive

Рекурсивно выдавать список содержимого всех каталогов.

−S, −−sort=size

Производить сортировку по размеру файла, вместо сортировки по алфавиту. Таким образом, наибольшие файлы будут показаны сначала.

−T, −−tabsize cols

Назначить ширину табуляции в cols колонок. По умолчанию 8, может быть также задано с помощью переменной окружения TABSIZE, если при этом не установлена переменная окружения POSIXLY_CORRECT. ls использует табуляцию для выравнивания вывода, когда это возможно. Если cols равно нулю, то табуляция не используется.

−U, −−sort=none

Не производить сортировку; список файлов будет выдаваться в том порядке, в каком файлы записаны на диск. (отличие между опциями −U и −f состоит в том, что данная опция не запрещает и не разрешает другие опции). Эта опция может быть особенно полезна, когда выдаются списки содержимого очень больших каталогов, при этом сортировка не выполняется и весь процесс происходит быстрее).

−X, −−sort=extension

Производить сортировку в алфавитном порядке по расширениям файлов (символы после последней ’.’); файлы без расширений будут показаны первыми.

−−block−size=size

Выдает размеры в блоках по size байт. (Новое в fileutils-4.0.)

−−color[=when]

Задает цвет для различения типов файлов. Цвета задаются с использованием переменной окружения LS_COLORS. Информацию о том, как нужно задавать значение этой переменной, можно найти в странице руководства dircolors(1). Параметр when может быть опущен или принимать одно из следующих значений:

−−full−time

Выдавать время в полном, а не в стандартном сокращенном варианте. Данный формат выглядит так же, как и в команде date(1) по умолчанию; его невозможно изменить, но вы можете извлечь строку с датой через команду cut(1) и пропустить результат через ’date −d’.

Это может быть очень полезно, потому что время в таком формате включает секунды. (Файловые системы Unix записывают временной штамп файла с округлением до секунды, так что данная опция показывает полную информацию о временном штампе). Например, это может помочь, если вы разбираетесь, почему некий Makefile неправильно перегенерирует файлы.

−−quoting−style=word

Используйте стиль word для выбора режима квотинга имен файлов. Стиль word может принимать следующие значения:
literal

Вывод имен файлов как есть. Это поведение ls по умолчанию.

shell−always

Заключает имена файлов в одиночные кавычки для shell, даже если этого не требуется.

Значение по умолчанию для данной опции может быть задано в переменной окружения QUOTING_STYLE. (См. ниже главу ОКРУЖЕНИЕ).

−−show−control−chars

Выдавать неграфические символы в именах файлов как есть. Так задано по умолчанию, если вывод осуществляется на терминал, а программа называется ls.

СТАНДАРТНЫЕ ОПЦИИ GNU

−−version

Выдать информацию о версии на стандартный вывод и успешно завершиться.

ОКРУЖЕНИЕ

Переменная POSIXLY_CORRECT определяет размер блока. Переменная TABSIZE задает ширину табуляции, если не установлена переменная POSIXLY_CORRECT. Переменная COLUMNS (когда она содержит целое число) определяет ширину вывода в колонках (для использования с опцией −C). Имена файлов не должны обрезаться, чтобы уместить их в многоколоночном выводе.

При работе обычным образом используются значения переменных LANG, LC_ALL, LC_CTYPE и LC_MESSAGES. Переменная TZ задает временную зону для временных меток, которые выдает ls. Переменная LS_COLORS используется для задания цветов. Переменная LS_OPTIONS хранит опции по умолчанию.

Переменная QUOTING_STYLE используется для задания значения по умолчанию для опции −−quoting−style. Данная опция по умолчанию установлена в literal, но авторы предупреждают, что это умолчание может когда-нибудь в следующей версии измениться на shell.

ОШИБКИ РЕАЛИЗАЦИИ

В BSD системах ls выдает размеры, которые являются наполовину меньше правильных, для файлов, которые смонтированы по NFS из HP-UX систем. В HP-UX системах ls выдает размеры, которые в два раза больше правильных для файлов, которые смонтированы по NFS из BSD систем. Это недостаток систем HP-UX; он также есть и в программе ls из HP-UX.

СОВМЕСТИМОСТЬ

POSIX 1003.2

СМОТРИ ТАКЖЕ

dircolors(1)

ЗАМЕЧАНИЯ

Данная страница описывает версию ls из пакета fileutils-4.0; другие версии могут иметь небольшие отличия. Исправления и дополнения присылайте по адресу aeb [AT] cwi.nl. Отчеты об ошибках в этой программе присылайте по адресу fileutils-bugs [AT] gnu.edu.

ПЕРЕВОД

Перевёл с английского Виктор Вислобоков <corochoone [AT] perm.ru> 2003