Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
BUFINFO(3PVM)			PVM Version 3.4			 BUFINFO(3PVM)

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 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 ALSO
       pvm_recv(3PVM)

				30 August, 1993			 BUFINFO(3PVM)

NAME | SYNOPSIS | PARAMETERS | DESCRIPTION | EXAMPLES | ERRORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pvm_bufinfo&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help