Home | History | Annotate | Download | only in man3ha
 te
 CDDL HEADER START

 The contents of this file are subject to the terms of the
 Common Development and Distribution License (the "License"). 
 You may not use this file except in compliance with the License.

 You can obtain a copy of the license at CDDL.txt
 or http://www.opensolaris.org/os/licensing.
 See the License for the specific language governing permissions
 and limitations under the License.

 When distributing Covered Code, include this CDDL HEADER in each
 file and include the License file at CDDL.txt.
 If applicable, add the following below this CDDL HEADER, with the
 fields enclosed by brackets "[]" replaced with your own identifying
 information: Portions Copyright [yyyy] [name of copyright owner]

 CDDL HEADER END
 Copyright 2008 Sun Microsystems, Inc. All rights
 reserved. Use is subject to license terms.
 scds_fm_net_disconnect 3HA "13 Aug 2008" "Sun Cluster 3.2" "Sun Cluster HA and Data Services"
 NAME
scds_fm_net_disconnect - terminate
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_net_disconnect(scds_handle_t handle, scds_socket_t *socklist,
 int count, time_t timeout);




 DESCRIPTION

The scds_fm_net_disconnect() function terminates
one or more TCP connections to a process that is being monitored.


An attempt is made to close all valid socket connections in the socklist array within the specified timeout interval.
On return, each member of socklist contains the value SCDS_FMSOCK_NA.

 PARAMETERS

The following parameters are supported:


.na
handle
.ad


The
handle that is returned by scds_initialize(3HA).





.na
socklist
.ad


The socket list that is returned by scds_fm_net_connect(3HA). This argument is an input/output argument.





.na
count
.ad


The
number of members in the socklist array. Set this parameter
to SCDS_MAX_IPADDR_TYPES.





.na
timeout
.ad


The timeout value in seconds. Each socket gets the same time period to disconnect
before it is timed out. As these time intervals proceed in parallel, this
value is effectively the maximum time that the function takes to execute.




 RETURN VALUES

The scds_fm_net_disconnect() function returns the
following values:


.na
0
.ad


The function
succeeded.





.na
SCHA_ERR_INVAL
.ad


The function was called with invalid paramaters.





.na
Other nonzero values
.ad


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




 FILES

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


Include file





.na
/usr/cluster/lib/libdsdev.so
.ad


Library




 ATTRIBUTES

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







ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWscdev
Interface StabilityEvolving



 SEE ALSO

scds_fm_net_connect(3HA), scds_fm_tcp_disconnect(3HA), scds_initialize(3HA), scha_calls(3HA), attributes(5)