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. 

SEE ALSO

hostname(1), uname(1), gethostname(2), uname(2). 

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996