1BUFINFO(3PVM)                   PVM Version 3.4                  BUFINFO(3PVM)
2
3
4

NAME

6       pvm_bufinfo() - Returns information about a message buffer.
7
8

SYNOPSIS

10       C    int info = pvm_bufinfo( int bufid, int *bytes, int *msgtag,
11       int *tid )
12
13       Fortran   call pvmfbufinfo( bufid, bytes, msgtag, tid, info )
14
15

PARAMETERS

17       bufid   Integer specifying a particular message buffer identifier.
18
19       bytes   Integer  returning  the length in bytes of the body of the mes‐
20               sage.  This will be equal  to  the  actual  size  of  the  data
21               packed,  if  PvmDataRaw  is  used, otherwise it may include pad
22               bytes.
23
24       msgtag  Integer returning the message label.  Useful when  the  message
25               was received with a wildcard msgtag.
26
27       tid     Integer  returning  the source of the message.  Useful when the
28               message was received with a wildcard tid.
29
30       info    Integer status code returned by the routine.  Values less  than
31               zero indicate an error.
32
33

DESCRIPTION

35       The routine pvm_bufinfo returns information about the requested message
36       buffer. Typically it is used to determine facts about the last received
37       message  such  as its size or source.  pvm_bufinfo is especially useful
38       when an application is able to receive any incoming  message,  and  the
39       action  taken  depends on the source tid and the msgtag associated with
40       the message that comes in first.  If pvm_bufinfo  is  successful,  info
41       will be 0.  If some error occurs then info will be < 0.
42
43

EXAMPLES

45       C:
46            bufid = pvm_recv( -1, -1 );
47            info = pvm_bufinfo( bufid, &bytes, &type, &source );
48
49       Fortran:
50            CALL PVMFRECV( -1, -1, BUFID )
51            CALL PVMFBUFINFO( BUFID, BYTES, TYPE, SOURCE, INFO )
52
53

ERRORS

55       This error condition can be returned by pvm_bufinfo.
56
57       PvmNoSuchBuf
58              specified buffer does not exist.
59
60       PvmBadParam
61              invalid argument
62

SEE ALSO

64       pvm_recv(3PVM)
65
66
67
68                                30 August, 1993                  BUFINFO(3PVM)
Impressum