MAN page from Old RedHat 5.X pvm-3.4beta7-2.i386.rpm

BUFINFO

Section: PVM Version 3.4 (3PVM)
Updated: 30 August, 1993
Index

NAME

pvm_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 message.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 routinepvm_bufinforeturns information about therequested message buffer. Typically it is used to determinefacts about the last received message such as its size or source.pvm_bufinfo is especially useful when an applicationis able to receive any incoming message, and the actiontaken depends on the sourcetidand themsgtagassociated with the message that comes in first.If pvm_bufinfo is successful,infowill be 0.If some error occurs theninfowill 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 bypvm_bufinfo.

PvmNoSuchBuf: specified buffer does not exist.
PvmBadParam: invalid argument

This document was created byman2html,using the manual pages.