DIR_COLORS(5)

ИМЯ
dir_colors - файл настроек для утилиты dircolors(1)

ОПИСАНИЕ
Программа ls(1) использует переменную окружения LS_COLORS для определения цветов, которыми должны отображаться имена файлов. Эта переменная окружения обычно устанавливается командой типа:
    eval `dircolors некий_путь/dir_colors`
Эта команда обычно находится в стандартном файле начальных настроек оболочки командной строки, например в /etc/profile или /etc/csh.cshrc. (Смотрите также dircolors(1).) Обычно здесь используется файл /etc/DIR_COLORS, и его настройки могут быть изменены файлом .dir_colors из каталога пользователя.

Данный файл настройки состоит из нескольких операторов, по одному в строке. Всё, что находится после символа решетки (#), считается комментарием (если этот символ находится в начале строки или перед ним находится как минимум один пробел). Пустые строки игнорируются.

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

Распознаются нижеследующие операторы (регистр букв неважен):

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

COLOR yes|all|no|none|tty
    (Только для Slackware; игнорируется GNU dircolors(1).) Указывает, что расцветка должна быть всегда разрешена (yes или all), никогда не разрешена (no или none), или разрешена, только если вывод происходит на терминальное устройство (tty). По умолчанию no.

EIGHTBIT yes|no
    (Только для Slackware; игнорируется GNU dircolors(1).) Указывает, разрешены ли по умолчанию восьмибитные символы ISO 8859. Из соображений совместимости можно также указывать 1 вместо yes или 0 вместо no. По умолчанию no.

OPTIONS параметры
    (Только для Slackware; игнорируется GNU dircolors(1).) Добавляет параметры по умолчанию к командной строке ls. Здесь можно указать любой разрешённый параметр команды ls, причем нужно указывать начальный знак минус. Заметьте, что dircolors не проверяет, допустимы ли эти параметры.

NORMAL цвет
    Задаёт цвет, используемый для нормального (не имя файла) текста.

FILE цвет
    Задаёт цвет, используемый для обычных файлов.

DIR цвет
    Задаёт цвет, используемый для каталогов.

LINK цвет
    Задаёт цвет, используемый для символьных ссылок.

ORPHAN цвет
    Задаёт цвет, используемый для нерабочих символьных ссылок (указывающих на несуществующие файлы). Если этот цвет не задан, то ls будет использовать вместо него цвет LINK.

MISSING цвет
    Задаёт цвет, используемый для отсутствующих файлов (несуществующих файлов, на которые указывают символьные ссылки). Если этот цвет не задан, то ls будет использовать вместо него цвет FILE.

FIFO цвет
    Задаёт цвет, используемый для FIFO (именованных каналов).

SOCK цвет
    Задаёт цвет, используемый для сокетов.

DOOR цвет
    (Поддерживается, начиная с fileutils 4.1) Задаёт цвет, используемый для файлов типа door (Solaris 2.5 и выше).

BLK цвет
    Задаёт цвет, используемый для специальных файлов блочных устройств.

CHR цвет
    Задаёт цвет, используемый для специальных файлов символьных устройств.

EXEC цвет
    Задаёт цвет, используемый для файлов с установленным атрибутом выполнения.

LEFTCODE цвет
    Задаёт левый код для не-ISO 6429 терминалов (см. ниже).

RIGHTCODE цвет
    Задаёт правый код для не-ISO 6429 терминалов (см. ниже).

ENDCODE цвет
    Задаёт конечный код для не-ISO 6429 терминалов (см. ниже).

*расширение цвет
    Задаёт цвет, используемый для файлов, чьи имена заканчиваются на заданное расширение.

.расширение цвет
    То же самое, что и *.расширение. Задаёт цвет, используемый для файлов, чьи имена заканчиваются указанным .расширением. Заметьте, что точка входит в состав расширения, и из-за этого невозможно указать расширение, не начинающееся с точки, например ~ для резервных копий редактора emacs. Эта форма записи считается устаревшей.

  Цветовые последовательности ISO 6429 (ANSI)
Большинство цветных ASCII-терминалов в настоящее время используют цветовые последовательности ISO 6429 (ANSI), а многие распространённые терминалы, не поддерживающие цвет, включая xterm и широко используемый и клонируемый DEC VT100, распознают цветовые коды ISO 6429 и без последствий удаляют их из выходного потока или же эмулируют их. ls по умолчанию использует коды ISO 6429, если включена расцветка. Цветовые последовательности ISO 6429 представляют собой последовательность чисел, разделённых точками с запятой. Самые распространенные коды:

     0     восстановить цвета по умолчанию
     1     включить яркие цвета
     4     подчеркнутый текст
     5     мигающий текст
    30     чёрный текст
    31     красный текст
    32     зеленый текст
    33     желтый (или коричневый) текст
    34     синий текст
    35     фиолетовый текст
    36     голубой текст
    37     белый (или серый) текст
    40     черный фон
    41     красный фон
    42     зеленый фон
    43     желтый (или коричневый) фон
    44     синий фон
    45     фиолетовый фон
    46     голубой  фон
    47     белый (или серый) фон

Не все команды будут работать на любой системе или устройстве отображения.

ls использует следующие значения по умолчанию:

    NORMAL   0                   Нормальный текст (не имя файла)
    FILE     0                   Обычный файл
    DIR      32                  Каталог
    LINK     36                  Символьная ссылка
    ORPHAN   неопределено        Сломанная символьная ссылка
    MISSING  неопределено        Отсутствующий файл
    FIFO     31                  Именованный канал (FIFO)
    SOCK     33                  Сокет
    BLK      44;37               Блочное устройство
    CHR      44;37               Символьное устройство
    EXEC     35                  Исполняемый файл

Некоторые терминальные программы неправильно распознают настройки цвета по умолчанию. Если весь текст становится расцвеченным после того, как вы просматриваете листинг каталога, измените коды NORMAL и FILE на цифровые коды для нормального цвета текста и фона.

  Другие типы терминалов (расширенная настройка)
Если у вас есть терминал (или принтер!) с поддержкой цвета (или другими возможностями выделения), который использует другой набор кодов, вы всё равно сможете создать подходящие настройки. Для этого нужно использовать операторы LEFTCODE, RIGHTCODE и ENDCODE.

При выводе имени файла ls генерирует такую последовательность: LEFTCODE кода_типа RIGHTCODE имя_файла ENDCODE, где код_типа — цветовая последовательность, зависящая от типа или имени файла. Если ENDCODE не определён, то вместо него будет использоваться последовательность LEFTCODE NORMAL RIGHTCODE. Предназначением левого (LEFTCODE) и правого (RIGHTCODE) кодов является сокращение количества информации, которую нужно набирать (а также спрятать уродливые escape-последовательности от пользователя). Если они не подходят для вашего терминала, их можно выключить, поместив соответствующее ключевое слово на отдельной строке.

ЗАМЕЧАНИЕ: Если ENDCODE определён в глобальном разделе файла настроек, то его нельзя переопределить в разделе определённого терминала. Это означает, что все определения NORMAL не приведут ни к какому результату. Однако, можно использовать различные ENDCODE, что и приведёт к нужному результату.

  Экранированные последовательности
Для того, чтобы указать в цветовых последовательностях или расширениях имён файлов управляющие символы или пробелы, можно использовать либо нотацию в стиле языка C с помощью обратной косой черты, либо нотацию в стиле программы stty с помощью символа ^. Нотация в стиле языка C включает в себя такие символы:

    \a       Звонок (ASCII 7)
    \b       Забой (ASCII 8)
    \e       Escape (ASCII 27)
    \f       Прогон страницы (ASCII 12)
    \n       Новая строка (ASCII 10)
    \r       Возврат каретки (ASCII 13)
    \t       Табуляция (ASCII 9)
    \v       Вертикальная табуляция (ASCII 11)
    \?       Удаление (ASCII 127)
    \nnn     Любой символ (код в восьмеричной системе)
    \xnnn    Любой символ (код в десятичной системе)
    \_       Пробел
    \\       Обратная косая черта (\)
    \^       Крышка (^)
    \#       Решётка (#)

Заметьте, что escape-символы необходимы, чтобы использовать пробел, обратную косую черту, крышку или управляющие символы в любом месте строки, а также символ решётки в качестве первого символа в строке.

ФАЙЛЫ

/etc/DIR_COLORS
    Общесистемный файл настройки

~/.dir_colors
    Пользовательский файл настройки

Эта страница описывает формат файла dir_colors, который можно найти в пакете fileutils-4.1; другие версии могут немного отличаться.

ЗАМЕЧАНИЯ
Значение LEFTCODE и RIGHTCODE, используемые по умолчанию терминалами ISO 6429:

    LEFTCODE  \e[
    RIGHTCODE m

По умолчанию значение ENDCODE не определено.

СМОТРИТЕ ТАКЖЕ
dircolors(1), ls(1), stty(1), xterm(1)