MASTER(4)

НАЗВАНИЕ
master - основной файл с информацией об устройствах

ОПИСАНИЕ
Файл master используется утилитой config(1M) для получения информации об устройствах, на основаниии которой генерируются конфигурационные файлы low.s и conf.c. Утилита config читает dfile и помещает информацию из каждого элемента первой части в массивы, заготовленные по основному файлу master. Для получения информации о получаемых файлах см. config(1M), а о значении полей в первой части поддерживаемого пользователем файла dfile см. dfile(4). Файл master состоит из пяти частей, разделенных символом $ в первой колонке. Любая строка, содержащая звездочку в первой колонке или звездочку, перед которой находятся только пробелы и табуляции, считается строкой комментария.

Часть 1 содержит информацию об устройствах; в части 2 задаются дополнительные имена устройств; часть 3 содержит информацию о настраиваемых параметрах. В частях 4 и 5 располагается информация, относящаяся к конфигурации систем только для семейства M68000. Часть 4 (спецификация микропроцессора) должна присутствовать в файле master и не должна присутствовать в файле dfile. Часть 5 содержит строки в точности того же формата, что и специфическая для M68000 часть в dfile(4).

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

Первая часть
Часть 1 содержит строки по 10 полей в каждой. Поля разделяются пробелами.

Поле 1 - имя устройства (не более 8 символов).

Поле 2 - размер (десятичный) векторов прерываний; размер есть количество векторов, умноженное на четыре.

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

sСамостоятельные программы открытия и закрытия для блочных и символьных устройств. Так, комбинация букв sO означает, что для диска программа открытия его как блочного устройства будет называться hdbopen, а как символьного - hdcopen.
tУстройство имеет структуру терминала.
iОбработка (выполнение) инициализации.
pОбработка ошибки питания.
OОбработка открытия.
CОбработка закрытия.
RОбработка чтения.
WОбработка записи.
IОбработка управляющих действий.
SДрайвер потока. Других обработчиков у него быть не должно.

Поле 4 - индикатор типа устройства. Для каждого нужного индикатора следует задать соответствующую букву; если индикатор не существует, вместо буквы указывается символ -. Допустимы следующие спецификации:

vСоздать массив векторов прерывания, например, hd_ivec [ ]. Для каждого вектора, описанного в файле dfile, в массив помещается (шестнадцатеричный) адрес вектора (номер вектора умножается на 4).
mСоздать для устройства символьный старший номер и блочный старший номер (например, hd_cmaj и hd_bmaj).
lСоздать массив уровней прерываний, например, hd_ilev [ ]; уровни прерывания указаны в четвертом поле, уровень, каждой строки в первой части файла dfile.
oРазрешить только одно данное устройство.
cНе вставлять счетчик в файл conf.c.
iНе вставлять вектор прерываний.
RТребуемое устройство.
BБлочное устройство.
CСимвольное устройство.
IУстройство, управляемое прерываниями, не блочное и не символьное.
aРазрешить определения одного вектора с многими адресами.

Поле 5 - префикс обработчика (не более 4 символов), например hd.

Поле 6 - размер страницы регистров (десятичный), то есть размер области памяти для всех регистров устройства, начинающейся по адресу, указанному в файле dfile.

Поле 7 - старший номер блочного устройства; символ -, если такового нет.

Поле 8 - старший номер символьного устройства; символ -, если такового нет.

Поле 9 - максимальное количество устройств на контроллер (десятичное); например, 32. Значение необязательного поля число (пятое поле в строках первой части файла dfile) замещает значение, указанное в поле 9 файла master.

Поле 10 - максимальный уровень запроса шины (от 1 до 7); символ -, если такового нет.

Для устройств, которые не управляются прерываниями, размер вектора прерываний (поле 2) должен быть нулевым. Буква v в поле 4 приводит к тому, что config(1M) записывает вектора прерываний, хотя в первой части программы low.s не окажется присваиваний соответствующим элементам вектора (прерывания в таком случае будут классифицироваться как случайные).

Вторая часть
Часть 2 содержит строки, состоящие из двух полей:

Поле 1 - дополнительное имя устройства (не более 8 символов).

Поле 2 - соответствующее основное имя устройства (не более 8 символов; устройство описано в части 1).

Третья часть
Часть 3 составляют строки, состоящие из одного или двух полей:

Поле 1 - имя параметра (не более 30 символов).

Поле 2 - подразумеваемое значение параметра (не более 30 символов; если это поле пустое, то предполагается, что параметр определяется в файле dfile).

Четвертая часть
Часть 4 содержит одну строку, состоящую из 2 полей и содержащую спецификацию микропроцессора.

Поле 1 записывается как mpu.

Поле 2 - одно из чисел: 68000, 68010, 68020 или 68030.

Пятая часть
Часть 5 содержит специфическую для M68000 информацию, имеющую в точности тот же формат, что и специфическая для M68000 часть в файле dfile. Смысл этой информации описан в dfile(4).

ФАЙЛЫ


/usr/src/uts/dfile

/usr/src/uts/master

/usr/src/uts/low.s

/usr/src/uts/conf.c

/usr/include/sys/conf.h

СМ. ТАКЖЕ
dfile(4).
config(1M) в Справочнике администратора.