NAME

     atm_bind_pvc,        atm_unbind_pvc,        atm_connect_pvc,
     atm_disconnect_pvc - ATM PVC operations

SYNOPSIS

     #include <fore_atm/fore_atm_user.h>

     atm_bind_pvc(fd, vpvc, aal, qos)
     int fd;
     Vpvc vpvc;
     Aal_type aal;
     Atm_conn_resource *qos;

     atm_unbind_pvc(fd, vpvc)
     int fd;
     Vpvc vpvc;

     atm_connect_pvc(fd, vpvc, aal, qos)
     int fd;
     Vpvc vpvc;
     Aal_type aal;
     Atm_conn_resource *qos;

     atm_disconnect_pvc(fd, vpvc)
     int fd;
     Vpvc vpvc;

DESCRIPTION

     atm_bind_pvc() associates the file descriptor  fd  with  the
     incoming  permanent  virtual circuit (PVC) identified by the
     VPI/VCI pair vpvc.  The resources (bandwidth)  specified  in
     qos   will  be  reserved  for  the  PVC.   Once  a  call  to
     atm_bind_pvc() has been successfully performed, all  traffic
     received  on the device associated with fd with VPI/VCI pair
     vpvc will be reassembled with AAL type aal and  made  avail-
     able  for  receiving  via atm_recv(4N) and atm_recvfrom(4N).
     atm_bind_pvc() may be called multiple times (with  different
     vpvc values) to associate fd with several incoming PVCs.

     atm_unbind_pvc() disassociates the file descriptor  fd  from
     the  incoming  PVC identified by the VPI/VCI pair vpvc.  Any
     traffic received on the PVC will no longer be made available
     for receiving.

     atm_connect_pvc() associates the file descriptor fd with the
     outgoing  PVC  identified  by  the  VPI/VCI  pair vpvc.  The
     resources (bandwidth) specified in qos will be reserved  for
     the PVC.  Once a call to atm_connect_pvc() has been success-
     fully performed, atm_send(4N) and atm_sendto(4N) may be used
     to  transmit traffic from the device associated with fd with
     VPI/VCI pair vpvc using AAL type aal.  atm_connect_pvc() may
     be  called  multiple  times  (with different vpvc values) to
     associate fd with several outgoing PVCs.

     atm_disconnect_pvc() disassociates the  file  descriptor  fd
     from  the  outgoing PVC identified by the VPI/VCI pair vpvc.
     Traffic can no longer be transmitted on the PVC.

     Note  that  it  is  not   necessary   to   explicitly   call
     atm_unbind_pvc()  or  atm_disconnect_pvc() for each attached
     PVC before closing  fd.   atm_close(4N)  will  automatically
     detach fd from all PVCs.

RETURN VALUES

     These functions return  0  on  success.   On  failure,  they
     return   -1   and  set  atm_errno  to  indicate  the  error.
     atm_error(4N) can be used to print a text description of any
     errors returned.

ERRORS

     These functions can also fail with errors returned from  the
     ioctl(2) system call.

SEE ALSO

     atm_close(4N), atm_error(4N),  atm_intro(4N),  atm_recv(4N),
     atm_recvfrom(4N),        atm_send(4N),       atm_sendto(4N),
     atm_error(4N), ioctl(2)