NAME

     atm_listen - listen for an ATM connection request

SYNOPSIS

     #include <fore_atm/fore_atm_user.h>

     atm_listen(fd, conn_id, calling, qos, aal)
     int fd;
     int *conn_id;
     Atm_endpoint *calling;
     Atm_qos *qos;
     Aal_type *aal;

DESCRIPTION

     atm_listen()  listens  for  a   connect   request   from   a
     remote  ATM  end-point.   fd  identifies  the listening file
     descriptor.

     On return conn_id contains a connection id to be  used  with
     atm_accept(4N).   conn_id  uniquely  identifies  the connect
     indication.  conn_id enables the user to listen for multiple
     connect requests and then respond to them in any order.

     On return calling contains the remote ATM end-point address.

     On return qos (Quality  Of  Service)  specifies  the  remote
     user's  requested  quality  of  service including target and
     minimum acceptable network bandwidth requirements.  The tar-
     get  bandwidth values may have been adjusted downward by the
     network.

     On return aal specifies the ATM Adaptation Layer (AAL) to be
     used  for data exchange.  Three AAL types are supported: AAL
     3/4, AAL 5, and a null AAL.  The AAL 3/4  and  AAL  5  types
     allows the application to send and receive data with the ATM
     device driver handling all segmentation of the data into ATM
     cells  and the reassembly of ATM cells back into application
     data. The null  AAL  allows  applications  to  exchange  ATM
     cells.  Cells  buffered  for  transmission and reception are
     encoded as per Fore Systems'  ATM  Computer  Interface  cell
     format  (see  the  appropriate ATM Computer Interface User's
     Manual for details).

     See atm_server(4N) for usage of atm_listen().

RETURN VALUES

     atm_listen() returns 0 on success.  On failure,  it  returns
     -1  and sets atm_errno to indicate the error.  atm_error(4N)
     can be used to print a text description of  errors  returned
     by atm_listen().

ERRORS

     atm_listen()  can  fail  with  errors  returned   from   the
     getmsg(2)  and  putmsg(2) system calls on the SunOS and IRIX
     platforms.

NOTES

     The  concurrent  server  model  is  not  supported  in  this
     software  release.  However  conn_id  is still returned from
     atm_listen() and required in the call to atm_accept(4N).

SEE ALSO

     atm_intro(4N)