<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=../cref.html>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/funcref.htm>Functions</a>
</td>
</tr>
</table>
</center>
<p>
<hr>
This manual page was brought to you by <i>mjl_man V-2.0</i>