<TITLE>gethostname</TITLE> <body bgcolor="#ffffcc"> <hr> <pre> <h3>GETHOSTNAME(2) Linux Programmer's Manual GETHOSTNAME(2) </h3> <h3>NAME </h3> gethostname, sethostname - get/set host name <h3>SYNOPSIS </h3> #include <unistd.h> int gethostname(char *name, size_t len); int sethostname(const char *name, size_t len); <h3>DESCRIPTION </h3> These functions are used to access or to change the host name of the current processor. <h3>RETURN VALUE </h3> On success, zero is returned. On error, -1 is returned, and errno is set appropriately. <h3>ERRORS </h3> EINVAL len is negative or, for sethostname, len is larger than the maximum allowed size, or, for gethostname on Linux/i386, len is smaller than the actual size. EPERM For sethostname, the caller was not the superuser. EFAULT name is an invalid address. <h3>CONFORMING TO </h3> POSIX.1 does not define these functions, but ISO/IEC 9945-1:1990 mentions them in B.4.4.1. <h3>BUGS </h3> Some other implementations of gethostname successfully return len bytes even if name is longer. Linux/Alpha com- plies with this behaviour. Linux/i386, however, returns EINVAL in this case (as of DLL 4.6.27 libraries). <h3>NOTES </h3> Under Linux/Alpha, gethostname is a system call. Under Linux/i386, gethostname is implemented at the library level by calling uname(2). </pre> <hr> <h3>SEE ALSO </h3><p> <a href=getdomainname.htm>getdomainname</a>, <a href=setdomainname.htm>setdomainname</a>, <a href=uname.htm>uname</a>, <pre> <h3>Linux 1.3.6 22 July 1995 1 </h3> </pre> <P> <hr> <p> <center> <table border=2 width=80%> <tr align=center> <td width=25%> <a href=../index.htm>Top</a> </td><td width=25%> <a href=../master_index.html>Master Index</a> </td><td width=25%> <a href=../SYNTAX/keywords.html>Keywords</a> </td><td width=25%> <a href=../FUNCTIONS/index.htm>Functions</a> </td> </tr> </table> </center> <p> <hr> This manual page was brought to you by <i>mjl_man V-2.0</i>
.