Протоколы Internet
         

Сетевые драйверы


7.2 Сетевые драйверы

Семенов Ю.А. (ГНЦ ИТЭФ)

Читатели, знакомые с телекоммуникационными протоколами, могут заинтересоваться тем, как писать прикладные программы для работы с пакетами. Прикладная программа взаимодействует с драйвером сетевого интерфейса. Ethernet-интерфейс, как и всякий другой, содержит несколько статусных управляющих регистров (CSR) и один или несколько регистров данных. Запись (чтение) в эти регистры выполняется в IBM/PC с помощью команд IN (OUT). Каждому регистру ставится в соответствие определенный номер порта. Блок номеров портов задается с помощью переключателей на интерфейсе или в процессе постановки пакетного драйвера. В последнем случае в AUTOEXEC-файле должна присутствовать строка, например (для DOS):

NE2000 0x60 0x5 0x300

, (если ваша ЭВМ снабжена интерфейсом типа NE2000).

Здесь предполагается, что интерфейс будет использовать номер прерывания 0x60, аппаратное прерывание 0x5 и блок портов, начиная с шестнадцатеричного адреса 0x300 (io_addr). Следует иметь в виду, что разные интерфейсы могут иметь разное число CSR-регистров и отличные от приведенных ниже функции (NE2100). Интерфейс характеризуется тремя целыми числами: класс (8 бит), тип (16 бит) и номер. Класс говорит о том, для какой из сетевых сред предназначен данный прибор (PPP, DIX Ethernet, IEEE 802.3, IEEE 802.5, Pronet-10, Appletalk и т.д.). Тип описывает конкретную реализацию интерфейса (NE2000, NI5210, 3C501 и т.д.). Тип 0xffff соответствует всем интерфейсам данного класса. В случае, когда ЭВМ оснащена более чем одним интерфейсом идентичного типа, для их идентификации используется номер. На рис. 7.2.1 показана структура управляющего (CSR) регистра сетевого интерфейса. В таблице 7.2.1 приведен перечень основных классов с примерами определенных типов интерфейсов.

Сетевые драйверы

Рис. 7.2.1.А Структура CSR-регистра интерфейса (CSR0)

Init инициализация (initialize); Strt старт; Stop стоп; Tdnd запрос передачи (transmit demand); Txon включение передачи; Rxon включение приема; Inea разрешение прерываний (interrupt enable); Intr прерывание; Idon инициализация выполнена (стирание записью 1); Tint прерывание при передаче (стирание записью 1); Rint прерывание при чтении (стирание записью 1); Merr ошибка при тайм-ауте на шине (стирание записью 1); Miss нет буфера для приема (стирание записью 1); Cerr ошибка из-за столкновения (стирание записью 1); Labl тайм-аут при передаче (стирание записью 1); Err ошибка типа Babl, Cerr, Miss, Merr (только для чтения). CSR1 (доступ разрешен при CSR0[stop] = 1)

Сетевые драйверы

Рис. 7.2.1.Б. CSR1

CSR2 (доступ разрешен при CSR0[stop] = 1)

Сетевые драйверы

Рис. 7.2.1В. CSR2

Bcon 0 = <0:7> перестановка байтов адресов
Acon 0 = ale, 1 = /as
Bswp 0 = /bm1, bm0, /hold;
csr3 (доступ разрешен при CSR0[stop] = 1)

Сетевые драйверы

Рис. 7.2.1.Г. CSR3

Таблица 7.2.1.

Сетевая среда Класс Фирма, интерфейс Тип интерфейса
dec/intel/Xerox 1 3com 3C500/3C501 1
"Bluebook" ethernet 3com 3C505 2
Interlan NI5010 3
Micom-Interlan NP600 6
Ungermann-bass PC-nic 8
Univation NC-516 9
TRW PC-2000 10
Interlan NI5210 11
3com 3C503 12
3com 3C523 13
Western digital WD8003 14
Spider systems S4 15
Torus frame level 16
10net communications 17
Gateway PC-bus 18
Gateway at-bus 19
Gateway MCA-bus 20
IMC PCnic 21
1 IMC PCnic II 22
Micromatic research 25
Clarkson "multiplexor" 26
D-link 16-bit 28
D-link ps/2 29
Research machines 16 31
Research machines MCA 32
Interlan NI9210 34
Interlan NI6510 35
Novell NE2000 36
Allied telesis pc/xt/at 38
Allied telesis NEC PC-98 39
Ungermann-bass NIC/PS2 41
Tiara lancard/E AT 42
Tiara Lancard/E MC 43
Tiara Lancard/E TP 44
AT&T Starlan NAU 47
AT&T Starlan-10 NAU 48
AT&T Ethernet NAU 49
Pronet-10 2 Proteon P1300 1
Proteon P1800 2
IEEE 802.5/pronet-4

IBM Token Ring интерфейс		 3 Proteon P1340 2
Proteon P1344 3
Gateway PC-bus 4
Gateway AT-bus 5
Gateway MCA-bus 6
Omninet 4
Appletalk 5
Последовательный интерфейс 6 Clarkson 8250-slip 1
Clarkson "multiplexor" 2
Starlan 7
Arcnet 8 Datapoint RIM 1
AX.25 9
KISS 10
IEEE 802.3 w/802.2 HDRS 11
FDDI W/802.2 HDRS 12
Internet X.25 13 Western Digital 1
N.T. Lanstar (encap. dix) 14 NT Lanstar/8 1
NT Lanstar/mc 2
SLFP 15
Netrom 16
Nclass 17
<


/p> Любой пакетный драйвер имеет блок исходных данных (MS-DOS), напр.:

EADDR_LEN equ 6 ; длина физического адреса
init_block struc
init_mode dw 0
init_addr db eaddr_len dup(?) ; ethernet-адрес
init_filter db 8 dup(0) ; Логический адресный фильтр (multicast filter).
init_receive dw ?,? ; Указатель входного кольцевого буфера
init_transmit dw ?,? ; Указатель выходного кольцевого буфера.
init_block ends
Структура переменных init_mode (смещение = 0) имеет вид

Сетевые драйверы

Рис. 7.2.2. Структура переменных init_mode

Drx запрет приема;
Dtx запрет передачи;
Loop цикл;
Dtcr запрет передачи crc;
Coll столкновение;
Drty запрет повторов;
Intl внутренний цикл;
Prom режим приема всех пакетов (promiscuous mode).
Кольцевой входной буфер имеет следующую структуру:

rcv_msg_dscp struc
rd_addr dw ? ; Младшая часть адреса входного буфера
rd_stat dw ? ; Статусная часть + старшая часть адреса
rd_bcnt dw ? ; Размер буфера в байтах
rd_mcnt dw ? ; Длина сообщения в байтах
rcv_msg_dscp ends
Структура переменных rd_stat имеет вид

Сетевые драйверы

Рис. 7.2.3. Структура переменных rd_stat

Enp конец пакета;
Stp начало пакета;
Buff ошибка в буфере;
CRC CRC-ошибка;
Oflo переполнение буфера;
Fram ошибка при записи в буфер;
Err наличие ошибки;
Own 0 = полное заполнение.
Выходной буфер имеет сходную структуру.

Я не буду описывать здесь то, как следует писать системные драйверы (Исчерпывающую информацию по написанию таких драйверов читатель может найти в книге "Написание драйверов для MS-DOS" Р.Лея и "Уэйт Груп", Москва "Мир", 1995), тем более что существует достаточное их количество в депозитариях общего доступа (Например, анонимное FTP по адресам ftp.funet.fi, ftp.switch.ch или oak.oakland.edu, депозитарий SimTel ). Приведенное выше описание регистров интерфейса не является единственно возможным (см. также руководство по сетевому контроллеру 8390 и файл NE2.ASM из ссылки ftp.funet.fi. Структура драйверов варьируется для разных операционных систем. Для системных программистов полезно иметь возможность настраивать драйвер или непосредственно интерфейс на определенный режим, например, на прием всех пакетов, проходящих по кабельному сегменту. Последнее может представлять интерес в диагностических целях, так как вслед за пакетным драйвером загружается Etherdrv, Winsock или winpkt и т.д., блокирующие режим приема всех пакетов (mode=6). Ниже приведен пример описания основных параметров драйвера:

BLUEBOOK equ 1
IEEE8023 equ 11
ADDR_LEN equ 6 ; размер Ethernet-адреса
MAX_M_CAST equ 8 ; максимальное число мультикаст-адресов.
<


/p>
Public int_no, io_addr
int_no db 2,0,0,0 ; должно иметь 4 байта для get_number.
io_addr dw 0300h,0 ; I/O адрес карты (переключатели)
public driver_class driver_type, driver_name, driver_function, parameter_list
driver_class db BLUEBOOK, IEEE8023, 0 ; из спецификации интерфейса
driver_type dw 54 ; из спецификации интерфейса
driver_name db 'NE2000',0 ; имя драйвера.
driver_function db 2
parameter_list label byte
db 1 ;
db 9 ;
db 14 ; длина списка параметров в байтах
db ADDR_LEN ; длина адреса MAC-уровня в байтах
dw GIANT ; MTU, включая MAC-заголовок
dw MAX_M_CAST * ADDR_LEN
; размер буфера для мультикаст-адресов

dw 0 ;(# принимаемых подряд пакетов с; размером MTU) - 1
dw 0 ; (# посылаемых подряд пакетов) - 1
int_num dw 0 ; Номер прерывания
Работа с пакетным драйвером в MS-DOS

Существует множество пакетных драйверов. Можно обнаружить несколько модификаций для одного и того же типа интерфейса. Эти драйверы могут быть ориентированы на работу в разных программных средах (Novell, UNIX, MS-DOS и т.д.) и иметь разные возможности. Для MS-DOS сложился неофициальный стандарт, который позволяет использовать драйвер для самых разных приложений. Драйвер может использовать минимум возможностей интерфейса (базовый уровень), реализовать более широкий набор функций (мультикастинг, сбор статистики и т.д.) или поддерживать практически все, на что способен данный прибор. В последнем случае он занимает больше места в памяти. Описания операций с пакетными драйверами, приведенные ниже, выполнены в нотации ассемблера IBM/PC. При написании программы следует помнить, что порядок байтов в Ethernet противоположен тому, который используется в вашей IBM/PC.

Пакетные драйверы используют программные прерывания в интервале 0x60 - 0x80. Следует сразу заметить, что не все прерывания из этого списка свободны и при конфигурировании системы следует проявлять осмотрительность. Для того чтобы избежать конфликтов с другими внешними устройствами, предусматривается возможность реконфигурации прерываний. Предполагается, что программа обработки прерываний начинается с команды безусловной передачи управления (JMP), за которой следует текстовая строка "PKT DRVR". Именно эта строка служит указателем при поиске адреса пакетного прерывания. Практически все драйверы могут работать с различными протоколами (TCP/IP, OSI и др.). Решить задачу мультиплексирования на связном уровне помогает процедура access_type, которая обеспечивает доступ для пакетов определенного типа.



Все функции реализуются с помощью обращения к драйверу с набором определенных параметров. При этом значение регистра AH определяет тип запроса. Каждому типу используемого сетевого протокола, с которым работает интерфейс, ставится в соответствие целочисленный указатель (handle), получаемый с помощью процедуры access_type. Выполнимость драйвером тех или иных операций может быть выяснена с помощью запроса driver_info.

При работе с драйвером следует проявлять осторожность и спасать нужные вам регистры. Следует также помнить, что порядок байтов в PC и в некоторых сетях, включая Ethernet, не совпадает. Описание основных запросов, посылаемых пакетному драйверу:



1. Получение информации о типе и функциональных возможностях драйвера



driver_info AH == 1,

AL == 255 (код запроса)
public

_driver_info

_driver_info

proc near

mov AX, 1FFH

; ah=1, al=255

call int_pkt

; обращение к драйверу

jnc lv

mov AX, seg _PARAM.ER_CODE

mov DS, AX

mov _PARAM.ER_CODE, 272

; Устанавливаем код "Нет инф. о драйвере"

lv:

ret

_driver_info

endp

int_pkt:

; Подпрограмма обращения к драйверу

push ds

push es

pushf

cli

call _param.Handler

; адрес _param.Handler должен быть определен раньше

pop es

pop ds

ret

Целочисленный указатель (handle) должен быть занесен в регистр BX (для старых драйверов). В случае ошибки устанавливается флаг carry, а код ошибки заносится в регистр DH. Сообщение BAD_HANDLE (неверный указатель) возможно только для старых драйверов. При благополучном исполнении флаг carry равен нулю, а в регистры будет занесены следующие параметры:

BX версия;
CH класс;
CL номер;
DX тип;
DS:SI указывают на строку имени драйвера;
AL функциональные возможности.
AL = 1 гарантируется выполнение базовых функций;
= 2 обеспечено выполнение базового и расширенного набора функций;
= 5 выполняется базовый и экстра-набор функций;
= 6 выполним полный набор функций;
= 255 драйвер не установлен.
<


/p> Ниже приведен пример программы, реализующей некоторые из описанных запросов.

.MODEL small
PUBLIC _INFACE
VERSION EQU 1
EXTRN _PARAM:BYTE
EXTRN _Q:BYTE
.DATA

INCLUDE DEF.ASM ; Определения некоторых констант
P_LIST STRUC
LINTN DB 32 dup(0) ; Список активных номеров прерываний
HANDLES DW ?
HANDLEP DW ?
ER_CODE DW ?
ERNUM DW ? ; Код ошибки
HANDLER DD ?
MODE DW ? ; Текущий режим приема пакетов
MLIST DB 0,0,0,0,0,0 ; Список допустимых режимов; 1 => имеется
PKT_IN DW ?,? ; Диагностический массив
pkt_out DW ?,?
byte_in DW ?,?
byt_out DW ?,?
err_in DW ?,?
err_out DW ?,?
pk_drop DW ?,?
L1 DW 0 ; Версия драйвера
L2 DW 0 ; класс/номер
L3 DW 0 ; Тип
L4 DW 0 ; Функция
_NAME DB 0,0,0,0,0,0,0,0,0,0 ; Имя интерфейса
ETHER_ADR DB ADDR_LEN dup(-1) ; Ethernet-адрес
S_ADR DB EADDR_LEN+5 dup(-1) ; Ethernet-адрес получателя
D_ADR DB EADDR_LEN+5 dup(-1) ; Ethernet-адрес отправителя
P_LIST ENDS
QUEUE STRUC
Leng DW 15000,? ; Длина очереди
Tail DW ? ; Смещение последнего элемента очереди
Head DW ? ; Смещение первого элемента очереди
_end DW ? ; Указатель на конец очереди
p_len DW ? ; Длина пакета
P_start DW ? ; Указатель на текущий пакет = Q_head - Q_begin +2
NEW DB 0 ; Флаг нового пакета
Line DB ? ; Строка экрана
Npacks DD 0 ; Счетчик принятых пакетов
B DW ? ; смещение Q_beg
Point DW 380 dup(?)
Beg DB 31000 dup(?) ; Пакетный буфер
QUEUE ENDS
ether_bdcst DB EADDR_LEN dup(-1) ; Широковещательный адрес Ethernet, заполненный -1.
ether_addr DB EADDR_LEN dup(-1)
bogus_type DB 0,0;
signature DB 'PKT DRVR',0 ; Сигнатура пакетного драйвера
signature_len equ $-signature
SAFE DW ?
DFLAG DB 0
<


/p> .CODE

PUBLIC _INFACE
_INFACE PROC NEAR
CLD
MOV DFLAG, 0 ; Очистка флага драйвера
MOV _PARAM.ER_CODE, 0 ; Очистка флага ошибки
PUSH BP ; Спасение регистров
MOV BP, SP
PUSH SI
PUSH DI
PUSH ES
PUSH DS
MOV CX, 32
MOV AL, 60H ; Установка начального номера прерывания
LEA SI, _PARAM.LINTN ; Формирование указателя на список номеров прерывания
CHECK: PUSH AX
PUSH CX
PUSH SI
CALL CHK_INT
POP SI
POP CX
MOV byte ptr [SI], 0 ;
JNE NO_SIGNATURE
INC DFLAG ; Установка флага <Это драйвер>
MOV BYTE PTR [SI], 1 ; Установка флага наличия
NO_SIGNATURE:

POP AX
INC AL ; Следующий номер прерывания
INC SI ; Актуализация указателя
LOOP CHECK
CMP DFLAG, 0 ; Драйвер присутствует?
JNE HAVE_SIGNATURE
MOV _PARAM.ER_CODE, 271 ; Установка флага <No signature>
JMP OKAY
INT_PKT:

PUSH ES
pushf
cli
call _PARAM.HANDLER
POP ES
RET
CHK_INT: PUSH ES ; AL = номер прерывания
PUSH DI
MOV AH, 35H ; Получение вектора прерывания
INT 21H ; ES:BX=seg:offs драйвера
MOV _PARAM.HANDLER.OFFS,BX ; Записываем адрес драйвера
MOV _PARAM.HANDLER.SEGM, ES
LEA DI, 3[BX] ; Устанавливаем смещение сигнатуры драйвера
MOV SI, OFFSET SIGNATURE ; Проверка сигнатуры драйвера
MOV CX, SIGNATURE_LEN ; Присутствует ли здесь драйвер?
REPE CMPSB ; DS:[SI] - ES:[DI]
<


/p>
POP DI
POP ES
RET
HAVE_SIGNATURE:

MOV CX, 32 ; Установка начального значения счетчика
LEA SI, _PARAM.LINTN ; Устанавливаем указатель списка
MOV AL, 60H ; Задаем начальный номер прерывания
CHOICE: CMP BYTE PTR [SI], 0
JNE SETDRV
INC AL
LOOP CHOICE
SETDRV: MOV AH, 35H
INT 21H
MOV _PARAM.HANDLER.OFFS,BX ; Определяем адрес драйвера
MOV _PARAM.HANDLER.SEGM, ES
PUSH DS
POP ES
MOV CX, EADDR_LEN
MOV SI, OFFSET ETHER_ADDR
MOV DI, OFFSET ETHER_BDCST
REPE CMPSB
JE GET_MODE ; Адрес не определен
MOV AH, 25 ; Записываем ethernet-адрес
MOV DI, offset ETHER_ADDR
MOV CX, EADDR_LEN
call int_pkt
MOV _PARAM.ER_CODE, DX ; Устанавливаем код ошибки
JMP OKAY
GET_MODE:

MOV SAFE, DS ; Спасаем DS
PUSH DS
MOV AH, 2 ; Открываем доступ пакетам
MOV AL, 1 ; Класс интерфейса
MOV BX, -1 ; Тип интерфейса
MOV DL, 0 ; Номер интерфейса
MOV CX, 2 ; Используем длину type = 2
MOV SI, OFFSET BOGUS_TYPE
PUSH CS ; ES:DI -> Receiver.
POP ES
MOV DI, OFFSET RECEIVER
call INT_PKT
JNC $_$
MOV _PARAM.ER_CODE, DX ; Устанавливаем код ошибки
$_$: MOV _PARAM.HANDLES, AX ; Записываем указатель-Handle
MOV AH, 6 ; Определяем ethernet-адрес интерфейса
PUSH DS
POP ES
MOV DI, offset _PARAM.ETHER_ADR
MOV CX, EADDR_LEN
MOV BX, _PARAM.HANDLES
call int_pkt
JNC NOBAD
MOV _PARAM.ER_CODE, 273 ; Ошибка при определении Ethernet-адреса
POP DS
JMP OKAY
<


/p> NOBAD:

MOV AX, 1FFH ; Запрашиваем информацию о драйвере
MOV BX, _PARAM.HANDLES ; Устанавливаем указатель
call INT_PKT
JNC N_BAD
MOV _PARAM.ER_CODE, 272 ; Ошибка при получении информации о драйвере
POP DS
JMP OKAY
N_BAD: PUSH DS
PUSH SS
&nsp; POP DS
MOV ES, SAFE
MOV _PARAM.L1, BX ; Версия драйвера
MOV _PARAM.L2, CX ; номер/класс
MOV _PARAM.L3, DX ; Тип
MOV _PARAM.L4, AX ; Функциональность
LEA BX, _PARAM._NAME
POP DS
MOV CX, 8
ZFIND: CMP byte ptr [SI], 0
MOV AL, byte ptr [SI]
MOV byte ptr ES:[BX], AL
JE ZERO_
INC SI
INC BX
LOOP ZFIND
ZERO_: POP DS
MOV AH, 21 ; Запрашиваем код режима приема пакетов
MOV BX, _PARAM.HANDLES
call INT_PKT
MOV _PARAM.MODE, AX ; Записываем код режима
.........................

OKAY: POP DS
POP ES
POP DI
POP SI
MOV SP, BP
POP BP
RET
RECEIVER: ; Подпрограмма RECEIVER, вызываемая при получении пакета
OR AX, AX ; Первый или второй вызов?
JNE RECV
MOV AX, seg _Q.beg ; Указатель буфера ES:DI
MOV ES, AX
MOV DI, offset _Q.beg
RECV: RETF
2. Организация доступа для пакетов данного типа

access_type(if_class, if_type, if_number, type, typelen, receiver)

AH ==2 (код запроса)

Запрос access_type инициализирует доступ для пакетов определенного типа (type). Аргумент typelen – длина спецификации типа в байтах, для PC/TCP равна 5 (наименьшее значение - 2, для IP и ARP). Аргумент receiver является указателем на подпрограмму, которая вызывается при приеме пакета. Получая пакет, драйвер дважды обращается к этой программе. Первый раз (при AX==0) это делается с целью получения адреса буфера, куда должен быть положен пакет. Прикладная программа в этом случае должна выдать указатель буфера в регистры ES:DI. Если прикладной процесс не имеет свободного буфера,то возвращается значение 0:0. Пакет выбрасывается и повторное обращение к программе receiver отменяется. Форма реализации запроса аналогична приведенному для driver_info:

Int if_class; AL ; класс интерфейса
Int if_type; BX ; тип интерфейса
Int if_number; DL ; номер интерфейса
Char far *type; DS:SI
Unsigned typelen; CX
Int (far *receiver); ES:DI
<


/p>
access: mov ah, 2
mov al, ch ; установка класса; здесь предполагается, что содержимое регистров соответствует тому, что получено в результате обращения к driver_info
mov bx, dx ; устанавливаем параметр type
mov dl, cl ; устанавливаем параметр number, при одном интерфейсе number=0
xor cx, cx ; длина type равна нулю
push cs ; устанавливаем сегментный регистр receiver
pop es
mov di, offset RECEIVER ; вызов подпрограммы receiver
call int_pkt ; обращение к пакетному драйверу
В случае ошибки флаг carry=1, а в регистр DH заносится код ошибки. Возможные ошибки:

2 NO_CLASS не найдено интерфейса указанного класса;
3 NO_TYPE не найдено интерфейса указанного типа;
4 NO_NUMBER не найдено интерфейса с указанным номером;
5 BAD_TYPE специфицирован неправильный тип пакета;
9 NO_SPACE недостаточно места в памяти;
10 TYPE_INUSE было обращение к данному типу и он пока занят.
При успешном выполнении запроса флаг carry=0, а в регистр AX занесен указатель (handle).

Обращение к приемнику (receiver):

(*receiver)(handle, flag, len [, buffer])

int handle; BX ; указатель
int flag; AX ; флаг вызова(0/1)
unsigned len; CX ; целое без знака - длина пакета
if AX == 1,

char far *buffer; DS:SI ; адрес буфера
Если параметр typelen равен нулю, прикладной процесс готов получать все пакеты. Очень важно, чтобы при первом обращении к receiver (AX==0) CX (длина пакета) была указана правильно, что позволит выделить нужное место в памяти. CX должна включать в себя длину MAC-заголовка и размер самого сообщения без контрольной суммы (CRC). Повторный вызов (AX==1) программы receiver указывает на то,что пакет записан в буфер и прикладная программа может с ним работать. Адрес буфера будет указан в регистрах DS:SI.



3. Завершение доступа пакетов данного типа release_type



int release_type(handle) AH == 3;

код запроса int handle;



BX ; указатель определяет тип пакетов

_release_type proc near

push bp ; спасение регистров
push ds
push es
mov ah, 3 ; задаем код запроса
mov bx, _param.handle ; заносим указатель
pushf
cli
call _param.handler ; обращение к драйверу
mov _param.er_CODE, dx ; занесение кода ошибки
pop es ; восстановление регистров
pop ds
pop bp
ret
_release_type endp
В случае ошибки флаг carry=1, а в регистр DH заносится код ошибки. Возможная ошибка: BAD_HANDLE (не верный указатель). При успешном выполнении запроса флаг carry=0. Эта операция прерывает доступ пакетов, соответствующих указателю, полученному с помощью запроса access_type. Старый указатель после выполнения этого запроса не действителен.



4. Процедура посылки пакета send_packet(buffer, length)



AH == 4 (код запроса)

char far *buffer; DS:SI (адрес буфера)

unsigned length; CX (длина пакета в байтах)

В случае ошибки флаг carry=1, а в регистр DH заносится код ошибки 12 CANT_SEND. send_packet отправляет пакет с числом байт, равным CX. Пакет должен в исходный момент лежать, начиная с адреса DS:SI. Прикладная программа должна сформировать все необходимые заголовки. Информация, нужная для осуществления демультиплексирования пакетов (MAC или LLC), также должна быть записана в пакет, так как при этом запросе не сообщается значение указателя (handle).



5. Завершение работы драйвера terminate(handle)



AH == 5 (код запроса)

int handle; BX (указатель)

В случае ошибки флаг carry=1, а в регистр DH заносится код ошибки. Возможные ошибки:

1 BAD_HANDLE;

7 CANT_TERMINATE.

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



6. Получение физического адреса интерфейса get_address(handle,buf,len)





AH == 6 (код запроса)

int handle; BX (указатель)

char far *buf; ES:DI (адрес буфера)

int len; CX (длина адреса в байтах)

В случае ошибки флаг carry=1, а в регистр DH заносится код ошибки. Возможные ошибки:

1 BAD_HANDLE;

9 NO_SPACE. При успешном выполнении запроса флаг carry=0, а в регистр CX занесена длина адреса.

Копирует текущее значение сетевого (физического) адреса интерфейса в буфер. Если получено сообщение NO_SPACE, это означает, что выделенного места (len=CX) для копирования адреса не хватило.



7. Возвращение интерфейса в исходное состояние reset_interface(handle)



AH == 7 (код запроса)

int handle; BX (указатель)

В случае ошибки флаг carry=1, а в регистр DH заносится код ошибки. Возможные ошибки:

1 BAD_HANDLE;

15 CANT_RESET.

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



8. Запрос установки режима приема пакетов set_rcv_mode(handle,mode)



AH == 20 (код запроса) int handle;

BX (входные параметры - указатель) int mode;

CX (код режима приема пакетов)

В случае ошибки флаг carry=1, а в регистр DH заносится код ошибки. Возможные ошибки:

1 BAD_HANDLE;

8 BAD_MODE.

Устанавливает режим приема пакетов. Режим 3 используется по умолчанию. Возможны (но не для всех интерфейсов) следующие режимы:

Режим Значение
1 выключение приема пакетов;
2 прием пакетов, адресованных только данному интерфейсу;
3 режим 2 плюс бродкастинг-пакеты;
4 режим 3 плюс некоторые мультикастинг-пакеты;
5 режим 3 плюс все мультикастинг-пакеты;
6 все пакеты.
9. Считывание действующего режима приема пакетов get_rcv_mode(handle)

AH == 21 (код запроса)

int handle; BX (входной параметр - указатель)

В случае ошибки флаг carry=1, а в регистр DH заносится код ошибки 1 BAD_HANDLE. При успешном выполнении запроса флаг carry=0, а в регистр AX заносится код режима приема пакетов.





10. Занесение списка мультикастинг-адресов в интерфейс set_multicast_list(addrlst,len)



AH == 22 (код запроса)

char far *addrlst; ES:DI (адрес буфера, где лежат адреса)

int len; CX (длина списка адресов)

В случае ошибки флаг carry=1, а в регистр DH заносится код ошибки. Возможные ошибки:

6 NO_MULTICAST;

9 NO_SPACE;

14 BAD_ADDRESS.

Список адресов представляет собой счетную последовательность, начинающуюся с байта числа адресов в списке. На список адресов указывает комбинация регистров ES:DI. Сообщение NO_SPACE присылается, если указатель адреса отсутствует, или число адресов превосходит аппаратные возможности интерфейса. Прежде чем заносить список, полезно сначала ознакомиться с имеющимся уже списком, выполнив запрос get_multicast_list. При получении сообщения NO_SPACE рекомендуется попытаться установить режим приема 3 с помощью запроса set_rcv_mode.



11. Получение рабочего списка мультикастинг-адресов



get_multicast_list

AH == 23 (код запроса)

В случае ошибки флаг carry=1, а в регистр DH заносится код ошибки. Возможные ошибки:

6 NO_MULTICAST;

9 NO_SPACE.

При успешном выпонении запроса флаг carry=0, в регистр CX заносится длина списка адресов, а регистры ES:DI указывают на начало счетной оследовательности, где запрошенный список лежит. Прикладная программа не должна модифицировать этот список.



12. Получение статистических данных об ошибках и трафике через данный интерфейс

get_statistics(handle)

AH == 24 (код запроса)

int handle; BX (указатель)

char far *statistics; DS:SI (адрес буфера, куда записываются статистические данные)

В случае ошибки флаг carry=1, а в регистр DH заносится код ошибки 1 BAD_HANDLE. При успешном выполнении запроса флаг carry=0, а в массиве, начиная с адреса DS:SI, лежит запрошенная информация.

struct statistics {

unsigned long packets_in; ( Число принятых пакетов для всех указателей)
unsigned long packets_out; ( Число посланных пакетов)
unsigned long bytes_in; ( Число принятых байтов, включая MAC заголовки)
unsigned long bytes_out; ( Число посланных байтов)
unsigned long errors_in; ( Полное число ошибок при приеме)
unsigned long errors_out; ( Число ошибок при посылке пакетов)
unsigned long packets_lost; ( Число потерянных пакетов из-за отсутствия свободного буфера или других ресурсов)
<


/p> };

Статистические данные имеют вид целых 32-разрядных чисел в формате IBM/PC.

13. Смена физического адреса интерфейса

set_address(addr, len) AH == 25

char far *addr; ES:DI (адрес буфера, где лежит новое значение адреса)

int len; CX (длина адреса в байтах)

В случае ошибки флаг carry=1, а в регистр DH заносится код ошибки. Возможные ошибки:

13 CANT_SET;

14 BAD_ADDRESS.

При благоприятном выполнении запроса флаг carry=0, а значение регистра CX сохраняется.

Запрос используется в случае, когда необходим специфический физический адрес интерфейса (например, в случае DECNET). При наличии более одного указателя (handle) драйвер откажется исполнить данный запрос и пришлет сообщение CANT_SET.

Этим не исчерпывается перечень возможных запросов, существует некоторое количество операций, относящихся к экстра-набору функций (код функциональности 5 или 6, смотри описание запроса driver_info).


Содержание раздела



Главная сайта