cc [flags…] –I /usr/cluster/include file –L /usr/cluster/lib –l dsdev#include <rgm/libdsdev.h> scha_err_t scds_fm_tcp_write(scds_handle_t handle, int sock, char *buffer, size_t *size, time_t timeout);
The scds_fm_tcp_write() function writes data by means of a TCP connection to a process that is being monitored.
The size argument is an input and output argument. On input, you specify the number of bytes to be written. On output, the function returns the number of bytes actually written. If the input and output values of size are not equal, an error has occurred. The function returns SCHA_ERR_TIMEOUT if it times out before writing all the requested data.
The following parameters are supported:
The handle returned from scds_initialize(3HA).
The socket number returned by a previous call to scds_fm_tcp_connect(3HA).
Data buffer size. On input, you specify the number of bytes to be written. On output, the function returns the number of bytes that were actually written.
Timeout value in seconds.
The scds_fm_tcp_write() function returns the following:
The function succeeded.
The function failed.
Indicates that the function succeeded.
Indicates that the function timed out.
Indicate that the function failed. See scha_calls(3HA) for the meaning of failure codes.
See attributes (5) for descriptions of the following attributes: