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

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


 t_rcvrel(3)                                                     t_rcvrel(3)

 NAME    [Toc]    [Back]
      t_rcvrel() - acknowledge receipt of an orderly release indication at a
      transport endpoint

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

      int t_rcvrel (fd);
      int fd;

 DESCRIPTION    [Toc]    [Back]
      The t_rcvrel() function is used in connection-oriented mode to
      acknowledge receipt of an orderly release indication at a transport
      endpoint. The released endpoint is specified by fd, which is a file
      descriptor previously returned by the t_open() function.

      After receipt of this orderly release indication at the transport
      endpoint specified by fd, the transport user should not try to receive
      additional data from that transport endpoint.  Any attempt to receive
      more data from a released transport endpoint blocks continuously.
      However, the transport user may continue to send data across the
      connection until a release is sent by the transport user by invoking
      the t_sndrel() function call.

      The t_rcvrel() function should not be used unless the servtype typeof-service
 returned by the t_open() or t_getinfo() functions is
      T_COTS_ORD (supports connection-mode service with the optional orderly
      release facility).

    Thread-Safeness    [Toc]    [Back]
      The t_rcvrel() 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.

    Valid States    [Toc]    [Back]

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

 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:

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

 t_rcvrel(3)                                                     t_rcvrel(3)

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

      [TNOREL]            No orderly release indication currently exists on
                          the specified transport endpoint.

      [TBUFOVFLW]         The number of bytes allocated for incoming data is
                          not sufficient to store the data.

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

      [TLOOK]             An asynchronous  event has occurred on the
                          transport endpoint referenced by fd and requires
                          immediate attention.

      [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).

      [TOUTSTATE]         (XTI only) The function was issued in the wrong
                          sequence on the transport endpoint referenced by

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

      t_rcvrel(): SVID2, XPG3, XPG4

 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003
[ Back ]
 Similar pages
Name OS Title
t_rcvrel IRIX acknowledge receipt of an orderly release indication
t_rcvrel Tru64 Acknowledge receipt of an orderly release indication
t_rcvreldata Tru64 Receive an orderly release indication or confirmation containing user data
t_sndrel Tru64 Initiate an endpoint connect orderly release
t_sndrel HP-UX initiate an orderly release
t_sndrel IRIX initiate an orderly release
t_sysconf Tru64 Initiate or respond to an orderly release with user data
t_sndreldata Tru64 Initiate or respond to an orderly release with user data
t_unbind HP-UX disable a transport endpoint
t_open Tru64 Establishes a transport endpoint
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service