t_snddis Subroutine for Transport Layer Interface

Communications Technical Reference, Volume 2

t_snddis Subroutine for Transport Layer Interface

Purpose

Sends a user-initiated disconnect request.

Library

Transport Layer Interface Library (libtli.a)

Syntax

#include <tiuser.h>

int t_snddis(fd, call)
int fd;
struct t_call *call;

Description

The t_snddis subroutine is used to initiate an abortive release on an already established connection or to reject a connect request.

Parameters

Identifies the local transport end point of the connection.

call

Specifies information associated with the abortive release.

The call parameter points to a t_call structure containing the following fields:

struct netbuf addr;
struct netbuf opt;
struct netbuf udata;
int sequence;

The values in the call parameter have different semantics, depending on the context of the call to the t_snddis subroutine. When rejecting a connect request, the call parameter must not be null and must contain a valid value in the sequence field to uniquely identify the rejected connect indication to the transport provider. The addr and opt fields of the call parameter are ignored. In all other cases, the call parameter 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 the call parameter can be null.

The udata field 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 by the t_open or t_getinfo subroutine. If the len field of the udata field is 0, no data will be sent to the remote user.

Return Values

On successful completion, the t_snddis subroutine returns a value of 0. Otherwise, it returns a value of -1 and sets the t_errno variable to indicate the error.

Error Codes

If unsuccessful, the t_errno variable is set to one of the following:

TBADF	The specified file descriptor does not refer to a transport end point.
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 transport provider's outgoing queue will be flushed, so data may be lost.
TBADSEQ	An incorrect 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 subroutine is not supported by the underlying transport provider.
TSYSERR	A system error has occurred during execution of this subroutine.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The t_connect subroutine, t_getinfo subroutine, t_listen subroutine, t_look subroutine, t_open subroutine.

List of Streams Programming References and STREAMS Overview in AIX Version 4.3 Communications Programming Concepts.