Xinu7/man/man2/getname.doc




GETNAME(2)          Xinu Programmer's Manual           GETNAME(2)



NAME
     getname - return the official Internet domain name of the
     local host

SYNOPSIS
     int *getname(name)
     char *name;

DESCRIPTION
     _G_e_t_n_a_m_e returns the least-significant component of the offi-
     cial Internet domain name of the local host using GETADDR(2)
     to obtain the host's IP address, and IP2NAME(2) to translate
     the IP address into a domain name.  For example, when exe-
     cuted on host _m_e_r_l_i_n._c_s._p_u_r_d_u_e._e_d_u, _g_e_t_n_a_m_e returns the
     string _m_e_r_l_i_n.

     Argument _n_a_m_e gives the starting address of an area in which
     the name should be placed.  _G_e_t_n_a_m_e writes the name as a
     contiguous, null-terminated byte string.

SEE ALSO
     ip2name(2), getaddr(2)

BUGS
     There is no way to force _g_e_t_n_a_m_e to return the full domain
     name.





























Version 6b               Printed 1/12/87                        1