Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Reference Manual Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

### 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:

ATTRIBUTE TYPE | ATTRIBUTE VALUE
--- | ---
Availability | ha-cluster/developer/api
Interface Stability | Evolving

## See Also

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

Copyright © 2000, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices |