Language Ccpp Cref Man Gethostname.htm

 <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 &lt;unistd.h&gt;

       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/25 22:19,

^{18.117.158.10:LOG IN}

©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?

Please DO link to this page! Digg it! / MAKE!

<A HREF="http://sxlist.com/techref/language/ccpp/cref/MAN/gethostname.htm"> gethostname</A>

Did you find what you needed?

Welcome to sxlist.com!

Site supported by
sales, advertizing,
& kind contributors
just like you!
Please don't rip/copy
(here's why
Copies of the site on CD
are available at minimal cost.