GETHOSTNAME(3) BSD Library Functions Manual GETHOSTNAME(3)NAME
gethostname, sethostname — get/set name of current host
gethostname(char *name, int namelen);
sethostname(const char *name, int namelen);
DESCRIPTIONGethostname() 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
insufficient 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 nor‐
mally used only when the system is bootstrapped.
If the call succeeds a value of 0 is returned. If the call fails, a
value of -1 is returned and an error code is placed in the global loca‐
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
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 4.2 Berkeley Distribution