t_rcvdis(3N)
NAME
t_rcvdis − retrieve information from disconnect
SYNOPSIS
cc [ flag ... ] file ... −lnsl [ library ... ]
#include <tiuser.h>
int t_rcvdis(int fildes, struct t_discon ∗discon);
MT-LEVEL
MT-Safe
DESCRIPTION
This function is used to identify the cause of a disconnect, and to retrieve any user data sent with the disconnect. fildes identifies the local transport endpoint where the connection existed, and discon points to a t_discon structure containing the following members:
| struct netbuf | udata; |
| int | reason; |
| int | sequence; |
/∗
struct netbuf {
| unsigned int | maxlen; |
| unsigned int | len; |
| char | ∗buf; |
};
∗/
reason specifies the reason for the disconnect through a protocol-dependent reason code, udata identifies any user data that was sent with the disconnect, and sequence may identify an outstanding connect indication with which the disconnect is associated. sequence is only meaningful when t_rcvdis() is issued by a passive transport user who has executed one or more t_listen(3N) functions and is processing the resulting connect indications. If a disconnect indication occurs, sequence can be used to identify which of the outstanding connect indications is associated with the disconnect.
If a user does not care if there is incoming data and does not need to know the value of reason or sequence, discon may be NULL and any user data associated with the disconnect will be discarded. However, if a user has retrieved more than one outstanding connect indication (using t_listen(3N) ) and discon is NULL, the user will be unable to identify which connect indication the disconnect is associated with.
RETURN VALUES
t_rcvdis returns 0 on success. On failure t_rcvdis returns −1, t_errno is set to indicate the error, and possibly errno is set.
ERRORS
On failure, t_errno will be set to one of the following:
TBADF The specified file descriptor does not refer to a transport endpoint.
TBUFOVFLW The number of bytes allocated for incoming data is not sufficient to store the data. The provider’s state, as seen by the user, will change to T_IDLE, and the disconnect indication information to be returned in discon will be discarded.
TNODIS No disconnect indication currently exists on the specified transport endpoint.
TNOTSUPPORT This function is not supported by the underlying transport provider.
TSYSERR A system error has occurred during execution of this function, errno will be set to the specific error.
SEE ALSO
t_connect(3N), t_listen(3N), t_open(3N), t_snddis(3N)
SunOS 5.3 Network Interfaces Programmer’s Guide
NOTES
This interface is safe in multithreaded applications.
Sun Microsystems — Last change: 22 Jan 1993