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

FreeBSD Manual Pages

  
 
  

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

NAME
       pvm_setrbuf - Switches the active receive buffer	and saves the previous
       buffer.

SYNOPSIS
       C    int	oldbuf = pvm_setrbuf( int bufid	)

       Fortran	 call pvmfsetrbuf( bufid, oldbuf )

PARAMETERS
       bufid   Integer	specifying  the	 message buffer	identifier for the new
	       active receive buffer.

       oldbuf  Integer returning the message buffer identifier for the	previ-
	       ous active receive buffer.

DESCRIPTION
       The routine pvm_setrbuf switches	the active receive buffer to bufid and
       saves  the previous active receive buffer oldbuf.  If bufid is set to 0
       then the	present	active receive buffer is saved and no  active  receive
       buffer exists.

       A successful receive automatically creates a new	active receive buffer.
       If  a  previous receive has not been unpacked and needs to be saved for
       later, then the previous	bufid can be saved and reset later to the  ac-
       tive buffer for unpacking.

       The  routine  is	 required when managing	multiple message buffers.  For
       example switching back and forth	between	two buffers.  One buffer could
       be used to send information to a	graphical  interface  while  a	second
       buffer could be used send data to other tasks in	the application.

EXAMPLES
       C:
	    rbuf1 = pvm_setrbuf( rbuf2 );

       Fortran:
	    CALL PVMFSETRBUF( NEWBUF, OLDBUF )

ERRORS
       These error conditions can be returned by pvm_setrbuf

       PvmBadParam
	      giving an	invalid	bufid.

       PvmNoSuchBuf
	      switching	to a non-existent message buffer.

SEE ALSO
       pvm_setsbuf(3PVM)

				30 August, 1993			 SETRBUF(3PVM)

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

home | help