NAME

recv − Receive data from the WDD Line

SYNTAX

 
#include <sys/types.h>
#include <sys/socket.h>

cc =recv (s, buf, buflen, flags)
int cc,s;
char ∗buf;
int buflen, flags;

DESCRIPTION

The client uses the read() or recv() system calls to receive protocol or out of band data from the line.

For further information on out of band data, see the DEC WAN Device Drivers Application Programmer’s Guide. 

ARGUMENTS

Input Arguments

s Value returned by the socket() system call

buf Pointer to the buffer into which the data will be placed

buflen Length of the receive buffer, i.e. maximum number of characters to be received

flags If not used, should be set to zero. 

RETURN VALUE

If the read is successful, the return value (cc) is the number of characters actually read.  Otherwise, -1 is returned and the global variable errno is set to indicate the error.

DIAGNOSTICS

[EBADF] Invalid socket descriptor. 

[EFAULT] The specified buffer points outside the allocated address space. 

[EWOULDBLOCK] The socket is marked "non-blocking" and there was no data immediately available. 

[EINTR] The recv() operation was interrupted by a signal, possibly an indication that the Modem Connect Line has been disabled, or some other event has occurred on the line.

SEE ALSO

socket(2w), bind(2w), getsockopt(2w), setsockopt(2w), send(2w), write(2w), close(2w), fcntl(2), sigvec(2)