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

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).


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

---

---