GETHOSTNAME(3) BSD Programmer's Manual GETHOSTNAME(3)
gethostname, sethostname - get/set name of current host
gethostname(char *name, int namelen);
sethostname(const char *name, int namelen);
Gethostname() returns the standard host name for the current processor,
as previously set by sethostname(). The parameter namelen specifies the
size of the name array. The returned name is null-terminated unless in-
sufficient space is provided.
Sethostname() sets the name of the host machine to be name, which has
length namelen. This call is restricted to the super-user and is normally
used only when the system is bootstrapped.
If the call succeeds a value of 0 is returned. If the call fails, a val-
ue of -1 is returned and an error code is placed in the global location
The following errors may be returned by these calls:
[EFAULT] The name or namelen parameter gave an invalid address.
[EPERM] The caller tried to set the hostname and was not the super-
Host names are limited to MAXHOSTNAMELEN (from <sys/param.h>) characters,
The gethostname function call appeared in 4.2BSD.
4.2 Berkeley Distribution June 4, 1993 1