1NPROBE(2)                     LAM REMOTE LIBRARY                     NPROBE(2)
2
3
4

NAME

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

C SYNOPSIS

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

FORTRAN SYNOPSIS

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

DESCRIPTION

19       If a synchronizing message exists, information about its type,  length,
20       and flags is returned.
21
22       The  nprobe()  function accepts a pointer to a network message descrip‐
23       tor, defined in <net.h>.  See nsend(2).  Only the nh_event and  nh_type
24       fields  of the network message descriptor must be filled before calling
25       nprobe().  The nh_type and nh_length fields are altered  after  a  suc‐
26       cessful probe as if nrecv(2) had been called.
27
28       Since  nprobe()  can  only examine buffered messages, it cannot be used
29       when buffers are bypassed.
30

C RETURN VALUE

32       Upon successful completion, 1 is returned if a synchronizing message is
33       waiting  to  be received, and 0 is returned if no synchronizing message
34       is waiting.  If an error occurred, -1 is returned and the global  vari‐
35       able, errno is set to indicate the error.
36

FORTRAN RETURN VALUE

38       Upon  successful  completion, the nready argument is set to 1 if a syn‐
39       chronizing message is waiting to be received, and 0 if no synchronizing
40       message is waiting.
41

SEE ALSO

43       bfctl(1), nsend(2)
44
45
46
47LAM 7.1.2                         March, 2006                        NPROBE(2)
Impressum