lrt_tpbroadcast

Communication Functions

Broadcasts notification by name.

int lrt_tpbroadcast( char *lmid, char *username, char *cltname, char *data, long len, long flags );

lmid Target client id.
username User name.
cltname Client name.
data Data to send with the broadcast.
length Length of data.
flags Valid flags: TPNOBLOCK - Request not sent if blocking condition exists. TPNOTIME - Caller immune to blocking timeouts. TPSIGRSTRT - Any interrupted system calls are re-issued afterlrt_tpbroadcast.

The lrt_tpbroadcast function allows a client or server to send unsolicited messages to registered clients within the system.

Return Values

If the function ends with an error, it returns -1 and sets the error code in tperrno.

Parameterization

The following argument(s) can be parameterized using standard parameterization: lmid, username, cltname

Example

The following example uses lrt_tpbroadcast to notify user Smith that a fatal error occurred.

Copy code
char* data_0;
data_0 = lrt_tpalloc("STRING", "", 1024);
strcpy(data_0, "Fatal error!");
lrt_tpbroadcast("SITE1", "Smith", "bankapp", data_0, 0, 0);