NPROBE(2) LAM REMOTE LIBRARY NPROBE(2)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 descrip‐
tor, 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 suc‐
cessful 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 vari‐
able, errno is set to indicate the error.
FORTRAN RETURN VALUE
Upon successful completion, the nready argument is set to 1 if a syn‐
chronizing message is waiting to be received, and 0 if no synchronizing
message is waiting.
SEE ALSObfctl(1), nsend(2)LAM 7.1.2 March, 2006 NPROBE(2)
