LS(1)

ИМЯ
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

-C  Напечатать список файлов в колонках с вертикальной сортировкой.

-F  Для каждого имени каталога добавлять суффикс `/', для каждого имени FIFO - `|' и для каждого имени исполняемого файла `*'.

-R  Включить рекурсивную выдачу списка каталогов.

-a  Включать в список файлы с именем, начинающимся с `.'.

-c  Использовать при сортировке (при задании опции -t или -l) время изменения состояния файла вместо времени последней модификации файла.

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

-i  Предварять вывод для каждого файла его серийным номером (номером inode).

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

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

-r  Производить сортировку в обратном порядке.

-t  Сортировать по показываемому временному штампу.

-u  Использовать при сортировке (опция -t) или перечислении (опция -l) время последнего доступа к файлу вместо времени последней модификации файла.

-1  Выдавать в одноколоночном формате.

--  Завершает список опций.

ПОДРОБНОСТИ ВЕРСИИ 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
    Выдавать имена каталогов, как будто они обычные файлы, вместо того, чтобы показывать их содержимое.

-f  Не сортировать содержимое каталога; выдавать файлы в том порядке, в котором они записаны на диск. Эта опция также разрешает -a и -U и запрещает -l, --color, -s, и -t, если они были заданы перед -f.

-g  Игнорируется; нужна для совместимости с Unix.

-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 комбинирует несколько битов в третий символ каждого набора прав доступа:

    s   Если setuid или setgid бит установлены вместе с соответствующим битом прав на выполнение.

    S   Если setuid или setgid бит установлены, но соответствующий бит прав на выполнение не установлен.

    t   Если sticky-бит установлен вместе с битом прав на выполнение остальными.

    T   Если sticky-бит установлен, но бит прав на выполнение остальными нет.

    x   Если бит прав на выполнение установлен, и не выполняется ни одно из вышеуказанных условий.

    -   Во всех остальных случаях.

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

-n, --numeric-uid-gid
    Выдавать числовые UID и GID вместо имен владельца и группы.

-o  Применять длинный формат, но не показывать информацию о группе. Данная опция эквивалентна --format=long --no-group. Данная опция предоставляется для совместимости с другими версиями ls.

-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). Если задан длинный формат вывода, выдавать время последнего доступа вместо времени последней модификации.

-v  Производить сортировку в соответствии с номером версии файлов. При этом учитывается, что имена файлов часто содержат номера версий или порядковые номера. Стандартные функции сортировки обычно не обеспечивают сортировку, которую мог бы ожидать человек, так как сортировка производится на основе посимвольного сравнения. Сортировка по версиям решает эту проблему и особенно полезна, когда производится просмотр каталогов, содержащих много файлов, у которых в имени есть номер версии. Например:
         > 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 может быть опущен или принимать одно из следующих значений:

    none
        Вообще не использовать цвет. Установлено по умолчанию.

    auto
        Использовать цвет, только если стандартный вывод является терминалом.

    always
        Всегда использовать цвет. Задание --color без параметра when эквивалентно --color=always.

--full-time
    Выдавать время в полном, а не в стандартном сокращенном варианте. Данный формат выглядит так же, как и в команде date(1) по умолчанию; его невозможно изменить, но вы можете извлечь строку с датой через команду cut(1) и пропустить результат через `date -d'. Это может быть очень полезно, потому что время в таком формате включает секунды. (Файловые системы Unix записывают временной штамп файла с округлением до секунды, так что данная опция показывает полную информацию о временном штампе). Например, это может помочь, если вы разбираетесь, почему некий Makefile неправильно перегенерирует файлы.

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

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

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

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

    c   Заключает имена файлов в двойные кавычки, как в языке C; это равносильно опции -Q.

    escape
        Как и для c, за исключением того, что имя не заключается в двойные кавычки; эквивалентно опции -b .

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

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

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

--help
    Выдать подсказку на стандартный вывод и успешно завершиться.

--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@cwi.nl. Отчеты об ошибках в этой программе присылайте по адресу fileutils-bugs@gnu.ai.mit.edu.

ПЕРЕВОД
Перевёл с английского Виктор Вислобоков <corochoone@perm.ru> 2003