t_snddis(3N) t_snddis(3N)
NAME
tsnddis - send user-initiated disconnect request
SYNOPSIS
#include <sys/tiuser.h>
int tsnddis(int fd, struct tcall *call);
DESCRIPTION
This 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
tcall structure that contains the following members:
struct netbuf addr;
struct netbuf opt;
struct netbuf udata;
int sequence;
The values in call have different semantics, depending on the context
of the call to tsnddis. When rejecting a connect request, call must
be non-NULL and contain a valid value of sequence to identify uniquely
the rejected connect indication to the transport provider. 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 tcall structure are ignored. If the
user does not wish to send data to the remote user, the value of call
may be NULL.
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 trans-
port provider as returned in the discon field of the info argument of
topen or tgetinfo. If the len field of udata is zero, no data will
be sent to the remote user.
ERRORS
On failure, terrno may be set to one of the following:
TBADF The specified file descriptor does not refer to a
transport endpoint.
TOUTSTATE The function was issued in the wrong sequence. The
transport provider's outgoing queue may be flushed, so
data may be lost.
TBADDATA The amount of user data specified was not within the
bounds allowed by the transport provider. The trans-
port provider's outgoing queue will be flushed, so
data may be lost.
Page 1 Reliant UNIX 5.44 Printed 11/98
t_snddis(3N) t_snddis(3N)
TBADSEQ An invalid sequence number was specified, or a NULL
call structure was specified when rejecting a connect
request. The transport provider's outgoing queue will
be flushed, so data may be lost.
TLOOK An asynchronous event has occurred on this transport
endpoint and requires immediate attention.
TNOTSUPPORT This function is not supported by the underlying
transport provider.
TSYSERR A system error has occurred during execution of this
function.
DIAGNOSTICS
tsnddis returns 0 on success and -1 on failure and terrno is set to
indicate the error.
SEE ALSO
tconnect(3N), tgetinfo(3N), tlisten(3N), topen(3N).
Page 2 Reliant UNIX 5.44 Printed 11/98