HP-UX Reference (11i v2 04/09) - 2 System Calls (vol 5)

sethostname(2) sethostname(2)

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

com-

mand (see hostname (1)) in the

/sbin/init.d/hostname

script. Host names are limited to MAX-

HOSTNAMELEN characters, as deﬁned in <sys/param.h>

RETURN VALUE

sethostname()

returns the following values:

0 Successful completion.

-1 Failure.

errno is set to indicate the error.

ERRORS

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 implemen-

tation dependent.

[EPERM] The user does not have appropriate privileges.

AUTHOR

sethostname() was developed by the University of California, Berkeley.