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

  man pages->Tru64 Unix man pages -> t_listen (3)              



NAME    [Toc]    [Back]

       t_listen - Listen for a connect request

SYNOPSIS    [Toc]    [Back]

       #include <xti.h>

       int t_listen(
               int fd,
               struct t_call *call );

LIBRARY    [Toc]    [Back]

       XTI Library (libxti.a)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       t_listen():  XNS4.0, XNS5.0

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       The  following table summarizes the relevance of input and
       output parameters before and after t_listen() is called:

       Parameters           Before Call   After Call
       fd                   y             n
       call->addr.maxlen    y             n
       call->addr.len       n             y
       call->addr.buf       o             (o)
       call->opt.maxlen     y             n
       call->opt.len        n             y
       call->opt.buf        o             (o)
       call->udata.maxlen   y             n
       call->udata.len      n             y
       call->udata.buf      o             (o)
       call->sequence       n             y

       Notes to Table This is a meaningful  parameter.   This  is
       not  a  meaningful  parameter.   The content of the object
       pointed to by y is meaningful.  The content of the  object
       pointed  to by o is optional.  Specifies a file descriptor
       returned by the  t_open()  function  that  identifies  the
       local  transport  endpoint  where  connect  indication may
       arrive.  Points to a type t_call structure used to specify
       information  that  describes  the  connect indication. The
       t_call structure has the following four members: Specifies
       a  buffer  for  protocol  address  information sent by the
       calling transport user. The type netbuf  structure  referenced
 by this member is defined in the xti.h include file.
       This structure, which is used to define buffer parameters,
       has  the  following  members:  Specifies  the maximum byte
       length of the data  buffer.   Specifies  the  actual  byte
       length  of  data  written  to  the  buffer.  Points to the
       buffer location.  Specifies a buffer for protocol-specific
       parameters associated with the connect request.  Specifies
       a buffer for user data sent by the  caller.   Specifies  a
       unique identification number used to identify the returned
       connect indication.

       The sequence parameter pointed to by the call parameter is
       used  to uniquely identify the returned connection indication.
 Values greater than 1 for this parameter enable  the
       transport  user  to  listen for more than a single connect
       indication before responding to any of those returned.

       Because this function returns values for  the  addr,  opt,
       and  udata  fields  of call, each maxlen parameter must be
       set before calling this function, to indicate the  maximum
       size  of  the  buffer  associated  with values sent by the

DESCRIPTION    [Toc]    [Back]

       The t_listen() function is an XTI connection-oriented service
  function  that  listens for a connect request from a
       calling transport user. The transport endpoint  where  the
       connect indications arrive is specified by a file descriptor
 previously  returned  by  the  t_open()  function.  By
       default,  the  t_listen()  function  executes  in the synchronous
 operating  mode.  In  the  synchronous  operating
       mode,  t_listen() waits for a connect indication to arrive
       before returning control to the transport user who  called
       this function.

       When  the  transport  endpoint  specified  by  the fd file
       descriptor has been opened with the O_NONBLOCK option  set
       when  the  t_open()  or  fcntl()  function  is called, the
       t_listen() function executes in asynchronous mode.

       When the  t_listen()  function  executes  in  asynchronous
       mode,  it  polls for existing connect indications. If none
       are available, it returns -1 and  sets  t_errno  to  [TNODATA].

       The t_listen() function returns a pointer to a type t_call
       structure, which defines information associated  with  the
       arriving connect request. The t_call structure also references
 a type netbuf structure. Both structures are defined
       in the xti.h include file.

ERRORS    [Toc]    [Back]

       If  the  t_listen()  function fails, t_errno may be set to
       one of the following values: The specified file descriptor
       does not refer to a transport endpoint.  The qlen argument
       of the endpoint referenced by the fd  parameter  is  zero.
       The  number  of  bytes  allocated for an incoming argument
       (maxlen) is greater than 0 but not sufficient to store the
       value  of  that argument. The provider's state, as seen by
       the user, changes to T_INCON, and the  connect  indication
       information  to  be  returned  in  call is discarded.  The
       value of sequence returned can be used to do a t_snddis().
       An  asynchronous event has occurred on this transport endpoint
 and requires immediate  attention.   The  O_NONBLOCK
       option  was  set,  but  no  connect  indications  had been
       queued.  This function is not supported by the  underlying
       transport  provider.  The function was issued in the wrong
       sequence on the transport endpoint referenced  by  the  fd
       parameter.   A  system error has occurred during execution
       of this function.  The maximum number of outstanding indications
  has  been  reached for the endpoint referenced by
       fd.  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).

VALID STATES    [Toc]    [Back]

       The t_listen function can only be called in the T_IDLE and
       T_INCON transport provider states.

RETURN VALUE    [Toc]    [Back]

       Upon  successful  completion,  a  value  of  0  (zero)  is
       returned. Otherwise, a value of -1 is returned and t_errno
       is set to indicate the error.

SEE ALSO    [Toc]    [Back]

       Functions:  fcntl(2),  t_accept(3), t_alloc(3), t_bind(3),
       t_connect(3),  t_open(3),  t_optmgmt(3),  t_rcvconnect(3),

       Standards: standards(5)

       Network Programmer's Guide

[ Back ]
 Similar pages
Name OS Title
t_accept Tru64 Accept a connect request
t_accept HP-UX accept a connect request
t_accept IRIX accept a connect request
t_rcvconnect Tru64 Receive the confirmation from a connect request
t_rcvconnect IRIX receive the confirmation from a connect request
t_rcvconnect HP-UX receive the confirmation from a connect request
listen NetBSD listen for connections on a socket
listen OpenBSD listen for connections on a socket
listen HP-UX listen for connections on a socket
listen Linux listen for connections on a socket
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service