GETHOSTNAME(3) BSD Programmer's Manual GETHOSTNAME(3)NAME
gethostname, sethostname - get/set name of current host
SYNOPSIS
#include <unistd.h>
int
gethostname(char *name, int namelen);
int
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 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.
RETURN VALUES
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
errno.
ERRORS
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-
user.
SEE ALSOgethostid(3), sysctl(3)BUGS
Host names are limited to MAXHOSTNAMELEN (from <sys/param.h>) characters,
currently 256.
HISTORY
The gethostname function call appeared in 4.2BSD.
4.2 Berkeley Distribution June 4, 1993 1
