nprobe

Langue: en

Version: 59019 (mandriva - 22/10/07)

Section: 2 (Appels système)

NAME

nprobe - Report if a LAM bufferd network message is ready to be received.

C SYNOPSIS

#include <net.h>
int nprobe (struct nmsg *header);

FORTRAN SYNOPSIS

subroutine NPROB (nevent, ntype, nlength, nflags, nready, ierror) integer nevent, ntype, nlength, nflags, nready, ierror

DESCRIPTION

If a synchronizing message exists, information about its type, length, and flags is returned.

The nprobe() function accepts a pointer to a network message descriptor, defined in <net.h>. See nsend(2). Only the nh_event and nh_type fields of the network message descriptor must be filled before calling nprobe(). The nh_type and nh_length fields are altered after a successful probe as if nrecv(2) had been called.

Since nprobe() can only examine buffered messages, it cannot be used when buffers are bypassed.

C RETURN VALUE

Upon successful completion, 1 is returned if a synchronizing message is waiting to be received, and 0 is returned if no synchronizing message is waiting. If an error occurred, -1 is returned and the global variable, errno is set to indicate the error.

FORTRAN RETURN VALUE

Upon successful completion, the nready argument is set to 1 if a synchronizing message is waiting to be received, and 0 if no synchronizing message is waiting.

SEE ALSO

bfctl(1), nsend(2)