NAME

     atm_open - open an ATM connection endpoint and get ATM  con-
     nection information

SYNOPSIS

     #include <fore_atm/fore_atm_user.h>

     atm_open(dev, flags, info)
     char *dev;
     int flags;
     Atm_info *info;

DESCRIPTION

     atm_open() attempts to open  the  device  specified  by  dev
     using  the open flags specified.  These arguments are passed
     unmodified to the open(2) system call.  atm_open() returns a
     file descriptor for use in additional ATM library calls.  If
     the info argument is non-zero,  information  about  the  ATM
     link  is  returned  in  the  structure  it  points  to.  The
     Atm_info struct is defined as

          struct Atm_info {
                  int mtu;        /* Maximum Transmission Unit */
          };
          typedef struct Atm_info Atm_info;

     Currently, only  the  MTU  (Maximum  Transmission  Unit)  is
     returned  in  the  info parameter.  This value indicates the
     maximum data size, in bytes, that can be  sent  or  received
     using  the  atm_send(4N)  and  atm_recv(4N) ATM library rou-
     tines.

RETURN VALUES

     atm_open() returns a valid file descriptor 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_open().

ERRORS

     atm_open() can fail with errors returned from  the  open(2),
     ioctl(2),   system   calls.   Additionally,  errors  may  be
     returned from the getmsg(2) and putmsg(2)  system  calls  on
     the SunOS and IRIX platforms.

     On ULTRIX platforms, atm_open() on a closed  connection  may
     cause  a  SIGPIPE  signal to be sent to the calling process.
     Unless caught or ignored, this terminates the process.

SEE ALSO

     atm_intro(4N)