GETHOSTNAME
Section: Linux Programmer's Manual (2)
Updated: 2004-06-17
Index
Return to Main Contents
NAME
gethostname, sethostname - get/set host name
SYNOPSIS
#include <unistd.h>
int gethostname(char *name, size_t len);
int sethostname(const char *name, size_t len);
DESCRIPTION
These functions are used to access or to change the host name of the
current processor.
The
gethostname()
function returns a NUL-terminated hostname (set earlier by
sethostname())
in the array name that has a length of len bytes.
In case the NUL-terminated hostname does not fit, no error is
returned, but the hostname is truncated. It is unspecified
whether the truncated hostname will be NUL-terminated.
RETURN VALUE
On success, zero is returned. On error, -1 is returned, and
errno
is set appropriately.
ERRORS
- EFAULT
-
name
is an invalid address.
- 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.
(In this last case glibc 2.1 uses ENAMETOOLONG.)
- EPERM
-
For
sethostname,
the caller did not have the
CAP_SYS_ADMIN
capability.
CONFORMING TO
SVr4, 4.4BSD (this function first appeared in 4.2BSD).
POSIX 1003.1-2001 specifies
gethostname
but not
sethostname.
BUGS
For many Linux kernel / libc combinations
gethostname
will return an error instead of returning a truncated hostname.
NOTES
SUSv2 guarantees that `Host names are limited to 255 bytes'.
POSIX 1003.1-2001 guarantees that `Host names (not including
the terminating NUL) are limited to HOST_NAME_MAX bytes'.
SEE ALSO
getdomainname(2),
setdomainname(2),
uname(2)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUE
-
- ERRORS
-
- CONFORMING TO
-
- BUGS
-
- NOTES
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 00:11:36 GMT, May 13, 2005
www.fiveanddime.net
