Subversion Repositories Kolibri OS

======================================================================

= Функция 52, подфункция 0 - получить конфигурацию сетевого драйвера.

======================================================================

Параметры:

  * eax = 52 - номер функции

  * ebx = 0 - номер подфункции

Возвращаемое значение:

  * eax = двойное слово конфигурации

Замечания:

  * Слово конфигурации можно установить подфункцией 2.

  * Ядро не использует соответствующую переменную.

    Ценность этой переменной и работающих с ней подфункций 0 и 2

    представляется сомнительной.

======================================================================

======= Функция 52, подфункция 1 - получить локальный IP-адрес. ======

======================================================================

Параметры:

  * eax = 52 - номер функции

  * ebx = 1 - номер подфункции

Возвращаемое значение:

  * eax = IP-адрес (4 байта)

Замечания:

  * Локальный IP-адрес устанавливается подфункцией 3.

======================================================================

 Функция 52, подфункция 2 - установить конфигурацию сетевого драйвера.

======================================================================

Параметры:

  * eax = 52 - номер функции

  * ebx = 2 - номер подфункции

  * ecx = двойное слово конфигурации; если младшие 7 бит образуют

    число 3, это воспринимается как запрос на [пере-]инициализацию

    Ethernet-карты, в противном случае Ethernet выключается

Возвращаемое значение:

  * если не запрошен Ethernet-интерфейс, то возвращается eax=2,

    но это может измениться в будущих версиях ядра

  * если запрошен Ethernet-интерфейс, то eax=0 означает ошибку

    (отсутствие Ethernet-карты), а ненулевое значение - успех

Замечания:

  * Слово конфигурации можно прочитать подфункцией 0.

  * Ядро не использует соответствующую переменную.

    Ценность этой переменной, подфункции 0 и части подфункции 2,

    устанавливающей эту переменную, представляется сомнительной.

======================================================================

====== Функция 52, подфункция 3 - установить локальный IP-адрес. =====

======================================================================

Параметры:

  * eax = 52 - номер функции

  * ebx = 3 - номер подфункции

  * ecx = IP-адрес (4 байта)

Возвращаемое значение:

  * текущая реализация возвращает eax=3, но это может быть изменено

    в будущих версиях

Замечания:

  * Локальный IP-адрес можно получить подфункцией 1.

======================================================================

= Функция 52, подфункция 6 - добавить данные в стек входной очереди. =

======================================================================

Параметры:

  * eax = 52 - номер функции

  * ebx = 6 - номер подфункции

  * edx = размер данных

  * esi = указатель на данные

Возвращаемое значение:

  * eax = -1 - ошибка

  * eax = 0 - успешно

Замечания:

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

    (PPP, SLIP).

  * Размер данных не должен превосходить 1500 байт,

    хотя проверок корректности не делается.

======================================================================

====================== Функция 52, подфункция 8 ======================

============= Прочитать данные из сетевой очереди вывода. ============

======================================================================

Параметры:

  * eax = 52 - номер функции

  * ebx = 8 - номер подфункции

  * esi = указатель на буфер размером 1500 байт

Возвращаемое значение:

  * eax = число прочитанных байт (в текущей реализации

    либо 0 = нет данных, либо 1500)

  * данные скопированы в буфер

Замечания:

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

    (PPP, SLIP).

======================================================================

=========== Функция 52, подфункция 9 - получить gateway IP. ==========

======================================================================

Параметры:

  * eax = 52 - номер функции

  * ebx = 9 - номер подфункции

Возвращаемое значение:

  * eax = gateway IP (4 байта)

======================================================================

========= Функция 52, подфункция 10 - получить маску подсети. ========

======================================================================

Параметры:

  * eax = 52 - номер функции

  * ebx = 10 - номер подфункции

Возвращаемое значение:

  * eax = маска подсети

======================================================================

========= Функция 52, подфункция 11 - установить gateway IP. =========

======================================================================

Параметры:

  * eax = 52 - номер функции

  * ebx = 11 - номер подфункции

  * ecx = gateway IP (4 байта)

Возвращаемое значение:

  * текущая реализация возвращает eax=11, но это может быть изменено

    в будущих реализациях

======================================================================

======== Функция 52, подфункция 12 - установить маску подсети. =======

======================================================================

Параметры:

  * eax = 52 - номер функции

  * ebx = 12 - номер подфункции

  * ecx = маска подсети

Возвращаемое значение:

  * текущая реализация возвращает eax=12, но это может быть изменено

    в будущих версиях

======================================================================

============ Функция 52, подфункция 13 - получить DNS IP. ============

======================================================================

Параметры:

  * eax = 52 - номер функции

  * ebx = 13 - номер подфункции

Возвращаемое значение:

  * eax = DNS IP (4 байта)

======================================================================

=========== Функция 52, подфункция 14 - установить DNS IP. ===========

======================================================================

Параметры:

  * eax = 52 - номер функции

  * ebx = 14 - номер подфункции

  * ecx = DNS IP (4 байта)

Возвращаемое значение:

  * текущая реализация возвращает eax=14, но это может быть изменено

    в следующих версиях

======================================================================

====== Функция 52, подфункция 15 - получить локальный MAC-адрес. =====

======================================================================

Параметры:

  * eax = 52 - номер функции

  * ebx = 15 - номер подфункции

  * ecx = 0 - читать первые 4 байта,

    ecx = 4 - читать последние 2 байта

Возвращаемое значение:

  * для ecx=0: eax = первые 4 байта MAC-адреса

  * для ecx=4: ax = последние 2 байта MAC-адреса,

               старшая половина eax разрушается

  * для других ecx: eax = -1 как признак ошибки

======================================================================

============ Функция 53, подфункция 0 - открыть UDP-сокет. ===========

======================================================================

Параметры:

  * eax = 53 - номер функции

  * ebx = 0 - номер подфункции

  * ecx = локальный порт (учитывается только младшее слово),

    ecx = 0 - предоставить системе выбор локального порта

  * edx = удалённый порт (учитывается только младшее слово)

  * esi = удалённый IP

Возвращаемое значение:

  * eax = -1 = 0xFFFFFFFF - ошибка; ebx разрушается

  * eax = хэндл сокета (некоторое число, однозначно идентифицирующее

    сокет и имеющее смысл только для системы) - успешно;

    ebx разрушается

======================================================================

============ Функция 53, подфункция 1 - закрыть UDP-сокет. ===========

======================================================================

Параметры:

  * eax = 53 - номер функции

  * ebx = 1 - номер подфункции

  * ecx = хэндл сокета

Возвращаемое значение:

  * eax = -1 - неверный хэндл

  * eax = 0 - успешно

  * ebx разрушается

Замечания:

  * Текущая реализация не закрывает автоматически все сокеты потока

    при его завершении. В частности, не следует прибивать поток

    с кучей открытых сокетов - будет утечка ресурсов.

======================================================================

============== Функция 53, подфункция 2 - опрос сокета. ==============

======================================================================

Параметры:

  * eax = 53 - номер функции

  * ebx = 2 - номер подфункции

  * ecx = хэндл сокета

Возвращаемое значение:

  * eax = число полученных байт, 0 для неверного хэндла

  * ebx разрушается

======================================================================

======== Функция 53, подфункция 3 - прочитать байт из сокета. ========

======================================================================

Параметры:

  * eax = 53 - номер функции

  * ebx = 3 - номер подфункции

  * ecx = хэндл сокета

Возвращаемое значение:

  * если нет принятых данных или указан неверный хэндл:

    eax=0, bl=0, прочие байты ebx разрушаются

  * если были принятые данные: eax=число оставшихся байт

    (возможно, 0), bl=прочитанный байт, прочие байты ebx разрушаются

======================================================================

========== Функция 53, подфункция 4 - записать в UDP-сокет. ==========

======================================================================

Параметры:

  * eax = 53 - номер функции

  * ebx = 4 - номер подфункции

  * ecx = хэндл сокета

  * edx = число байт для записи

  * esi = указатель на данные для записи

Возвращаемое значение:

  * eax = 0xffffffff - ошибка (неверный хэндл или недостаточно памяти)

  * eax = 0 - успешно

  * ebx разрушается

Замечания:

  * Число байт для записи не может превышать 1500-28, хотя

    соответствующей проверки не делается.

======================================================================

============ Функция 53, подфункция 5 - открыть TCP-сокет. ===========

======================================================================

Параметры:

  * eax = 53 - номер функции

  * ebx = 5 - номер подфункции

  * ecx = локальный порт (учитывается только младшее слово),

    ecx = 0 - предоставить системе выбор локального порта

  * edx = удалённый порт (учитывается только младшее слово)

  * esi = удалённый IP

  * edi = режим открытия: SOCKET_PASSIVE=0 или SOCKET_ACTIVE=1

Возвращаемое значение:

  * eax = -1 = 0xFFFFFFFF - ошибка; ebx разрушается

  * eax = хэндл сокета (некоторое число, однозначно идентифицирующее

    сокет и имеющее смысл только для системы) - успешно;

    ebx разрушается

======================================================================

====== Функция 53, подфункция 6 - получить состояние TCP-сокета. =====

======================================================================

Параметры:

  * eax = 53 - номер функции

  * ebx = 6 - номер подфункции

  * ecx = хэндл сокета

Возвращаемое значение:

  * eax = 0 для неверного сокета или статус: одно из

  * TCB_LISTEN = 1

  * TCB_SYN_SENT = 2

  * TCB_SYN_RECEIVED = 3

  * TCB_ESTABLISHED = 4

  * TCB_FIN_WAIT_1 = 5

  * TCB_FIN_WAIT_2 = 6

  * TCB_CLOSE_WAIT = 7

  * TCB_CLOSING = 8

  * TCB_LAST_ASK = 9

  * TCB_TIME_WAIT = 10

  * TCB_CLOSED = 11

  * ebx разрушается

======================================================================

========== Функция 53, подфункция 7 - записать в TCP-сокет. ==========

======================================================================

Параметры:

  * eax = 53 - номер функции

  * ebx = 7 - номер подфункции

  * ecx = хэндл сокета

  * edx = число байт для записи

  * esi = указатель на данные для записи

Возвращаемое значение:

  * eax = 0xffffffff - ошибка (неверный хэндл или недостаточно памяти)

  * eax = 0 - успешно

  * ebx разрушается

Замечания:

  * Число байт для записи не может превышать 1500-40,

    хотя соответствующей проверки не делается.

======================================================================

============ Функция 53, подфункция 8 - закрыть TCP-сокет. ===========

======================================================================

Параметры:

  * eax = 53 - номер функции

  * ebx = 8 - номер подфункции

  * ecx = хэндл сокета

Возвращаемое значение:

  * eax = -1 - ошибка (неверный хэндл или

    недостаточно памяти для пакета закрытия сокета)

  * eax = 0 - успешно

  * ebx разрушается

Замечания:

  * Текущая реализация не закрывает автоматически все сокеты потока

    при его завершении. В частности, не следует прибивать поток

    с кучей открытых сокетов - будет утечка ресурсов.

======================================================================

== Функция 53, подфункция 9 - проверить, свободен ли локальный порт. =

======================================================================

Параметры:

  * eax = 53 - номер функции

  * ebx = 9 - номер подфункции

  * ecx = номер локального порта (используются только младшие 16 бит)

Возвращаемое значение:

  * eax = 0 - порт используется

  * eax = 1 - порт свободен

  * ebx разрушается

======================================================================

==== Функция 53, подфункция 10 - получить статус кабеля Ethernet. ====

======================================================================

Параметры:

  * eax = 53 - номер функции

  * ebx = 10 - номер подфункции

Возвращаемое значение:

  * al = -1 - драйвер сетевой карты не загружен или

              не поддерживает эту функцию

  * al = 0 - кабель не подключён

  * al = 1 - кабель подключён

  * ebx разрушается

Замечания:

  * Текущая реализация ядра поддерживает эту функцию

    только для сетевых карт RTL8139.

======================================================================

==== Функция 53, подфункция 11 - прочитать данные сетевого стека. ====

======================================================================

Параметры:

  * eax = 53 - номер функции

  * ebx = 11 - номер подфункции

  * ecx = хэндл сокета

  * edx = указатель на буфер

  * esi = число байт для чтения;

  * esi = 0 - читать все данные (максимум 4096 байт)

Возвращаемое значение:

  * eax = число прочитанных байт (0 при неверном хэндле)

  * ebx разрушается

======================================================================

 Функция 53, подфункция 255 - отладочная информация сетевого драйвера.

======================================================================

Параметры:

  * eax = 53 - номер функции

  * ebx = 255 - номер подфункции

  * ecx = тип запрашиваемой информации (смотри ниже)

Возвращаемое значение:

  * eax = запрошенная информация

  * ebx разрушается

Возможные значения ecx:

  * 100: длина очереди 0 (empty queue)

  * 101: длина очереди 1 (ip-out queue)

  * 102: длина очереди 2 (ip-in queue)

  * 103: длина очереди 3 (net1out queue)

  * 200: число элементов в таблице ARP

  * 201: размер таблицы ARP (в элементах) (20 в текущей версии)

  * 202: прочитать элемент edx таблицы ARP во временный буфер, откуда

    берут информацию 5 последующих типов;

    в этом случае eax неопределён

  * 203: IP-адрес, запомненный типом 202

  * 204: старшее dword MAC-адреса, запомненного типом 202

  * 205: младшее word MAC-адреса, запомненного типом 202

  * 206: слово статуса, запомненное типом 202

  * 207: слово ttl, запомненное типом 202

  * 2: общее число полученных IP-пакетов

  * 3: общее число переданных IP-пакетов

  * 4: общее число сдампленных полученных пакетов

  * 5: общее число полученных ARP-пакетов

  * 6: статус драйвера пакетов, 0=неактивен,

    ненулевое значение=активен