<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>
| file: /Techref/language/ccpp/cref/MAN/gethostname.htm, 2KB, , updated: 2003/3/20 09:39, local time: 2024/11/20 04:27,
|
| | ©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions?
<A HREF="http://linistepper.com/techref/language/ccpp/cref/MAN/gethostname.htm"> gethostname</A> |
| Did you find what you needed?
|