BUFINFO(3PVM) PVM Version 3.4 BUFINFO(3PVM)NAMEpvm_bufinfo() - Returns information about a message buffer.
SYNOPSIS
C int info = pvm_bufinfo( int bufid, int *bytes, int *msgtag,
int *tid )
Fortran call pvmfbufinfo( bufid, bytes, msgtag, tid, info )
PARAMETERS
bufid Integer specifying a particular message buffer identifier.
bytes Integer returning the length in bytes of the body of the mes‐
sage. This will be equal to the actual size of the data
packed, if PvmDataRaw is used, otherwise it may include pad
bytes.
msgtag Integer returning the message label. Useful when the message
was received with a wildcard msgtag.
tid Integer returning the source of the message. Useful when the
message was received with a wildcard tid.
info Integer status code returned by the routine. Values less than
zero indicate an error.
DESCRIPTION
The routine pvm_bufinfo returns information about the requested message
buffer. Typically it is used to determine facts about the last received
message such as its size or source. pvm_bufinfo is especially useful
when an application is able to receive any incoming message, and the
action taken depends on the source tid and the msgtag associated with
the message that comes in first. If pvm_bufinfo is successful, info
will be 0. If some error occurs then info will be < 0.
EXAMPLES
C:
bufid = pvm_recv( -1, -1 );
info = pvm_bufinfo( bufid, &bytes, &type, &source );
Fortran:
CALL PVMFRECV( -1, -1, BUFID )
CALL PVMFBUFINFO( BUFID, BYTES, TYPE, SOURCE, INFO )
ERRORS
This error condition can be returned by pvm_bufinfo.
PvmNoSuchBuf
specified buffer does not exist.
PvmBadParam
invalid argument
SEE ALSOpvm_recv(3PVM)
30 August, 1993 BUFINFO(3PVM)
