Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
 
Sun Cluster HA and Data Servicesscds_fm_tcp_write(3HA)


NAME

 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 from by means of a TCP connection to a process 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 actually written.
timeout
Timeout value in seconds


RETURN VALUES

 

The scds_fm_tcp_write() function returns the following:

0
The function succeeded.
non-zero
The function failed.

ERRORS

 
SCHA_ERR_NOERR
Indicates the function succeeded.
SCHA_ERR_TIMEOUT
Indicates the function timed out.
Other values
Indicate 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:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWscdev
Interface StabilityEvolving

SEE ALSO

 

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



Sun Cluster 3.1Go To TopLast Changed 18 Jun 2002