NAME
sethostname — set name of host cpu
SYNOPSIS
#include <unistd.h>
int sethostname(const char *name, size_t namelen);
DESCRIPTION
The
sethostname()
system call
sets the name of the host processor to
name,
which has a length of
namelen
characters.
At system boot time
sethostname()
is normally executed by the
hostname
command (see
hostname(1))
in the
/sbin/init.d/hostname
script.
Host names are limited to
MAXHOSTNAMELEN
characters, as defined in
<sys/param.h>.
RETURN VALUE
sethostname()
returns the following values:
- 0
Successful completion.
- -1
Failure.
errno
is set to indicate the error.
ERRORS
If
sethostname()
fails,
errno
is set to one of the following values.
- [EFAULT]
name
points to an illegal address.
The reliable detection of this error is implementation dependent.
- [EPERM]
The user does not have appropriate privileges.
AUTHOR
sethostname()
was developed by the University of California, Berkeley.