Хитрости. Компьютерные сети - Кэти Айвенс

- 111 -

-1 код ошибки установлен в переменной errno.

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

EAGAIN нет готовых к работе тредов ENOMEM недостаточно оперативной памяти

Другие значения соответствует кодам возврата функций

StartThread или RecvLink.

ASync

#include <epx/comm.h>

int ASync (int TopId, int LogLinkId);

ASync() ожидает завершения обмена данными через линк LogLinkId или через все линки топологии TopId (при LogLinkId = -1). На время ожидания процесс, вызвавший функцию ASync(), блокируется.

ASync() возвращает следующие значения:

0 принимающий тред успешно запущен.

-1 код ошибки установлен в переменной errno.

EINVAL неправильное значение TopId, или Threads вне допустимого диапазона

ESRCH ошибка выполнения функции WaitThread().

AInfo

#include <epx/comm.h>

int AInfo (int TopId, int LogLinkId);

С помощью функции AInfo() можно определить число незавершенных обменов через линк LogLinkId или через все линки топологии TopId

(при LogLinkId = -1).

AInfo() возвращает следующие значения: >= 0 число незавершенных обменов

<0 код ошибки установлен в переменной errno:

EINVAL неправильное значение TopId, или Threads вне допустимого диапазона.

- 112 -

AExit

#include <epx/comm.h> int AExit (int TopId);

AExit() ожидает завершения всех обменов, останавливает треды и освобождает структуры данных, используемые топологией TopId. Для завершения тредов необходимо вызвать либо функцию AExit(), либо функцию Freetop().

AExit() возвращает следующие значения: 0 в случае успешного завершения <0 ошибка.

Select

#include <epx/select.h>

int Select (int nOpts, Option_t Opt1, Option_t Opt2, ...);

Select() блокирует выполнение программы до тех пор, пока на одном из указанных nOpts расширенных каналов Opt1, Opt2 не появится сообщение. Расширенным каналом может служить любой виртуальный канал, с которого ожидается сообщение. Кроме того, расширенным каналом может служить таймер. В этом случае под сообщением понимают наступление заданного при инициализации данного расширенного канала момента времени.

Функция Select() возвращает номер одного из перечисленных в ее параметрах расширенных каналов, на который уже пришло сообщение. Если к моменту вызова Select() сообщения пришли на несколько расширенных каналов, возвращается номер первого по списку канала вне зависимости от того, какое из сообщений пришло раньше других.

Для инициализации расширенного канала используются функции

ReceiveOption(), TimeAfterOption(), ReceiveOption_B() и

TimeAfterOption_B().

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

Если расширенный канал соответствует таймеру (инициализирован с помощью одной из функций TimeAfterOption() или

- 114 -

Option_t ReceiveOption_B (LinkCB_t *Link, int guard);

Функция ReceiveOption_B() аналогична функции ReceiveOption() с той разницей, что позволяет указать при инициализации необходимость ожидания ввода с указанного расширенного канала. При guard=0 соответствующий расширенный канал игнорируется в списке расширенных каналов, при guard!=0 расширенный канал обрабатывается обычным образом.

TimeAfterOption

#include <epx/select.h>

Option_t TimeAfterOption (time_t EndTime);

Функция TimeAfterOption() возвращает инициализированную в соответствии с временем EndTime структуру Option_t. В качестве параметра EndTime следует указывать некоторый момент времени. Например, если требуется задать интервал времени в 1 с, то следует ис-

пользовать EndTime=TimeNow()+CLOCK__TICK.

TimeAfterOption_B

#include <epx/select.h>

Option_t TimeAfterOption_B (time_t EndTime, int guard)

Функция TimeAfterOption_B() аналогична функции TimeAfterOption()

с той разницей, что позволяет указать при инициализации необходимость ожидания ввода с указанного расширенного канала. При guard=0 соответствующий расширенный канал игнорируется в списке расширенных каналов, при guard!=0 расширенный канал обрабатывается обычным образом.

GetLinkCB

#include <epx/topology.h>

LinkCB_t *GetLinkCB (int TopId, int LogLinkId, int *Error);

Функция GetLinkCB возвращает указатель на контрольный блок линка. В случае ошибки возвращается значение NULL, код ошибки передается в этом случае через переменную Error. TopId - задает созданную ранее виртуальную топологию, LogLinkId - задает номер виртуального линка в пределах этой топологии.

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

- 115 -

EINVAL неправильное значение TopId, или LogLinkId вне допустимого диапазона.

TimeNow

#include <epx/time.h> unsigned int TimeNow (void);

Функция возвращает текущее значение процессорного таймера, выраженное в условных единицах - «тиках». Число «тиков» в секунде определяется константой CLOCK__TICK. Примерно каждую 71 минуту значение таймера становится равным 0.

TimeWait

#include <epx/time.h>

void TimeWait (unsigned int Time);

Если Time-TimeNow()<=INT_MAX, то процесс, вызвавший подпрограмму TimeWait, задерживается до тех пор, пока не наступит время, указанное параметром Time. В противном случае выполнение процесса продолжается без задержки. Нельзя задать интервал ожидания, превышающий 36 минут.

TimeAfter

#include <epx/time.h>

int TimeAfter (unsigned int Time1, unsigned int Time2);

Функция возвращает положительное значение, если время Time1 больше, чем Time2 (Timet1-Time2<=INT_MAX). В противном случае возвращаемое значение равно 0.

CreateSem

SYNOPSIS

#include <epx/sem.h>

Semaphore_t CreateSem (int Count);

Создание семафора и его инициализация значением Count.

При успешном создании семафора возвращается его значение. В случае ошибки создания семафора возвращается значение NULL и устанавливается переменная errno.

DestroySem

int DestroySem (Semaphore_t *Sem);

Уничтожение семафора, созданного с помощью функции CreateSem. Эту подпрограмму необходимо вызвать для корректного

- 116 -

освобождения ресурсов операционной системы, используемых семафором. При успешном освобождении ресурсов возвращается значение 0, иначе возвращается код ошибки и устанавливается переменная errno.

Wait

void Wait (Semaphore_t *Sem);

Блокирующая проверка семафора. Если значение семафора равно 0, то выполнение процесса задерживается до тех пор, пока семафор не будет освобожден. Если значение семафора положительно, оно уменьшается на 1 и выполнение процесса продолжается.

TestWait

int TestWait (Semaphore_t *Sem);

Не блокирующая проверка семафора. Действие этой функции отличается от действия функции TestWait() тем, что в том случае, когда значение семафора равно 0, сразу возвращается значение FALSE. Если значение семафора положительно, оно уменьшается на 1 и возвращается значение TRUE. В любом случае выполнение процесса не задерживается.

Signal

void Signal (Semaphore_t *Sem);

Освобождение семафора. При наличии процессов, ожидающих освобождения семафора, один из них начинает выполняться, иначе значение семафора увеличивает на 1.