scds_fm_tcp_write

- write data using a TCP connection to an application

Synopsis

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);

Description

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.

Parameters

The following parameters are supported:

handle

The handle returned from scds_initialize(3HA).

sock

The socket number returned by a previous call to scds_fm_tcp_connect(3HA).

buffer

Data buffer.

size

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

Timeout value in seconds.

Return Values

The scds_fm_tcp_write() function returns the following:

0

The function succeeded.

nonzero

The function failed.

Errors

SCHA_ERR_NOERR

Indicates that the function succeeded.

SCHA_ERR_TIMEOUT

Indicates that the function timed out.

Other values

Indicate that the function failed. See scha_calls(3HA) for the meaning of failure codes.

Files

/usr/cluster/include/rgm/libdsdev.h

Include file

/usr/cluster/lib/libdsdev.so

Library

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

scds_fm_tcp_connect(3HA), scds_fm_tcp_read(3HA), scds_initialize(3HA), scha_calls(3HA), attributes(5)