TCP/IP Programming Manual

#include <socket.h>
#include <in.h>
#include <in6.h> /* for IPv6 use */
#include <netdb.h>
error = recvfrom_nw (socket, buffer_ptr, buffer_length,
flags, r_buffer_ptr, r_buffer_length,
tag );
int error, socket;
char * buffer_ptr;
int buffer_length, flags;
struct sockaddr * r_buffer_ptr;
int * r_buffer_length;
long tag;
TAL Synopsis
?NOLIST, SOURCE SOCKDEFT
?NOLIST, SOURCE SOCKPROC
error := recvfrom_nw (socket, buffer_ptr, buffer_length,
flags, r_buffer_ptr, r_buffer_length,
tag );
INT(32) error, socket;
STRING .EXT buffer_ptr;
INT(32) buffer_length, flags;
INT .EXT r_buffer_ptr(sockaddr_in);
INT(32) r_buffer_length;
INT(32) tag;
error
return value; if the call is successful, a zero is returned. If the call is not successful, —1 is
returned. If the call failed, the external variable errno is set as indicated in Errors (page 163).
socket
input value; specifies the socket number for the socket, as returned by the call to socket_nw.
buffer_ptr
input and return value; a character pointer to the data returned by the call to recvfrom_nw.
buffer_length
input value; the integer length of the data buffer pointed to by buffer_ptr.
r_buffer_ptr
input and return value; not used by the recvfrom_nw call. Call socket_get_info (page 194) to
get the socket address (parameter sockaddr_buffer). A dummy parameter must still be
passed to satisfy the recvfrom_nw call.
r_buffer_length
input and return value; no longer used by the recvfrom_nw call to determine the
r_buffer_ptr size since r_buffer_ptr is no longer used; however, recvfrom_nw still
requires a valid value for this parameter. Call socket_get_info (page 194) to get the socket
address structure length (parameter buflen).
flags
input value; maintained for compatibility; set to 0.
tag
input value; the tag parameter to be used for the nowait operation initiated by recvfrom_nw.
162 Library Routines