NAME

recvtim − receive a message with timeout

SYNOPSIS

int recvtim(maxwait)
int maxwait;

DESCRIPTION

Recvtim allows a process to specify a maximum time limit it is willing to wait for a message to arrive.  Like RECEIVE(2), recvtim blocks the calling process until a message arrives from SEND(2).  Argument maxwait gives the maximum time to wait for a message, specified in tenths of seconds. 

Recvtim returns integer SYSERR if the argument is incorrect or if no clock is present.  It returns integer TIMEOUT if the time limit expires before a message arrives.  Otherwise, it returns the message. 

SEE ALSO

receive(2), recvclr(2), send(2), sleep10(2), sleep(2)

BUGS

There is no way to distinguish between messages that contain TIMEOUT or SYSERR and errors reported by recvtim. 

December 01, 1986  —  Xinu Programmer’s Manual