NAME

     atm_gethostbyname - get the ATM address for a hostname

SYNOPSIS

     #include <fore_atm/fore_atm_user.h>

     atm_gethostbyname(hostname, dest_addr)
     char *hostname;
     Atm_address *dest_addr;

DESCRIPTION

     atm_gethostbyname() finds the ATM address  for  hostname  by
     first  using  gethostbyname(3N)  to determine the IP address
     for hostname, and then looking for that address in  the  ATM
     device driver's ARP table.  If no entry is found, an attempt
     is made to contact hostname using IP over ATM, to  force  an
     ARP table entry to be created.

RETURN VALUES

     atm_gethostbyname() returns 0 on success and places the  ATM
     address  in  dest_addr.  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_gethostbyname().

BUGS

     atm_gethostbyname() only works for hosts that are running IP
     over ATM.

SEE ALSO

     atm_intro(4N)