GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PVM_BUFINFO (3)

NAME

pvm_bufinfo() - Returns information about a message buffer.

CONTENTS

Synopsis
Parameters
Description
Examples
Errors
See Also

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)
Search for    or go to Top of page |  Section 3 |  Main Index


BUFINFO (3PVM) 30 August, 1993

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.