sethostname(2)
_________________________________________________________________
sethostname System Call
Set name of current host.
_________________________________________________________________
SYNTAX
int sethostname (name, namelen)
char * name;
int namelen;
PARAMETERS
name Name to set for host.
namelen Length of name in bytes.
DESCRIPTION
Sethostname sets the name of the host node to <name>, which has
length <namelen>. Only the superuser may use this call; it is
normally used at boot time.
Hostnames are limited to MAXHOSTNAMELEN characters, which is
defined in <sys/param.h>.
ACCESS CONTROL
Only the superuser can set the hostname.
RETURN VALUE
0 Completed successfully.
-1 An error occurred. Errno is set to indicate the
error.
EXCEPTIONS
Errno may be set to one of the following error codes:
EFAULT The <name> parameter gave an invalid address, or
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
sethostname(2)
the <namelen> parameter specified a length less
than zero.
EPERM The caller was not the superuser.
SEE ALSO
The related manual sections: gethostname(2), gethostid(2),
getdomainname(2).
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)