diff options
Diffstat (limited to 'reference/C/MAN/gethostname.htm')
| -rw-r--r-- | reference/C/MAN/gethostname.htm | 99 |
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 <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> |