*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> t_sndrel (3)              


 t_sndrel(3)                                                     t_sndrel(3)

 NAME    [Toc]    [Back]
      t_sndrel() - initiate an orderly release

 SYNOPSIS    [Toc]    [Back]
      #include <xti.h>            /* for X/OPEN Transport Interface - XTI */
      /* or */
      #include <tiuser.h>         /* for Transport Layer Interface - TLI  */

      int t_sndrel (fd);
      int fd;

 DESCRIPTION    [Toc]    [Back]
      The t_sndrel() function is used in connection-oriented mode to
      initiate an orderly release at a transport endpoint specified by fd,
      which is a file descriptor previously returned by the t_open()

      After this orderly release is indicated, the transport user should not
      try to send more data through that transport endpoint.  An attempt to
      send more data to a released transport endpoint may block
      continuously.  However, the transport user may continue to receive
      data over the connection until an orderly release indication is
      received.  This function is an optional service of the transport
      provider and is only supported if the transport provider returned
      service type T_COTS_ORD on t_open() or t_getinfo().

    Thread-Safeness    [Toc]    [Back]
      The t_sndrel() function is safe to be called by multithreaded
      applications, and it is thread-safe for both POSIX Threads and DCE
      User Threads.  It has a cancellation point.  It is neither asynccancel
 safe nor async-signal safe.  Finally, it is not fork-safe.

    Note    [Toc]    [Back]
      HP OSI XTI does not support t_sndrel().

 RETURN VALUE    [Toc]    [Back]
      Upon successful completion, a value of 0 is returned.  Otherwise, a
      value of -1 is returned and t_errno is set to indicate the error.

 ERRORS    [Toc]    [Back]
      On failure, t_errno is set to one of the following:

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

      [TFLOW]             Asynchronous mode is indicated because O_NONBLOCK
                          was set, but the transport provider cannot accept
                          a release because of flow-control restrictions.

      [TLOOK]             An asynchronous event has occurred on this
                          transport endpoint and requires immediate

 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003

 t_sndrel(3)                                                     t_sndrel(3)


      [TNOTSUPPORT]       This function is not supported by the underlying
                          transport provider.

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

      [TPROTO]            (XTI only) This error indicates that a
                          communication problem has been detected between
                          XTI and the transport provider for which there is
                          no other suitable XTI (t_errno).

 SEE ALSO    [Toc]    [Back]
      t_getinfo(3), t_open(3), t_rcvrel(3).

      t_sndrel(): SVID2, XPG3, XPG4

 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003
[ Back ]
 Similar pages
Name OS Title
t_sndrel Tru64 Initiate an endpoint connect orderly release
t_sndreldata Tru64 Initiate or respond to an orderly release with user data
t_sysconf Tru64 Initiate or respond to an orderly release with user data
t_rcvrel IRIX acknowledge receipt of an orderly release indication
t_rcvrel Tru64 Acknowledge receipt of an orderly release indication
t_rcvrel HP-UX acknowledge receipt of an orderly release indication at a transport endpoint
t_rcvreldata Tru64 Receive an orderly release indication or confirmation containing user data
DtSearchExit HP-UX Perform orderly shutdown of search engine
pam_start FreeBSD initiate a PAM transaction
physio OpenBSD initiate I/O on raw devices
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service