|
|
HP-UX Reference > Tt_snddis(3)HP-UX 11i Version 2: December 2007 Update |
|
NAMEt_snddis() — send user-initiated disconnect request SYNOPSIS#include <xti.h> /* for X/OPEN Transport Interface - XTI */ /* or */ #include <tiuser.h> /* for Transport Layer Interface - TLI */ int t_snddis (fd, call); int fd; struct t_call *call; DESCRIPTIONThe t_snddis() function is used to initiate an abortive release on an already established connection or to reject a connect request. fd identifies the local transport endpoint of the connection, and call specifies information associated with the abortive release. call points to a t_call structure which contains the following members: struct netbuf addr; struct netbuf opt; struct netbuf udata; int sequence; The type netbuf structure is defined in the <xti.h> or <tiuser.h> header file. This structure, which is used to define buffer parameters, has the following members:
The values in call have different semantics, depending on the context of the call to t_snddis(). When rejecting a connect request, call must be a non-null pointer and contain a valid value of sequence to uniquely identify the rejected connect indication to the transport provider. The sequence parameter is only meaningful, if the transport connection is in the T_INCON state (see t_getstate(3)). The addr and opt fields of call are ignored. In all other cases, call need only be used when data is being sent with the disconnect request. The addr, opt, and sequence fields of the t_call structure are ignored. If the user does not wish to send data to the remote user, the value of call may be a null pointer. udata specifies the user data to be sent to the remote user. The amount of user data must not exceed the limits supported by the transport provider as returned in the discon field of the info argument of t_open() or t_getinfo(). If the len field of udata is zero, no data will be sent to the remote user. RETURN VALUEUpon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and t_errno is set to indicate the error. ERRORSOn failure, t_errno is set to one of the following:
|
|