Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ t_close(S) — OpenDesktop Software Development System 3.0.0

Media Vault

Software Library

Restoration Projects

Artifacts Sought


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


 Name

    t_close - close a transport endpoint

 Syntax


    TLI syntax


    cc . . . -lnsls


    #include <sys/tiuser.h>

    int t_close (fd)
    int fd;


    XTI syntax


    cc . . . -lxti


    #include <xti.h>

    int t_close (fd)
    int fd;


 Description

    The tclose function informs the transport provider that the user is fin-
    ished with the transport endpoint specified by fd, and frees any local
    library resources associated with the endpoint.  In addition, tclose
    closes the file associated with the transport endpoint.

    The tclose function should be called from the TUNBND state (see
    tgetstate(S)).  However, this function does not check state information,
    so it may be called from any state to close a transport endpoint.  If
    this occurs, the local library resources associated with the endpoint
    will be freed automatically.  In addition, close(S) will be issued for
    that file descriptor; the close will be abortive if no other process has
    that file open, and will break any transport connection that may be asso-
    ciated with that endpoint.

    On failure, terrno may be set to the following:

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

 See also

    tgetstate(S), topen(S), tunbind(S),

 Diagnostics

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

 Standards conformance

    tclose 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