| /kernel/trunk/docs/sysfuncr.txt |
|---|
| 2420,391 → 2420,6 |
| * иначе eax = TID - идентификатор потока |
| ====================================================================== |
| = Функция 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=неактивен, |
| ненулевое значение=активен |
| ====================================================================== |
| ====================== Функция 55, подфункция 55 ===================== |
| ========== Начать проигрывать данные на встроенном спикере. ========== |
| ====================================================================== |
| /kernel/trunk/docs/sysfuncs.txt |
|---|
| 2411,408 → 2411,6 |
| </UL> |
| ====================================================================== |
| =========================== Function 52 ============================== |
| ====================================================================== |
| WARNING: This function is obsolete and is only present in the |
| documentation as a guide to understand/port the older network |
| applications. For new programs, use function 74 |
| ====================================================================== |
| === Function 52, subfunction 0 - get network driver configuration. === |
| ====================================================================== |
| Parameters: |
| * eax = 52 - function number |
| * ebx = 0 - subfunction number |
| Returned value: |
| * eax = configuration dword |
| Remarks: |
| * Configuration dword can be set by subfunction 2. |
| * The kernel does not use this variable. The value of this |
| variable and working with it subfunctions 0 and 2 is represented |
| doubtful. |
| ====================================================================== |
| ========= Function 52, subfunction 1 - get local IP-address. ========= |
| ====================================================================== |
| Parameters: |
| * eax = 52 - function number |
| * ebx = 1 - subfunction number |
| Returned value: |
| * eax = IP-address (4 bytes) |
| Remarks: |
| * Local IP-address is set by subfunction 3. |
| ====================================================================== |
| === Function 52, subfunction 2 - set network driver configuration. === |
| ====================================================================== |
| Parameters: |
| * eax = 52 - function number |
| * ebx = 2 - subfunction number |
| * ecx = configuration dword; if low 7 bits derivate the number 3, |
| function [re-]initializes Ethernet-card, otherwise |
| Ethernet turns off |
| Returned value: |
| * if Ethernet-interface is not requested, function returns eax=2, |
| but this can be changed in future kernel versions |
| * if Ethernet-interface is requested, eax=0 means error |
| (absence of Ethernet-card), and nonzero value - success |
| Remarks: |
| * Configuration dword can be read by subfunction 0. |
| * The kernel does not use this variable. The value of this |
| variable, subfunction 0 and part of subfunction 2, which set it, |
| is represented doubtful. |
| ====================================================================== |
| ========= Function 52, subfunction 3 - set local IP-address. ========= |
| ====================================================================== |
| Parameters: |
| * eax = 52 - function number |
| * ebx = 3 - subfunction number |
| * ecx = IP-address (4 bytes) |
| Returned value: |
| * the current implementation returns eax=3, but this can be changed |
| in future versions |
| Remarks: |
| * Local IP-address can be get by subfunction 1. |
| ====================================================================== |
| = Function 52, subfunction 6 - add data to the stack of input queue. = |
| ====================================================================== |
| Parameters: |
| * eax = 52 - function number |
| * ebx = 6 - subfunction number |
| * edx = data size |
| * esi = data pointer |
| Returned value: |
| * eax = -1 - error |
| * eax = 0 - success |
| Remarks: |
| * This function is intended only for slow network drivers |
| (PPP, SLIP). |
| * Data size must not exceed 1500 bytes, though function |
| performs no checks on correctness. |
| ====================================================================== |
| Function 52, subfunction 8 - read data from the network output queue. |
| ====================================================================== |
| Parameters: |
| * eax = 52 - function number |
| * ebx = 8 - subfunction number |
| * esi = pointer to 1500-byte buffer |
| Returned value: |
| * eax = number of read bytes (in the current implementation |
| either 0 = no data or 1500) |
| * data was copied in buffer |
| Remarks: |
| * This function is intended only for slow network drivers |
| (PPP, SLIP). |
| ====================================================================== |
| ============ Function 52, subfunction 9 - get gateway IP. ============ |
| ====================================================================== |
| Parameters: |
| * eax = 52 - function number |
| * ebx = 9 - subfunction number |
| Returned value: |
| * eax = gateway IP (4 bytes) |
| ====================================================================== |
| =========== Function 52, subfunction 10 - get subnet mask. =========== |
| ====================================================================== |
| Parameters: |
| * eax = 52 - function number |
| * ebx = 10 - subfunction number |
| Returned value: |
| * eax = subnet mask |
| ====================================================================== |
| ============ Function 52, subfunction 11 - set gateway IP. =========== |
| ====================================================================== |
| Parameters: |
| * eax = 52 - function number |
| * ebx = 11 - subfunction number |
| * ecx = gateway IP (4 bytes) |
| Returned value: |
| * the current implementation returns eax=11, but this can be changed |
| in future versions |
| ====================================================================== |
| =========== Function 52, subfunction 12 - set subnet mask. =========== |
| ====================================================================== |
| Parameters: |
| * eax = 52 - function number |
| * ebx = 12 - subfunction number |
| * ecx = subnet mask |
| Returned value: |
| * the current implementation returns eax=12, but this can be changed |
| in future versions |
| ====================================================================== |
| ============== Function 52, subfunction 13 - get DNS IP. ============= |
| ====================================================================== |
| Parameters: |
| * eax = 52 - function number |
| * ebx = 13 - subfunction number |
| Returned value: |
| * eax = DNS IP (4 bytes) |
| ====================================================================== |
| ============== Function 52, subfunction 14 - set DNS IP. ============= |
| ====================================================================== |
| Parameters: |
| * eax = 52 - function number |
| * ebx = 14 - subfunction number |
| * ecx = DNS IP (4 bytes) |
| Returned value: |
| * the current implementation returns eax=14, but this can be changed |
| in future versions |
| ====================================================================== |
| ======== Function 52, subfunction 15 - get local MAC address. ======== |
| ====================================================================== |
| Parameters: |
| * eax = 52 - function number |
| * ebx = 15 - subfunction number |
| * ecx = 0 - read first 4 bytes, |
| ecx = 4 - read last 2 bytes |
| Returned value: |
| * for ecx=0: eax = first 4 bytes of MAC address |
| * for ecx=4: ax = last 2 bytes of MAC address, |
| high half of eax is destroyed |
| * for other ecx: eax = -1 indicates an error |
| ====================================================================== |
| =========================== Function 53 ============================== |
| ====================================================================== |
| WARNING: This function is obsolete and is only present in the |
| documentation as a guide to understand/port the older network |
| applications. For new programs, use function 75. |
| ====================================================================== |
| ============ Function 53, subfunction 0 - open UDP-socket. =========== |
| ====================================================================== |
| Parameters: |
| * eax = 53 - function number |
| * ebx = 0 - subfunction number |
| * ecx = local port (only low word is taken into account), |
| ecx = 0 - let the system choose a port |
| * edx = remote port (only low word is taken into account) |
| * esi = remote IP |
| Returned value: |
| * eax = -1 = 0xFFFFFFFF - error; ebx destroyed |
| * eax = socket handle (some number which unambiguously identifies |
| socket and have sense only for the system) - success; |
| ebx destroyed |
| ====================================================================== |
| =========== Function 53, subfunction 1 - close UDP-socket. =========== |
| ====================================================================== |
| Parameters: |
| * eax = 53 - function number |
| * ebx = 1 - subfunction number |
| * ecx = socket handle |
| Returned value: |
| * eax = -1 - incorrect handle |
| * eax = 0 - success |
| * ebx destroyed |
| Remarks: |
| * The current implementation does not close automatically all |
| sockets of a thread at termination. In particular, one should not |
| kill a thread with many opened sockets - there will be an outflow |
| of resources. |
| ====================================================================== |
| ============== Function 53, subfunction 2 - poll socket. ============= |
| ====================================================================== |
| Parameters: |
| * eax = 53 - function number |
| * ebx = 2 - subfunction number |
| * ecx = socket handle |
| Returned value: |
| * eax = number of read bytes, 0 for incorrect handle |
| * ebx destroyed |
| ====================================================================== |
| ========= Function 53, subfunction 3 - read byte from socket. ======== |
| ====================================================================== |
| Parameters: |
| * eax = 53 - function number |
| * ebx = 3 - subfunction number |
| * ecx = socket handle |
| Returned value: |
| * if there is no read data or handle is incorrect: eax=0, bl=0, |
| other bytes of ebx are destroyed |
| * if there are read data: eax=number of rest bytes |
| (possibly 0), bl=read byte, other bytes of ebx are destroyed |
| ====================================================================== |
| ========== Function 53, subfunction 4 - write to UDP-socket. ========= |
| ====================================================================== |
| Parameters: |
| * eax = 53 - function number |
| * ebx = 4 - subfunction number |
| * ecx = socket handle |
| * edx = number of bytes to write |
| * esi = pointer to data to write |
| Returned value: |
| * eax = 0xffffffff - error (invalid handle or not enough memory) |
| * eax = 0 - success |
| * ebx destroyed |
| Remarks: |
| * Number of bytes to write must not exceed 1500-28, though |
| the appropriate check is not made. |
| ====================================================================== |
| ============ Function 53, subfunction 5 - open TCP-socket. =========== |
| ====================================================================== |
| Parameters: |
| * eax = 53 - function number |
| * ebx = 5 - subfunction number |
| * ecx = local port (only low word is taken into account), |
| ecx = 0 - let the system choose a port |
| * edx = remote port (only low word is taken into account) |
| * esi = remote IP |
| * edi = open mode: SOCKET_PASSIVE=0 or SOCKET_ACTIVE=1 |
| Returned value: |
| * eax = -1 = 0xFFFFFFFF - error; ebx destroys |
| * eax = socket handle (some number which unambiguously identifies |
| socket and have sense only for the system) - success; |
| ebx destroyed |
| ====================================================================== |
| ========= Function 53, subfunction 6 - get TCP-socket status. ======== |
| ====================================================================== |
| Parameters: |
| * eax = 53 - function number |
| * ebx = 6 - subfunction number |
| * ecx = socket handle |
| Returned value: |
| * eax = 0 for incorrect handle or socket status: one of |
| * 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 destroyed |
| ====================================================================== |
| ========== Function 53, subfunction 7 - write to TCP-socket. ========= |
| ====================================================================== |
| Parameters: |
| * eax = 53 - function number |
| * ebx = 7 - subfunction number |
| * ecx = socket handle |
| * edx = number of bytes to write |
| * esi = pointer to data to write |
| Returned value: |
| * eax = 0xffffffff - error (invalid handle or not enough memory) |
| * eax = 0 - success |
| * ebx destroyed |
| Remarks: |
| * Number of bytes to write must not exceed 1500-40, though |
| the appropriate check is not made. |
| ====================================================================== |
| =========== Function 53, subfunction 8 - close TCP-socket. =========== |
| ====================================================================== |
| Parameters: |
| * eax = 53 - function number |
| * ebx = 8 - subfunction number |
| * ecx = socket handle |
| Returned value: |
| * eax = -1 - error (invalid handle or |
| not enough memory for socket close packet) |
| * eax = 0 - success |
| * ebx destroyed |
| Remarks: |
| * The current implementation does not close automatically all |
| sockets of a thread at termination. In particular, one should not |
| kill a thread with many opened sockets - there will be an outflow |
| of resources. |
| ====================================================================== |
| === Function 53, subfunction 9 - check whether local port is free. === |
| ====================================================================== |
| Parameters: |
| * eax = 53 - function number |
| * ebx = 9 - subfunction number |
| * ecx = local port number (low 16 bits are used only) |
| Returned value: |
| * eax = 0 - port is used |
| * eax = 1 - port is free |
| * ebx destroyed |
| ====================================================================== |
| ===== Function 53, subfunction 10 - query Ethernet cable status. ===== |
| ====================================================================== |
| Parameters: |
| * eax = 53 - function number |
| * ebx = 10 - subfunction number |
| Returned value: |
| * al = -1 - a network driver is not loaded or |
| does not support this function |
| * al = 0 - Ethernet cable is unplugged |
| * al = 1 - Ethernet cable is plugged |
| * ebx destroyed |
| Remarks: |
| * The current kernel implementation supports this function |
| only for RTL8139 network cards. |
| ====================================================================== |
| ======= Function 53, subfunction 11 - read network stack data. ======= |
| ====================================================================== |
| Paramters: |
| * eax = 53 - function number |
| * ebx = 11 - subfunction number |
| * ecx = socket handle |
| * edx = pointer to buffer |
| * esi = number of bytes to read; |
| * esi = 0 - read all data (maximum 4096 bytes) |
| Returned value: |
| * eax = number of bytes read (0 for incorrect handle) |
| * ebx destroyed |
| ====================================================================== |
| = Function 53, subfunction 255 - debug information of network driver. |
| ====================================================================== |
| Parameters: |
| * eax = 53 - function number |
| * ebx = 255 - subfunction number |
| * ecx = type of requested information (see below) |
| Returned value: |
| * eax = requested information |
| * ebx destroyed |
| Possible values for ecx: |
| * 100: length of queue 0 (empty queue) |
| * 101: length of queue 1 (ip-out queue) |
| * 102: length of queue 2 (ip-in queue) |
| * 103: length of queue 3 (net1out queue) |
| * 200: number of items in the ARP table |
| * 201: size of the ARP table (in items) (20 for current version) |
| * 202: read item at edx of the ARP table to the temporary buffer, |
| whence 5 following types take information; |
| in this case eax is not defined |
| * 203: IP-address saved by type 202 |
| * 204: high dword of MAC-address saved by type 202 |
| * 205: low word of MAC-address saved by type 202 |
| * 206: status word saved by type 202 |
| * 207: ttl word saved by type 202 |
| * 2: total number of received IP-packets |
| * 3: total number of transferred IP-packets |
| * 4: total number of dumped received packets |
| * 5: total number of received ARP-packets |
| * 6: status of packet driver, 0=inactive, nonzero=active |
| ====================================================================== |
| Function 55, subfunction 55 - begin to play data on built-in speaker. |
| ====================================================================== |
| Parameters: |