NAME

     imta_get_hostname - provides the logical local host name.


SYNOPSIS

     #include <imta.h>

     const char *imta_get_hostname()


DESCRIPTION

     The logical name of the local host  is  the  routing  system
     associated  with  the  local  channel  or /var/mail channel,
     internally called  "l."   It  may  be  obtained  by  calling
     imta_get_hostname().

     The buffer containing  the  hostname  is  valid  during  the
     entire life of the program


RETURN VALUES

     imta_get_hostname() returns IMRC_OK when successful,  and  a
     negative error code otherwise.


ATTRIBUTES

               _______________________________________
              |   Attribute Type   |  Attribute Value|
              |____________________|_________________|
              | Architecture       |  sparc, x86     |
              |____________________|_________________|
              | Availability       |  SUNWimsdk      |
              |____________________|_________________|
              | MT-Level           |  MT-Safe        |
              |____________________|_________________|
              | Interface Stability|  Stable         |
              |____________________|_________________|


SEE ALSO

     imta_init(3), /etc/opt/SUNWmail/imta/imta.cnf(3).