HP-UX Reference (11i v1 05/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

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

tion dependent.

[EPERM] The user does not have appropriate privileges.

AUTHOR

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