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 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 ALSO

       pvm_recv(3PVM)

                                         30 August, 1993                            BUFINFO(3PVM)