Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ t_sndrel(S) — OpenDesktop Software Development System 3.0.0

Media Vault

Software Library

Restoration Projects

Artifacts Sought


 t_sndrel(S)               (TLI/XTI) 6 January 1993               t_sndrel(S)


 Name

    t_sndrel - initiate an orderly release

 Syntax


    TLI syntax


    cc . . .  -lnsls


    #include <sys/tiuser.h>

    int t_sndrel (fd)
    int fd;


    XTI syntax


    cc . . .  -lxti


    #include <xti.h>

    int t_sndrel (fd)
    int fd;


 Description

    This function is used to initiate an orderly release of a transport con-
    nection and indicates to the transport provider that the transport user
    has no more data to send.  fd identifies the local transport endpoint
    where the connection exists.  After issuing tsndrel, the user may not
    send any more data over the connection.  However, a user may continue to
    receive data if an orderly release indication has been received.

    This function is an optional service of the transport provider and is
    only supported if the transport provider returned service type TCOTSORD
    on topen or tgetinfo.

    On failure, terrno may be set to one of the following:

    [TBADF]             The specified file descriptor does not refer to a
                        transport endpoint.

    [TFLOW]             ONONBLOCK was set, but the flow control mechanism
                        prevented the transport provider from accepting the
                        function at this time.

    [TLOOK]             A disconnect event has occurred on this transport
                        endpoint.

    [TOUTSTATE]         (XTI only.)  The state was incorrect when this rou-
                        tine was called.

    [TNOTSUPPORT]       This error is generated if the TCOTSORD service
                        type is not returned by a previous call to the
                        topen(S) or tgetinfo(S) routine.

    [TSYSERR]           A system error has occurred during execution of this
                        function.

 Diagnostics

    The tsndrel function returns 0 on success and -1 on failure, and terrno
    is set to indicate the error.

 See also

    topen(S), trcvrel(S)

 Standards conformance

    tsndrel is conformant with:
    AT&T SVID Issue 2;
    X/Open Portability Guide, Issue 3, 1989;
    and Intel386 Binary Compatibility Specification, Edition 2 (iBCSe2).


Typewritten Software • bear@typewritten.org • Edmonds, WA 98026