Сборка русских man-ов.
man (от англ. manual — руководство) — команда Unix, предназначенная для форматирования и вывода справочных страниц.
ls - вывод содержимого каталога
ИМЯ
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
-
Заменять неграфические символы в именах файлов, используя
алфавитно-цифровые последовательности, а также последовательности вида
\
000' с восьмеричными цифрами, как в языке C. Данная опция аналогична
-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)
ПЕРЕВОД
Перевёл с английского Виктор Вислобоков <
corochoone@perm.ru> 2003