ddu_brc_fev

Usage: int ddu_brc_fev(struct fifo_entry *fev, int wait)
Returns: 0 if good status, -1 if bad status.
Arguments: fifo_entry fev to be broadcasted, int wait
This routine allows to broadcast a fifo_entry to all processes attached to a fifo of the DD system depending on the value of their broadcast flag (as set by ddu_set_brc):

 
 brc_flag  		  DD_BRC_OFF  		 no broadcast to this process

		  DD_BRC_USMAIL  		 n copies of  fev are written into the fifos

		 		 where n is the number of processes attached to the fifo.

		 		 Note: If n greater 1, then it is not garanteed the every

		 		 process will get one  copy of  fev (one process might be

		 		 fast enough to grab two copies!).

		  DD_BRC_SIGNAL  		 every process is garanteed to get one copy

		 		 of  fev, which are distributed using signals and a

		 		  special broadcast fifo.

		  DD_BRC_OFF  		 process will not be considered in the broadcasts

		 		 process.

where command is a 16 bit integer. DD_BRCCMD_MARKER is defined in dbfi.h.
In this case the broadcast is only sent to those processes that ask for broadcast and have their broadcast command for int cmd defined, i.e. they previously set the broadcast command to a function by calling ddu_set_brccmd. Upon receiving that broadcast command, they call the routine brc_cmd_fcn. ctlw1 and ctlb1 are the calling arguments for brc_cmd_fcn and can be used to pass additional data to the process.