summaryrefslogtreecommitdiff
path: root/reference/C/MAN/gethostname.htm
diff options
context:
space:
mode:
authorTobias Klauser <tklauser@distanz.ch>2008-01-27 11:37:44 +0100
committerTobias Klauser <tklauser@xenon.tklauser.home>2008-01-27 11:37:44 +0100
commit7e0f021a9aec35fd8e6725e87e3313b101d26f5e (patch)
treeb1cacc4b24393f517aeb4610e9e1021f954307a8 /reference/C/MAN/gethostname.htm
Initial import (2.0.2-6)2.0.2-6
Diffstat (limited to 'reference/C/MAN/gethostname.htm')
-rw-r--r--reference/C/MAN/gethostname.htm99
1 files changed, 99 insertions, 0 deletions
diff --git a/reference/C/MAN/gethostname.htm b/reference/C/MAN/gethostname.htm
new file mode 100644
index 0000000..4b5256c
--- /dev/null
+++ b/reference/C/MAN/gethostname.htm
@@ -0,0 +1,99 @@
+<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=../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>