GETHOSTNAME(3) Library Routines GETHOSTNAME(3)
gethostname, sethostname - get/set name of current host
int gethostname (char *name, int namelen);
int 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
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) charac-
ters, currently 256.
The sethostname function call appeared in 4.2BSD.
GNO 25 February 1997 GETHOSTNAME(3)
Man(1) output converted with